@kitn.ai/ui 0.27.0 → 0.29.0

package/src/primitives/card-registry.tsx

@@ -1,78 +0,0 @@
-// src/primitives/card-registry.tsx
-// One source of truth mapping a CardEnvelope.type to a renderer, for both layers:
-//   - CardComponentMap drives the Solid <CardRenderer>.
-//   - CardTagMap drives the <kai-cards> web component (child kai-* elements).
-// Built-ins cover the 7 contract card types; consumers extend/override via a `types`
-// prop (merged OVER the built-ins). kai-card (bare shell) is intentionally NOT a target.
-//
-// THE TAG HALF NOW LIVES IN ./card-tags — AND MUST STAY THERE.
-// `BUILTIN_CARD_TAGS` / `mergeCardTags` / `CardTagMap` are plain data with no Solid in
-// them, but while they shared this module with `BUILTIN_CARD_COMPONENTS` no Node/no-DOM
-// project could import them AS SOURCE, and the `kai` MCP re-derived the map by
-// convention as a result. ./card-tags.ts is that data on its own so
-// `@kitn.ai/ui/schemas` can export it; the re-export below keeps every existing
-// importer of this module working unchanged. Do not move them back — see the header
-// of ./card-tags.ts for the measured cost of the alternative (0 -> 1364 tsc errors).
-//
-// THE COMPONENT TYPES NOW LIVE IN ./card-component-types — SAME REASON, SECOND TIME.
-// `CardComponent` / `CardComponentMap` are named in the PUBLIC surface of
-// `@kitn.ai/ui/schemas` (src/schemas/registry.ts), so a Node/no-DOM project resolving
-// that entry's types reached this `.tsx` and hit TS6142. The types went to a `.ts`;
-// `BUILTIN_CARD_COMPONENTS` and `mergeCardComponents` stayed, because they are JSX and
-// have nowhere to go. Re-exported below, so this module's surface is unchanged.
-import type { CardComponentMap } from './card-component-types';
-import { Form } from '../components/form';
-import { ConfirmCard } from '../components/confirm-card';
-import { TasksCard } from '../components/tasks-card';
-import { ChoiceCard } from '../components/choice-card';
-import { LinkPreview } from '../components/link-preview';
-import { Embed } from '../components/embed';
-import { ArtifactCard, type ArtifactCardData } from '../components/artifact-card';
-
-// The tag half, re-exported so this module's surface is unchanged. Authored in
-// ./card-tags.ts because that file has no Solid below it and can therefore be read
-// from a Node process; this one cannot.
-export { BUILTIN_CARD_TAGS, mergeCardTags } from './card-tags';
-export type { CardTagMap } from './card-tags';
-
-// The component TYPES, re-exported for the same reason. Authored in
-// ./card-component-types.ts because resolving a `.tsx` is what a no-`jsx` project
-// cannot do; the values below stay here because they are JSX.
-export type { CardComponent, CardComponentMap } from './card-component-types';
-
-export const BUILTIN_CARD_COMPONENTS: CardComponentMap = {
-  form: (p) => (
-    <Form data={p.envelope.data as never} cardId={p.envelope.id} heading={p.envelope.title}
-      resolution={p.envelope.resolution} host={p.host} />
-  ),
-  confirm: (p) => (
-    <ConfirmCard data={p.envelope.data as never} cardId={p.envelope.id} heading={p.envelope.title}
-      resolution={p.envelope.resolution} host={p.host} />
-  ),
-  'tasks': (p) => (
-    <TasksCard data={p.envelope.data as never} cardId={p.envelope.id} heading={p.envelope.title}
-      resolution={p.envelope.resolution} host={p.host} />
-  ),
-  choice: (p) => (
-    <ChoiceCard data={p.envelope.data as never} cardId={p.envelope.id} heading={p.envelope.title}
-      resolution={p.envelope.resolution} host={p.host} />
-  ),
-  // link/embed have no `heading` and emit via an onEmit callback (no context).
-  link: (p) => (
-    <LinkPreview data={p.envelope.data as never} cardId={p.envelope.id} onEmit={(e) => p.host?.emit(e)} />
-  ),
-  embed: (p) => (
-    <Embed data={p.envelope.data as never} cardId={p.envelope.id} onEmit={(e) => p.host?.emit(e)} />
-  ),
-  // artifact owns real chrome of its own (sizing + heading), so like the four
-  // above it lives in components/ and gets only a thin wrapper here.
-  artifact: (p) => (
-    <ArtifactCard data={p.envelope.data as ArtifactCardData} cardId={p.envelope.id}
-      heading={p.envelope.title} host={p.host} />
-  ),
-};
-
-/** Built-ins with the consumer's overrides merged on top (consumer wins). */
-export function mergeCardComponents(types?: CardComponentMap): CardComponentMap {
-  return types ? { ...BUILTIN_CARD_COMPONENTS, ...types } : { ...BUILTIN_CARD_COMPONENTS };
-}

