Merge remote-tracking branch 'origin/main' into fancy-dodos-remain

# Conflicts:
#	plugins/terminals/src/client/App.svelte
#	plugins/terminals/src/client/design.ts

Author: antfubot

alias.ts

@@ -79,6 +79,12 @@ export const alias = {
   '@devframes/plugin-inspect/cli': p('inspect/src/cli.ts'),
   '@devframes/plugin-inspect/vite': p('inspect/src/vite.ts'),
   '@devframes/plugin-inspect': p('inspect/src/index.ts'),
+  '@devframes/plugin-og/client': p('og/src/client/index.ts'),
+  '@devframes/plugin-og/node': p('og/src/node/index.ts'),
+  '@devframes/plugin-og/rpc': p('og/src/rpc/index.ts'),
+  '@devframes/plugin-og/cli': p('og/src/cli.ts'),
+  '@devframes/plugin-og/vite': p('og/src/vite.ts'),
+  '@devframes/plugin-og': p('og/src/index.ts'),
   '@devframes/plugin-a11y/client': p('a11y/src/client/index.ts'),
   '@devframes/plugin-a11y/node': p('a11y/src/node/index.ts'),
   '@devframes/plugin-a11y/cli': p('a11y/src/cli.ts'),

design/design.ts

@@ -0,0 +1,242 @@
+// @unocss-include
+// Shared devframe -> @antfu/design class helpers: framework-neutral builders
+// returning @antfu/design's semantic shortcut classes, so every surface (Solid,
+// Svelte, React, Preact, vanilla) looks identical to the antfu Vue components.
+// The `@unocss-include` marker makes UnoCSS emit the runtime-assembled class
+// chains below; `design/uno.config.ts` adds this file to every app's content so
+// the chains are extracted regardless of framework.
+// Tag palette kept literal for extraction: badge-color-blue badge-color-amber
+// badge-color-green badge-color-red badge-color-sky badge-color-violet
+// badge-color-rose badge-color-teal badge-color-orange badge-color-emerald
+
+export function cx(...parts: Array<string | false | null | undefined>): string {
+  return parts.filter(Boolean).join(' ')
+}
+
+export type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'destructive' | 'link'
+export type ButtonSize = 'md' | 'sm' | 'lg'
+export interface ButtonProps { variant?: ButtonVariant, size?: ButtonSize, class?: string }
+
+export function button({ variant = 'primary', size = 'md', class: extra }: ButtonProps = {}): string {
+  const variantClass: Record<ButtonVariant, string> = {
+    primary: 'btn-primary',
+    secondary: 'btn-action',
+    outline: 'btn-action',
+    ghost: 'inline-flex items-center justify-center gap-1.5 rounded px2 py1 op75 hover:op100 hover:bg-active transition disabled:pointer-events-none disabled:op30!',
+    destructive: 'btn-action text-error border-error/30!',
+    link: 'inline-flex items-center gap-1.5 color-active hover:underline underline-offset-2',
+  }
+  const sizeClass = size === 'sm'
+    ? (variant === 'primary' ? 'text-sm px-2.5! py-1!' : 'text-sm')
+    : size === 'lg' ? 'text-base px-4! py-2!' : ''
+  return cx(variantClass[variant], sizeClass, extra)
+}
+
+export type IconButtonVariant = 'outline' | 'ghost'
+export type IconButtonSize = 'md' | 'sm'
+export interface IconButtonProps { variant?: IconButtonVariant, size?: IconButtonSize, class?: string }
+
+export function iconButton({ variant = 'outline', size = 'md', class: extra }: IconButtonProps = {}): string {
+  const base = variant === 'ghost' ? 'btn-icon' : 'btn-icon-square'
+  const sizeClass = size === 'sm' ? 'w-7! h-7! text-sm' : ''
+  return cx(base, sizeClass, extra)
+}
+
+export type BadgeVariant = 'primary' | 'secondary' | 'success' | 'warning' | 'destructive' | 'outline'
+export interface BadgeProps { variant?: BadgeVariant, class?: string }
+
+export function badge({ variant = 'secondary', class: extra }: BadgeProps = {}): string {
+  const variantClass: Record<BadgeVariant, string> = {
+    primary: 'badge-active',
+    secondary: 'badge-muted',
+    success: 'badge badge-color-green',
+    warning: 'badge badge-color-amber',
+    destructive: 'badge badge-color-red',
+    outline: 'badge border border-base',
+  }
+  return cx(variantClass[variant], extra)
+}
+
+export function tag(color: string, extra?: string): string {
+  return cx('badge', `badge-color-${color}`, extra)
+}
+
+export function tabsList(extra?: string): string {
+  return cx('inline-flex items-center gap-1 p-1 rounded-lg bg-secondary w-max', extra)
+}
+
+export function tab(extra?: string): string {
+  return cx(
+    'px-3 py-1 rounded-md text-sm color-muted inline-flex gap-1.5 items-center whitespace-nowrap select-none cursor-pointer transition outline-none hover:color-base focus-visible:ring-2 focus-visible:ring-primary-500/40 data-[state=active]:bg-base data-[state=active]:color-base data-[state=active]:shadow-sm',
+    extra,
+  )
+}
+
+export interface NavTabProps { active?: boolean, class?: string }
+export function navTab({ active = false, class: extra }: NavTabProps = {}): string {
+  return cx(
+    'relative inline-flex items-center gap-1.5 max-w-52 px-2 py-1 rounded-md border border-transparent text-sm op-fade select-none cursor-pointer transition hover:op100 hover:bg-active',
+    active && 'op100! bg-active border-base! color-base',
+    extra,
+  )
+}
+
+export function nav(extra?: string): string {
+  return cx('flex items-center gap-2 shrink-0 h-nav px-3 border-b border-base bg-base z-nav', extra)
+}
+
+export function navBrand(extra?: string): string {
+  return cx('flex items-center gap-1.5 shrink-0 font-semibold text-sm select-none', extra)
+}
+
+// Mirrors devframe's `DevframeConnectionStatus` (kept local so this class-helper
+// module stays free of package imports); the two share the same string members.
+export type ConnectionStatus = 'connecting' | 'connected' | 'unauthorized' | 'disconnected' | 'error'
+
+export interface ConnectionIndicator {
+  /** Short status label, e.g. `disconnected`. */
+  label: string
+  /** Class chain for the status dot. */
+  dot: string
+  /** Class chain for the pill wrapper. */
+  class: string
+}
+
+const CONNECTION_TONE: Record<Exclude<ConnectionStatus, 'connected'>, { label: string, dot: string }> = {
+  connecting: { label: 'connecting…', dot: 'bg-neutral-400 animate-pulse' },
+  disconnected: { label: 'disconnected', dot: 'bg-error' },
+  unauthorized: { label: 'unauthorized', dot: 'bg-warning' },
+  error: { label: 'error', dot: 'bg-error' },
+}
+
+// The shared top-nav connection indicator: a small status dot + label. Returns
+// `null` when the client is `connected`, so every surface renders the indicator
+// only while the connection is not live.
+export function connectionIndicator(status: ConnectionStatus, extra?: string): ConnectionIndicator | null {
+  if (status === 'connected')
+    return null
+  const tone = CONNECTION_TONE[status]
+  return {
+    label: tone.label,
+    dot: cx('inline-block size-1.5 rounded-full shrink-0', tone.dot),
+    class: cx('flex items-center gap-1.5 shrink-0 text-xs color-muted select-none', extra),
+  }
+}
+
+export interface ConnectionStateCopy {
+  /** Phosphor icon for the state glyph. */
+  icon: string
+  /** Short heading, e.g. `Disconnected`. */
+  title: string
+  /** One-line explanation of the state and how to recover. */
+  body: string
+  /** Whether to offer the reload recovery button (every state but `connecting`). */
+  reloadable: boolean
+  /** Whether the glyph should animate while the handshake is in flight. */
+  spin: boolean
+}
+
+const CONNECTION_STATE: Record<Exclude<ConnectionStatus, 'connected'>, ConnectionStateCopy> = {
+  connecting: {
+    icon: 'i-ph-plugs-connected-duotone',
+    title: 'Connecting…',
+    body: 'Establishing a connection to the devframe server.',
+    reloadable: false,
+    spin: true,
+  },
+  disconnected: {
+    icon: 'i-ph-plugs-duotone',
+    title: 'Disconnected',
+    body: 'Lost the connection to the devframe server. Reload once it is back up.',
+    reloadable: true,
+    spin: false,
+  },
+  unauthorized: {
+    icon: 'i-ph-lock-key-duotone',
+    title: 'Not authorized',
+    body: 'This client isn’t authorized. Reopen the link printed by your dev server, then reload.',
+    reloadable: true,
+    spin: false,
+  },
+  error: {
+    icon: 'i-ph-warning-octagon-duotone',
+    title: 'Connection failed',
+    body: 'Could not reach the devframe server.',
+    reloadable: true,
+    spin: false,
+  },
+}
+
+// The shared full-panel connection state copy: shown whenever the client isn't
+// `connected`, so a surface never sits on an infinite spinner without saying
+// why. Returns `null` when connected. Pair with the `connection*` class builders
+// below so every surface renders the identical centered glyph + title + body.
+export function connectionState(status: ConnectionStatus): ConnectionStateCopy | null {
+  if (status === 'connected')
+    return null
+  return CONNECTION_STATE[status]
+}
+
+// Centered fill for the full-panel state; each surface adds its own fill
+// strategy (`h-full`, `h-svh w-full`, `absolute inset-0`, …) via `extra`.
+export function connectionPanel(extra?: string): string {
+  return cx('flex flex-col items-center justify-center gap-4 bg-base p-8 text-center', extra)
+}
+
+export function connectionGlyph(spin = false, extra?: string): string {
+  return cx('text-4xl color-active', spin && 'animate-pulse', extra)
+}
+
+export function connectionTitle(extra?: string): string {
+  return cx('text-lg font-medium color-base', extra)
+}
+
+export function connectionBody(extra?: string): string {
+  return cx('max-w-sm text-sm color-muted', extra)
+}
+
+export function connectionDetail(extra?: string): string {
+  return cx('mt-1 max-w-sm break-words font-mono text-xs color-faint', extra)
+}
+
+export function toolbar(extra?: string): string {
+  return cx('flex items-center gap-2 shrink-0 h-8 px-2.5 border-b border-base bg-secondary text-sm', extra)
+}
+
+export function card(extra?: string): string {
+  return cx('flex flex-col rounded-xl border border-base bg-base shadow-sm', extra)
+}
+
+export function modalBackdrop(extra?: string): string {
+  return cx('fixed inset-0 z-modal-backdrop grid place-items-center p-4 bg-black/40 backdrop-blur-sm', extra)
+}
+
+export function modalCard(extra?: string): string {
+  return cx('z-modal-content w-full max-w-sm flex flex-col gap-3 p-4 rounded-xl border border-base bg-base shadow-lg', extra)
+}
+
+export function panel(extra?: string): string {
+  return cx('rounded-lg border border-base bg-base', extra)
+}
+
+export function input(extra?: string): string {
+  return cx('w-full min-w-0 rounded border border-base bg-base px-2.5 py-1 text-sm outline-none transition placeholder:color-faint focus-visible:border-active focus-visible:ring-2 focus-visible:ring-primary-500/40', extra)
+}
+
+export function link(extra?: string): string {
+  return cx('color-active hover:underline underline-offset-2', extra)
+}
+
+export type DotState = 'running' | 'idle' | 'error'
+export function dot(state: DotState, extra?: string): string {
+  const stateClass: Record<DotState, string> = {
+    running: 'bg-success',
+    idle: 'bg-neutral-400',
+    error: 'bg-error',
+  }
+  return cx('inline-block size-1.5 rounded-full shrink-0', stateClass[state], extra)
+}
+
+export function spinner(extra?: string): string {
+  return cx('inline-block size-4 rounded-full border-2 border-current border-t-transparent animate-spin', extra)
+}

design/uno.config.ts

@@ -0,0 +1,55 @@
+import { fileURLToPath } from 'node:url'
+import { presetAnthonyDesign } from '@antfu/design/unocss'
+import {
+  defineConfig,
+  presetIcons,
+  presetWebFonts,
+  presetWind4,
+  transformerDirectives,
+  transformerVariantGroup,
+} from 'unocss'
+
+// Shared devframe UnoCSS base. Every plugin and example composes `@antfu/design`
+// the same way — its preset (tuned to devframe's sage green) over a Wind4 base,
+// Phosphor icons, DM Sans/Mono web fonts, and the directive/variant-group
+// transformers — so the surfaces look and feel like one product across
+// frameworks. Each app extends this via `mergeConfigs([designConfig, { … }])`
+// and contributes only its own extraction globs (and any safelist).
+//
+// The shared web fonts (`sans`/`mono`), the named `z-*` layers and the `h-nav`
+// navbar height live here so every surface shares one font stack, one z-index
+// scale and one fixed navbar height. The `@antfu/design` preset blocks plain
+// `z-<number>`, so the layers are named on purpose.
+export const designConfig = defineConfig({
+  presets: [
+    presetAnthonyDesign({ primary: '#3a6a45' }),
+    presetWind4(),
+    presetIcons({ scale: 1.1 }),
+    presetWebFonts({ provider: 'none', fonts: { sans: 'DM Sans', mono: 'DM Mono' } }),
+  ],
+  transformers: [transformerDirectives(), transformerVariantGroup()],
+  // The shared class-helper builders (`design/design.ts`) assemble their class
+  // chains at runtime, so every app scans that one file (it carries
+  // `@unocss-include`) for extraction regardless of its own framework globs.
+  content: {
+    filesystem: [fileURLToPath(new URL('./design.ts', import.meta.url))],
+  },
+  // Wind4 leaves bare `border`/`border-b` at currentColor; restore the subtle
+  // shared border color (matching `border-base`) for unqualified borders.
+  preflights: [{ getCSS: () => '*,::before,::after{border-color:#8882}' }],
+  shortcuts: {
+    // Fixed navbar height, shared by every surface's top nav.
+    'h-nav': 'h-10',
+    // Named z-index layers, shared across every surface.
+    'z-nav': 'z-[30]',
+    'z-dropdown': 'z-[40]',
+    'z-tooltip': 'z-[45]',
+    'z-toast': 'z-[50]',
+    'z-modal-backdrop': 'z-[60]',
+    'z-modal-content': 'z-[70]',
+    'z-drawer-backdrop': 'z-[80]',
+    'z-drawer-content': 'z-[90]',
+  },
+})
+
+export default designConfig

docs/.vitepress/config.ts

@@ -64,6 +64,7 @@ function pluginsItems(prefix: string) {
     { text: 'Overview', link: `${prefix}/plugins/` },
     { text: 'Data Inspector', link: `${prefix}/plugins/data-inspector` },
     { text: 'Devframe Inspector', link: `${prefix}/plugins/inspect` },
+    { text: 'Open Graph Viewer', link: `${prefix}/plugins/og` },
     { text: 'Accessibility Inspector', link: `${prefix}/plugins/a11y` },
     { text: 'Git', link: `${prefix}/plugins/git` },
     { text: 'Terminals', link: `${prefix}/plugins/terminals` },

docs/plugins/index.md

@@ -12,6 +12,7 @@ Each plugin is built with a **different UI framework**. That is deliberate: devf
 |--------|--------------|--------------|
 | [Data Inspector](./data-inspector) | Vue | Query live server-side objects with jora — sources contributed by plugins, hosts, data files, or attached processes. |
 | [Devframe Inspector](./inspect) | Vue | Browse the RPC registry, invoke read-only queries, watch shared state update live, and explore the agent surface. |
+| [Open Graph Viewer](./og) | Vue | Inspect Open Graph and Twitter metadata and compare social-card previews. |
 | [Accessibility Inspector](./a11y) | Solid | Run axe-core against a host app, list WCAG violations, and highlight the offending element in the page on hover. |
 | [Git](./git) | React (Next.js) | A repository dashboard — status, a commit graph, branches, and diffs, with optional staging and committing. |
 | [Terminals](./terminals) | Svelte | Stream read-only command output and run fully interactive PTY shells in the browser. |
@@ -29,6 +30,7 @@ Most plugins publish a `bin`, so the quickest path is `npx`:
 
 ```sh
 npx @devframes/plugin-inspect      # the Devframe Inspector, standalone
+npx @devframes/plugin-og           # inspect Open Graph metadata and social cards
 npx @devframes/plugin-git          # the Git dashboard against the current repo
 ```
 

docs/plugins/og.md

@@ -0,0 +1,29 @@
+---
+outline: deep
+---
+
+# Open Graph Viewer
+
+Inspect a page's resolved Open Graph and Twitter metadata and compare its social cards across common platforms.
+
+## Run Standalone
+
+```sh
+npx @devframes/plugin-og
+```
+
+Enter any HTTP or HTTPS page reachable from the devframe process. The viewer resolves relative image and icon URLs against the fetched document and identifies missing metadata with a ready-to-use Nuxt `useSeoMeta()` snippet.
+
+## Create A Definition
+
+```ts
+import { createOgDevframe } from '@devframes/plugin-og'
+
+export default createOgDevframe({
+  defaultUrl: 'http://localhost:3000/about',
+})
+```
+
+`defaultUrl` supplies the initial target and makes `devframe build` bake that page into the static RPC dump. The resulting report keeps its assets relative and runs from any deployment path.
+
+The standalone server requires devframe's trust handshake by default because it can request developer-supplied URLs. Set `auth: false` only for an isolated local environment.