package/src/primitives/card-resolution.ts

@@ -1,36 +0,0 @@
-// Pure consumer-facing helpers for the re-hydration round-trip. Feed a terminal
-// CardEvent back into the cards array so a resolved card survives reload:
-//   el.cards = applyResolution(el.cards, e.detail)
-// Deterministic — no Date (the optional `at` provenance is left to the consumer).
-import type { CardEnvelope, CardEvent, CardResolution } from './card-contract';
-
-/** Map a terminal CardEvent (`action` | `submit`) to a CardResolution.
- *  Returns undefined for every non-terminal verb (ready/error/resize/state/…). */
-export function resolutionFromEvent(event: CardEvent): CardResolution | undefined {
-  if (event.kind === 'action') {
-    return {
-      kind: 'action',
-      action: event.action,
-      ...(event.payload !== undefined ? { payload: event.payload } : {}),
-    };
-  }
-  if (event.kind === 'submit') {
-    return { kind: 'submit', data: event.data };
-  }
-  return undefined;
-}
-
-/** Return a new cards array with the envelope matching `event.cardId` stamped with its
- *  resolution. Non-terminal events or an unknown cardId return the SAME array reference
- *  (cheap no-op; safe to call on every event). Never mutates the input. */
-export function applyResolution(cards: CardEnvelope[], event: CardEvent): CardEnvelope[] {
-  const resolution = resolutionFromEvent(event);
-  if (!resolution) return cards;
-  let changed = false;
-  const next = cards.map((c) => {
-    if (c.id !== event.cardId) return c;
-    changed = true;
-    return { ...c, resolution };
-  });
-  return changed ? next : cards;
-}

package/src/primitives/card-routing.ts

@@ -1,85 +0,0 @@
-// src/primitives/card-routing.ts
-// Framework-agnostic card-event plumbing: the bubbling kai-card emitter, the single
-// policy router (used by BOTH the native listener and the remote transport), and a
-// host-side listener helper for the bare-element path.
-import type { CardEvent, CardPolicy } from './card-contract';
-// isSafeUrl/isScriptUrl live in their own DOM-free file so schema.ts
-// (agent-tooling/construct, checked under tsconfig.mcp.json's Node-only pass)
-// can import isSafeUrl without dragging this file's HTMLElement/window/
-// CustomEvent references into a no-DOM-lib compile. Re-exported here so this
-// module's own public surface is unchanged.
-import { isSafeUrl, isScriptUrl } from './url-scheme-policy';
-export { isSafeUrl, isScriptUrl } from './url-scheme-policy';
-
-/** The single contract event name. */
-export const CARD_EVENT_NAME = 'kai-card';
-
-/** Dispatch a CardEvent as the bubbling, composed `kai-card` event a host listener
- *  routes. NB: this is deliberately different from defineWebComponent's built-in
- *  non-bubbling dispatch. */
-export function emitCardEvent(element: HTMLElement, event: CardEvent): void {
-  element.dispatchEvent(
-    new CustomEvent<CardEvent>(CARD_EVENT_NAME, { detail: event, bubbles: true, composed: true }),
-  );
-}
-
-function warnNoHandler(kind: string): void {
-  // eslint-disable-next-line no-console
-  console.warn(`[kai-card] no policy handler for "${kind}"`);
-}
-
-/** Apply the contract's policy to one event. The ONE place routing lives. */
-export function routeCardEvent(policy: CardPolicy | undefined, event: CardEvent): void {
-  const p: CardPolicy = policy ?? {};
-  switch (event.kind) {
-    case 'ready':
-      break; // lifecycle; host may react via its own listener
-    case 'submit':
-      p.onSubmit ? p.onSubmit(event.cardId, event.data) : warnNoHandler('submit');
-      break;
-    case 'action':
-      p.onAction ? p.onAction(event.cardId, event.action, event.payload) : warnNoHandler('action');
-      break;
-    case 'send-prompt': {
-      const requested = event.mode ?? 'compose';
-      const mode = p.maxSendPromptMode === 'send' ? requested : 'compose';
-      p.onSendPrompt ? p.onSendPrompt(event.text, { mode, context: event.context }) : warnNoHandler('send-prompt');
-      break;
-    }
-    case 'open': {
-      if (!isSafeUrl(event.url)) {
-        p.onError ? p.onError(event.cardId, `Blocked unsafe url: ${event.url}`) : warnNoHandler('open(unsafe)');
-        break;
-      }
-      const target = event.target ?? 'tab';
-      if (p.onOpen) p.onOpen(event.url, target);
-      else if (typeof window !== 'undefined') window.open(event.url, '_blank', 'noopener,noreferrer');
-      break;
-    }
-    case 'state':
-      p.onState ? p.onState(event.cardId, event.patch) : warnNoHandler('state');
-      break;
-    case 'dismiss':
-      p.onDismiss ? p.onDismiss(event.cardId) : warnNoHandler('dismiss');
-      break;
-    case 'reopen':
-      p.onReopen ? p.onReopen(event.cardId) : warnNoHandler('reopen');
-      break;
-    case 'error':
-      p.onError ? p.onError(event.cardId, event.message) : warnNoHandler('error');
-      break;
-    case 'resize':
-      break; // transport plumbing (iframe height); not an app-policy concern natively
-  }
-}
-
-/** Attach a host-level `kai-card` listener that routes every bubbling card event
- *  through `policy`. Returns an unsubscribe fn. For the bare-element path. */
-export function listenForCardEvents(
-  root: HTMLElement | Document,
-  policy: CardPolicy,
-): () => void {
-  const handler = (e: Event) => routeCardEvent(policy, (e as CustomEvent<CardEvent>).detail);
-  root.addEventListener(CARD_EVENT_NAME, handler as EventListener);
-  return () => root.removeEventListener(CARD_EVENT_NAME, handler as EventListener);
-}

package/src/primitives/card-schemas/artifact.schema.json

@@ -1,92 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/artifact.schema.json",
-  "title": "ArtifactCardData",
-  "description": "Generated-artifact viewer payload: a framed preview plus the source files behind it. A deliberately NARROW subset of the Artifact component's props — it says WHAT to show, never how the viewer behaves. Toolbar composition, view-state and the iframe `sandbox` are host-owned and stay off the wire, so a model cannot widen its own sandbox or hide the chrome the user needs to inspect what it built.",
-  "type": "object",
-  "additionalProperties": false,
-  "anyOf": [{ "required": ["src"] }, { "required": ["files"] }],
-  "properties": {
-    "src": {
-      "type": "string",
-      "format": "uri",
-      "description": "URL the preview iframe frames, and the target of the Home button. Omit for a source-only artifact (`tab: 'code'` with `files`).",
-      "x-kai-format": "url"
-    },
-    "files": {
-      "type": "array",
-      "description": "Files behind the artifact: the Code tab's tree, each optionally carrying its own preview url and source.",
-      "maxItems": 500,
-      "items": {
-        "type": "object",
-        "required": ["path"],
-        "additionalProperties": false,
-        "properties": {
-          "path": {
-            "type": "string",
-            "description": "Tree label/key. Folders are built from `/`-delimited segments.",
-            "maxLength": 1024
-          },
-          "url": {
-            "type": "string",
-            "format": "uri",
-            "description": "Where the preview loads this file. Defaults to `path` resolved against `src`.",
-            "x-kai-format": "url"
-          },
-          "code": {
-            "type": "string",
-            "description": "Source shown in the Code tab. Omit for binary files (image/pdf), which have no code view."
-          },
-          "language": {
-            "type": "string",
-            "description": "Language id for syntax highlighting (e.g. 'html', 'css', 'tsx').",
-            "maxLength": 40
-          },
-          "type": {
-            "type": "string",
-            "enum": ["html", "pdf", "image", "other"],
-            "description": "File kind. Drives the tree icon and whether the Code view applies; 'pdf' also routes the preview to the inline PDF viewer.",
-            "x-kai-control": "select"
-          },
-          "additions": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Lines added vs the base. Rendered as a trailing '+N' stat."
-          },
-          "deletions": {
-            "type": "integer",
-            "minimum": 0,
-            "description": "Lines removed vs the base. Rendered as a trailing '-N' stat."
-          },
-          "status": {
-            "type": "string",
-            "enum": ["added", "modified", "deleted", "renamed", "untracked"],
-            "description": "Change status vs the base. Drives a trailing status letter in the conventional VCS hue.",
-            "x-kai-control": "select"
-          }
-        }
-      }
-    },
-    "tab": {
-      "type": "string",
-      "enum": ["preview", "code"],
-      "default": "preview",
-      "description": "Which view the card OPENS on. SEED ONLY: the user can switch freely afterwards and a revision of this card will NOT move them back, because the user's choice wins over the model's. A switch is reported back as a `state` patch.",
-      "x-kai-control": "select"
-    },
-    "activeFile": {
-      "type": "string",
-      "description": "Path of the file selected in the tree when the card FIRST renders (must match a `files[].path`). Seeds the tree highlight, the Code source and the preview. SEED ONLY, like `tab`: revising this card will not move a user who has since selected a different file.",
-      "maxLength": 1024
-    },
-    "displayUrl": {
-      "type": "string",
-      "description": "Friendly address shown in the path field INSTEAD of the real url, which also makes the field read-only. Use when `src` is not consumer-facing (e.g. a `data:` blob) so a clean address is shown rather than leaking it.",
-      "maxLength": 2048
-    },
-    "height": {
-      "description": "Frame height. A bare number is px; a string is any CSS length. Defaults to 420px. REQUIRED CONCEPT, not decoration: the viewer is built to fill its container, and a message thread supplies no height, so the card sets one explicitly or the artifact collapses to zero and renders invisible.",
-      "oneOf": [{ "type": "number", "minimum": 1 }, { "type": "string", "maxLength": 32 }]
-    }
-  }
-}

package/src/primitives/card-schemas/card-envelope.schema.json

@@ -1,14 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/card-envelope.schema.json",
-  "title": "CardEnvelope",
-  "description": "A card the agent/server asks the chat to render. `data` validates against the per-type schema.",
-  "type": "object",
-  "required": ["type", "id", "data"],
-  "properties": {
-    "type": { "type": "string", "minLength": 1 },
-    "id": { "type": "string", "minLength": 1 },
-    "data": {},
-    "title": { "type": "string" }
-  }
-}

package/src/primitives/card-schemas/card-event.schema.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/card-event.schema.json",
-  "title": "CardEvent",
-  "description": "An event a card emits up to the host. `kind` discriminates the payload.",
-  "type": "object",
-  "required": ["kind"],
-  "properties": {
-    "kind": { "enum": ["ready", "submit", "action", "send-prompt", "open", "resize", "state", "dismiss", "error"] },
-    "cardId": { "type": "string" }
-  }
-}

package/src/primitives/card-schemas/choice.schema.json

@@ -1,75 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/choice.schema.json",
-  "title": "ChoiceCardData",
-  "description": "Data payload for a `choice` card (CardEnvelope.data when type='choice'). A single-select 'pick one of N rich options' card; activating an option emits the `action` verb.",
-  "type": "object",
-  "required": ["options"],
-  "properties": {
-    "prompt": {
-      "type": "string",
-      "description": "Optional question/body text rendered above the options. Distinct from CardEnvelope.title (the card chrome heading)."
-    },
-    "submitLabel": {
-      "type": "string",
-      "description": "Label for the Submit button; default 'Submit'."
-    },
-    "options": {
-      "type": "array",
-      "minItems": 1,
-      "description": "The selectable options, rendered in order. Exactly one can be chosen.",
-      "items": {
-        "type": "object",
-        "required": ["id", "label"],
-        "properties": {
-          "id": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Emitted as CardEvent.action. Must be unique within `options`. (The reserved id '__other__' is used by the allowOther escape.)",
-            "x-kai-unique": true
-          },
-          "label": { "type": "string", "minLength": 1, "description": "Visible option label." },
-          "description": {
-            "type": "string",
-            "description": "Optional secondary line under the label."
-          },
-          "media": {
-            "type": "object",
-            "description": "Optional leading media: an image URL or a named icon.",
-            "properties": {
-              "image": { "type": "string", "description": "Image URL rendered as a leading thumbnail in the row." },
-              "imageAlt": { "type": "string", "description": "Accessible alt text for `image` (decorative if omitted)." },
-              "icon": { "type": "string", "description": "Named icon rendered as a leading glyph." }
-            }
-          },
-          "meta": {
-            "type": "string",
-            "description": "Trailing freeform text (e.g. a price or badge), right-aligned in the row."
-          },
-          "recommended": {
-            "type": "boolean",
-            "default": false,
-            "description": "Renders a small 'Recommended' pill near the label."
-          },
-          "disabled": {
-            "type": "boolean",
-            "default": false,
-            "description": "Option is shown but not selectable, and skipped in keyboard nav."
-          },
-          "payload": {
-            "description": "Optional opaque payload echoed back in CardEvent.payload (any JSON)."
-          }
-        }
-      }
-    },
-    "allowOther": {
-      "description": "Optional free-text escape ('none of these / specify'). `true` appends a final 'Other…' option; an object customizes its `label`/`placeholder`. Selecting it reveals a text input; the shared Submit button then emits `{ kind:'action', action:'__other__', payload:{ text } }`.",
-      "x-kai-control": "allow-other"
-    },
-    "dismissible": {
-      "type": "boolean",
-      "default": false,
-      "description": "Show a close affordance that emits the `dismiss` verb. The card collapses to a re-openable 'dismissed' stub; the host decides via `onReopen` whether it comes back live or `expired`."
-    }
-  }
-}

package/src/primitives/card-schemas/confirm.schema.json

@@ -1,65 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/confirm.schema.json",
-  "title": "ConfirmCardData",
-  "description": "Data payload for a `confirm` card (CardEnvelope.data when type='confirm').",
-  "type": "object",
-  "required": ["actions"],
-  "properties": {
-    "heading": {
-      "type": "string",
-      "description": "Optional in-body heading. Distinct from CardEnvelope.title (the card chrome title)."
-    },
-    "body": {
-      "type": "string",
-      "description": "Body text. Plain text in v1 (rendered safely; no HTML injection)."
-    },
-    "tone": {
-      "type": "string",
-      "enum": ["default", "warning", "danger"],
-      "default": "default",
-      "description": "Overall card tone; 'danger' adds a warning icon + accent for destructive approvals.",
-      "x-kai-control": "tone"
-    },
-    "actions": {
-      "type": "array",
-      "minItems": 1,
-      "maxItems": 4,
-      "description": "The choice set. Rendered as buttons in order; max 4 keeps it a decision, not a menu.",
-      "items": {
-        "type": "object",
-        "required": ["id", "label"],
-        "properties": {
-          "id": {
-            "type": "string",
-            "minLength": 1,
-            "description": "Emitted as CardEvent.action. Must be unique within `actions`.",
-            "x-kai-unique": true
-          },
-          "label": { "type": "string", "minLength": 1, "description": "Visible button label." },
-          "style": {
-            "type": "string",
-            "enum": ["primary", "default", "destructive"],
-            "default": "default",
-            "description": "Button emphasis. 'destructive' = red/danger; 'primary' = filled accent.",
-            "x-kai-control": "button-style"
-          },
-          "payload": {
-            "description": "Optional opaque payload echoed back in CardEvent.payload (any JSON)."
-          },
-          "default": {
-            "type": "boolean",
-            "default": false,
-            "description": "If true, this action is the keyboard default (Enter) and gets initial focus. At most one should be true; the card uses the first if several are.",
-            "x-kai-default-action": true
-          }
-        }
-      }
-    },
-    "dismissible": {
-      "type": "boolean",
-      "default": false,
-      "description": "Show a close affordance that emits the `dismiss` verb."
-    }
-  }
-}

package/src/primitives/card-schemas/embed.schema.json

@@ -1,63 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/embed.schema.json",
-  "title": "EmbedCardData",
-  "description": "Lazy media-embed payload (YouTube / Vimeo / generic player URL).",
-  "type": "object",
-  "required": ["provider"],
-  "additionalProperties": false,
-  "properties": {
-    "provider": {
-      "type": "string",
-      "enum": ["youtube", "vimeo", "generic"],
-      "description": "Media provider. 'generic' frames `url` directly (must be an https embeddable player URL whose origin is app-allowlisted).",
-      "x-kai-control": "select"
-    },
-    "id": {
-      "type": "string",
-      "description": "Provider video id (required for youtube/vimeo when `url` is absent). e.g. 'dQw4w9WgXcQ'.",
-      "maxLength": 64,
-      "pattern": "^[A-Za-z0-9_-]+$"
-    },
-    "url": {
-      "type": "string",
-      "format": "uri",
-      "description": "Full media/watch URL. For youtube/vimeo it is parsed to an id; for 'generic' it is the embeddable player src (https only).",
-      "x-kai-format": "url"
-    },
-    "title": {
-      "type": "string",
-      "description": "Accessible title for the player iframe + the poster label. Strongly recommended for a11y.",
-      "maxLength": 300
-    },
-    "poster": {
-      "type": "string",
-      "format": "uri",
-      "description": "Thumbnail shown before play. When omitted, youtube/vimeo derive a default thumbnail; 'generic' shows a neutral play placeholder.",
-      "x-kai-format": "url"
-    },
-    "start": {
-      "type": "integer",
-      "minimum": 0,
-      "description": "Optional start offset in seconds.",
-      "x-kai-unit": "seconds"
-    },
-    "aspectRatio": {
-      "type": "string",
-      "enum": ["16:9", "4:3", "1:1", "9:16"],
-      "default": "16:9",
-      "description": "Player box aspect ratio (CSS aspect-ratio).",
-      "x-kai-control": "select"
-    }
-  },
-  "allOf": [
-    {
-      "if": { "properties": { "provider": { "const": "generic" } } },
-      "then": { "required": ["url"] }
-    },
-    {
-      "if": { "properties": { "provider": { "enum": ["youtube", "vimeo"] } } },
-      "then": { "anyOf": [{ "required": ["id"] }, { "required": ["url"] }] }
-    }
-  ]
-}

package/src/primitives/card-schemas/form.result.schema.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/form.result.schema.json",
-  "title": "kai-form submit payload",
-  "description": "The CardEvent {kind:'submit'} `data` for a form card: an object that validates against the form-definition schema that was sent down in CardEnvelope.data. Standard JSON Schema validation (type/enum/required/min-max/length/pattern) holds. Optional empty strings are omitted.",
-  "type": "object"
-}

package/src/primitives/card-schemas/form.schema.json

@@ -1,53 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/form.schema.json",
-  "title": "kai-form data (a form definition)",
-  "description": "The CardEnvelope.data for a card of type 'form': a JSON Schema (type:'object') describing the fields kai-form renders, plus optional x-kai-* UI hints. The same schema validates the submission.",
-  "type": "object",
-  "required": ["type", "properties"],
-  "properties": {
-    "type": { "const": "object" },
-    "title": { "type": "string" },
-    "description": { "type": "string" },
-    "required": { "type": "array", "items": { "type": "string" } },
-    "properties": {
-      "type": "object",
-      "description": "The fields to collect, keyed by property name. Each value is a JSON Schema field definition (type, title, description, enum, minimum/maximum, minLength/maxLength, pattern, items) plus optional x-kai-* UI hints. Only the display-format hints are spelled out below; the rest of a field definition is ordinary JSON Schema.",
-      "additionalProperties": {
-        "type": "object",
-        "properties": {
-          "x-kai-format": {
-            "description": "Display format for a string field. `tel`, `ssn` and `credit-card` apply that type's standard mask and submit digits only; `custom` masks with `x-kai-mask` and submits the formatted value. Omit it for a plain text field.",
-            "enum": ["tel", "ssn", "credit-card", "custom"]
-          },
-          "x-kai-mask": {
-            "description": "The mask pattern, used only with `x-kai-format: \"custom\"`: `#` one digit, `@` one letter or digit, `*` one letter or digit that may be obscured; every other character is a literal shown as typed, e.g. `CHG-####`.",
-            "type": "string",
-            "maxLength": 64
-          },
-          "x-kai-mask-guide": {
-            "description": "Placeholder text shown at the unfilled positions of the mask, aligned character for character with the pattern (`mm/dd/yyyy` for `##/##/####`). Derived from the pattern when omitted.",
-            "type": "string",
-            "maxLength": 64
-          }
-        }
-      }
-    },
-    "x-kai-order": { "type": "array", "items": { "type": "string" } },
-    "x-kai-inlineMax": { "type": "integer", "minimum": 1 },
-    "x-kai-submitLabel": { "type": "string" },
-    "x-kai-dismissible": { "type": "boolean" },
-    "x-kai-actions": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "required": ["id", "label"],
-        "properties": {
-          "id": { "type": "string" },
-          "label": { "type": "string" },
-          "variant": { "enum": ["default", "ghost", "outline"] }
-        }
-      }
-    }
-  }
-}

package/src/primitives/card-schemas/link.schema.json

@@ -1,54 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "https://kitn.ai/schemas/card/link.schema.json",
-  "title": "LinkPreviewData",
-  "description": "Rich link / Open-Graph preview payload. The card renders from this; it never fetches.",
-  "type": "object",
-  "required": ["url"],
-  "additionalProperties": false,
-  "properties": {
-    "url": {
-      "type": "string",
-      "format": "uri",
-      "description": "Canonical destination. Opened via the contract `open` verb (target 'tab').",
-      "x-kai-format": "url"
-    },
-    "title": {
-      "type": "string",
-      "description": "OG title (og:title). Falls back to the domain when absent.",
-      "maxLength": 300
-    },
-    "description": {
-      "type": "string",
-      "description": "OG description (og:description). Clamped to 3 lines in the UI.",
-      "maxLength": 1000
-    },
-    "image": {
-      "type": "string",
-      "format": "uri",
-      "description": "Preview image (og:image). Optional; the card degrades gracefully when missing or it fails to load.",
-      "x-kai-format": "url"
-    },
-    "imageAlt": {
-      "type": "string",
-      "description": "Alt text for the preview image. Defaults to the title (or empty = decorative) when omitted.",
-      "maxLength": 300
-    },
-    "favicon": {
-      "type": "string",
-      "format": "uri",
-      "description": "Site favicon shown next to the domain.",
-      "x-kai-format": "url"
-    },
-    "domain": {
-      "type": "string",
-      "description": "Display domain (e.g. 'example.com'). Derived from `url` when omitted.",
-      "maxLength": 253
-    },
-    "siteName": {
-      "type": "string",
-      "description": "OG site name (og:site_name). Shown in place of the domain when present.",
-      "maxLength": 200
-    }
-  }
-}