@agent-native/core 0.37.3 → 0.38.0

package/dist/client/blocks/server.js

@@ -0,0 +1,25 @@
+/**
+ * `@agent-native/core/blocks/server` — the React-free subset of the block
+ * registry for server / agent code (MDX serialize/parse, the registry, schema
+ * introspection, the `markdown()` helper, agent schema export). Importing this
+ * entry never pulls React into the server bundle.
+ *
+ * A `BlockSpec` carries React (`Read`/`Edit`) and pure (`schema`/`mdx`) parts in
+ * the same object; the server path only touches `spec.schema` / `spec.mdx`. The
+ * app's registry module is shared by browser and server, but the server only
+ * ever calls these React-free functions on it.
+ */
+export { defineBlock, } from "./types.js";
+export { BlockRegistry, registerBlocks } from "./registry.js";
+export { markdown, richtext, introspect, } from "./schema-form/introspect.js";
+export { prop, escapeAttr, jsonExpression, attributeValue, createAttrReader, serializeSpecBlock, parseSpecBlock, } from "./mdx.js";
+export { describeBlocksForAgent, renderBlockVocabularyReference, } from "./agent.js";
+// Standard block library — React-free schema + MDX config only. The React
+// `Read`/`Edit` live in `./library/checklist.tsx` (imported from the full
+// `@agent-native/core/blocks` entry), never from here.
+export { checklistSchema, checklistMdx, } from "./library/checklist.config.js";
+export { tableSchema, tableMdx, } from "./library/table.config.js";
+export { codeTabsSchema, codeTabsMdx, } from "./library/code-tabs.config.js";
+export { htmlSchema, htmlMdx, } from "./library/html.config.js";
+export { tabsSchema, tabsMdx, } from "./library/tabs.config.js";
+//# sourceMappingURL=server.js.map

package/dist/client/blocks/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../src/client/blocks/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,WAAW,GAOZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,GAGX,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,IAAI,EACJ,UAAU,EACV,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,GAKf,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,sBAAsB,EACtB,8BAA8B,GAE/B,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,0EAA0E;AAC1E,uDAAuD;AACvD,OAAO,EACL,eAAe,EACf,YAAY,GAGb,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,WAAW,EACX,QAAQ,GAET,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,cAAc,EACd,WAAW,GAGZ,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,UAAU,EACV,OAAO,GAER,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,UAAU,EACV,OAAO,GAGR,MAAM,0BAA0B,CAAC","sourcesContent":["/**\n * `@agent-native/core/blocks/server` — the React-free subset of the block\n * registry for server / agent code (MDX serialize/parse, the registry, schema\n * introspection, the `markdown()` helper, agent schema export). Importing this\n * entry never pulls React into the server bundle.\n *\n * A `BlockSpec` carries React (`Read`/`Edit`) and pure (`schema`/`mdx`) parts in\n * the same object; the server path only touches `spec.schema` / `spec.mdx`. The\n * app's registry module is shared by browser and server, but the server only\n * ever calls these React-free functions on it.\n */\n\nexport {\n  defineBlock,\n  type BlockSpec,\n  type BlockPlacement,\n  type BlockMdxConfig,\n  type BlockAttrReader,\n  type MdxAttrValue,\n  type NestedBlock,\n} from \"./types.js\";\n\nexport { BlockRegistry, registerBlocks } from \"./registry.js\";\n\nexport {\n  markdown,\n  richtext,\n  introspect,\n  type FieldKind,\n  type FieldDescriptor,\n} from \"./schema-form/introspect.js\";\n\nexport {\n  prop,\n  escapeAttr,\n  jsonExpression,\n  attributeValue,\n  createAttrReader,\n  serializeSpecBlock,\n  parseSpecBlock,\n  type MdxJsxNode,\n  type MdxAttrNode,\n  type SerializableBlock,\n  type ParsedBlockBase,\n} from \"./mdx.js\";\n\nexport {\n  describeBlocksForAgent,\n  renderBlockVocabularyReference,\n  type BlockAgentDoc,\n} from \"./agent.js\";\n\n// Standard block library — React-free schema + MDX config only. The React\n// `Read`/`Edit` live in `./library/checklist.tsx` (imported from the full\n// `@agent-native/core/blocks` entry), never from here.\nexport {\n  checklistSchema,\n  checklistMdx,\n  type ChecklistData,\n  type ChecklistItem,\n} from \"./library/checklist.config.js\";\nexport {\n  tableSchema,\n  tableMdx,\n  type TableData,\n} from \"./library/table.config.js\";\nexport {\n  codeTabsSchema,\n  codeTabsMdx,\n  type CodeTabsData,\n  type CodeTabsTab,\n} from \"./library/code-tabs.config.js\";\nexport {\n  htmlSchema,\n  htmlMdx,\n  type HtmlBlockData,\n} from \"./library/html.config.js\";\nexport {\n  tabsSchema,\n  tabsMdx,\n  type TabsData,\n  type TabsTab,\n} from \"./library/tabs.config.js\";\n"]}

package/dist/client/blocks/types.d.ts

@@ -0,0 +1,212 @@
+import type { FC } from "react";
+import type { ZodType } from "zod";
+/**
+ * Block-registry contract. A `BlockSpec` describes one document block end to end:
+ * its data shape (`schema`), how it round-trips to MDX source (`mdx`), how it
+ * renders read-only (`Read`) and how it is edited (`Edit`, or an auto-generated
+ * schema-driven editor when omitted), where it can be placed (`placement`), and
+ * metadata for menus / agent schema export.
+ *
+ * The registry runs ALONGSIDE existing per-block code (the plan `PlanBlockView`
+ * switch + `serializeBlock`/`parseBlock`). Renderers check the registry first;
+ * unregistered block types fall through to the legacy code path unchanged. The
+ * MDX `tag` and attribute shape for a converted block MUST match the historical
+ * encoding (e.g. `<Callout tone>…body…</Callout>`) so stored `.mdx` files still
+ * parse byte-compatibly.
+ */
+/** Where a block can be placed in a document. */
+export type BlockPlacement = "block" | "inline";
+/**
+ * A serialized MDX/NFM attribute value before the shared `prop()` encoder runs.
+ * `prop()` decides string-vs-JSON encoding; this is just the value domain.
+ */
+export type MdxAttrValue = string | number | boolean | unknown[] | Record<string, unknown>;
+/**
+ * Type-narrowed reader over the resolved MDX attributes of a parsed block node.
+ * The values are already estree/JSON-resolved by the shared attribute reader
+ * (the same engine `plan-mdx.ts` uses), so a spec's `fromAttrs` never touches
+ * the AST directly.
+ */
+export interface BlockAttrReader {
+    string(name: string): string | undefined;
+    number(name: string): number | undefined;
+    bool(name: string): boolean | undefined;
+    array<T = unknown>(name: string): T[] | undefined;
+    object<T = unknown>(name: string): T | undefined;
+    raw(name: string): unknown;
+}
+/**
+ * Maps a block's validated data to/from its MDX component representation.
+ * `tag` is the JSX component name in source (e.g. "Callout"). It MUST match the
+ * historical name in `plan-mdx.ts` `BLOCK_COMPONENTS` / stored `.mdx` files or
+ * existing plans break.
+ */
+export interface BlockMdxConfig<TData> {
+    /** JSX component name in MDX source. Stable contract — never rename. */
+    tag: string;
+    /**
+     * Encode `data` → a flat attribute bag. The registry serializer runs each
+     * value through the shared `prop()` encoder (string-vs-JSON heuristic) and
+     * preserves insertion order, so write the keys in the exact historical order.
+     * Return `undefined` for a key (or omit it) to drop the attribute. When
+     * `childrenField` is set, that field is excluded from the attribute bag.
+     */
+    toAttrs: (data: TData) => Record<string, MdxAttrValue | undefined>;
+    /**
+     * Decode resolved attributes (+ optional children markdown) → data. Must
+     * tolerate missing/partial attributes for backward-compat (mirror today's
+     * `?? []` / `?? ""` defaults).
+     */
+    fromAttrs: (attrs: BlockAttrReader, children: string) => TData;
+    /**
+     * When set, this data field is a markdown string serialized as MDX *children*
+     * between the open/close tags (prose-bearing blocks: rich-text, callout)
+     * rather than as a prop — so the body survives as real, inline-editable MDX
+     * prose in source.
+     */
+    childrenField?: keyof TData & string;
+    /**
+     * Opt-in custom children serializer for blocks whose internals are nested MDX
+     * components rather than a single markdown string (e.g. wireframe → Screen/kit
+     * primitives). When present it overrides `childrenField`. `serializeChildren`
+     * returns the raw inner MDX; `parseChildren` receives the child MDX AST nodes.
+     */
+    serializeChildren?: (data: TData) => string;
+    parseChildren?: (childNodes: unknown[], idContext: string) => Partial<TData>;
+}
+/**
+ * App-injected capabilities. Core blocks stay app-agnostic by taking these
+ * rather than importing app services — mirroring `createImageExtension`'s
+ * `onImageUpload` injection. Provided via `BlockRegistryProvider`.
+ */
+export interface BlockRenderContext {
+    /** Markdown dialect for the auto-editor's rich-text field. */
+    dialect?: "gfm" | "nfm";
+    /** Resolve an asset id → displayable URL. */
+    resolveAssetSrc?: (assetId: string) => string | undefined;
+    /** Open the shared asset picker (returns the chosen asset). */
+    pickAsset?: () => Promise<{
+        assetId: string;
+        url?: string;
+    } | null>;
+    /** Upload a local file, returns a hosted URL. */
+    uploadFile?: (file: File) => Promise<{
+        url: string;
+        assetId?: string;
+    }>;
+    /** Call an app action by name (for blocks that fetch live data). */
+    callAction?: (name: string, args: unknown) => Promise<unknown>;
+    /** Sanitizer for HTML-bearing blocks. Provided by the app/core. */
+    sanitizeHtml?: (html: string, css?: string) => string;
+    /**
+     * Render a markdown string with the app's read-only markdown renderer. Lets a
+     * core block (whose `Read` lives in core) defer prose rendering to the app's
+     * markdown reader (e.g. the plan `PlanMarkdownReader`) without importing it.
+     */
+    renderMarkdown?: (markdown: string) => React.ReactNode;
+    /**
+     * Render an inline, editable rich-markdown field. The auto-editor calls this
+     * for a `markdown()`-tagged field so the app owns the editor wiring (collab,
+     * autosave debounce, dialect) rather than core hardcoding it.
+     */
+    renderMarkdownEditor?: (props: {
+        value: string;
+        onChange: (next: string) => void;
+        editable: boolean;
+        blockId?: string;
+    }) => React.ReactNode;
+    /**
+     * Render a nested child block through the app's own block dispatcher. Container
+     * blocks whose `Read`/`Edit` live in core (e.g. tabs) call this to render each
+     * child so the recursion keeps flowing through the SAME app renderer the
+     * top-level document uses — registered children render via their spec, and
+     * unregistered (not-yet-converted) children still fall through the app's legacy
+     * switch. This is the coexistence seam: a core container never has to know
+     * about app-specific child block types. Returns `null`/`undefined` when no
+     * dispatcher is wired (read-only/SSR-only contexts can omit it).
+     */
+    renderBlock?: (props: {
+        block: NestedBlock;
+        /** Commit a replacement for this child block (edit mode only). */
+        onChange?: (next: NestedBlock) => void;
+        /** Whether the parent container is being edited. */
+        editing?: boolean;
+        /** Tighten embedded visuals in dense contexts (e.g. tab panes). */
+        compactVisuals?: boolean;
+    }) => React.ReactNode;
+}
+/**
+ * The minimal shape of a nested child block passed to {@link
+ * BlockRenderContext.renderBlock}. It mirrors the app's block union loosely (the
+ * app casts it back to its own block type) — a discriminating `type`, a stable
+ * `id`, optional heading/summary, and the type-specific `data`.
+ */
+export interface NestedBlock {
+    type: string;
+    id: string;
+    title?: string;
+    summary?: string;
+    data: unknown;
+    [key: string]: unknown;
+}
+/** Props passed to a block's read-only renderer. */
+export interface BlockReadProps<TData> {
+    data: TData;
+    /** Stable block id (for anchors, comment targeting, source patches). */
+    blockId: string;
+    /** Block heading, when present. */
+    title?: string;
+    /** Block trailing summary, when present. */
+    summary?: string;
+    /** Injected app capabilities. */
+    ctx: BlockRenderContext;
+}
+/** Props passed to a block's editor (custom or schema-generated). */
+export interface BlockEditProps<TData> {
+    data: TData;
+    onChange: (next: TData) => void;
+    editable: boolean;
+    blockId: string;
+    title?: string;
+    summary?: string;
+    /** Injected app capabilities. */
+    ctx: BlockRenderContext;
+}
+export interface BlockSpec<TData = unknown> {
+    /** Discriminator. Equals the runtime block `type`. */
+    type: string;
+    /** Zod schema for `data`. Drives validation AND the schema-auto-editor. */
+    schema: ZodType<TData>;
+    /** MDX round-trip config. */
+    mdx: BlockMdxConfig<TData>;
+    /** Read-only renderer (replaces a `PlanBlockView` switch branch / NodeView). */
+    Read: FC<BlockReadProps<TData>>;
+    /**
+     * Optional editor. When omitted, the registry renders the schema-driven
+     * `SchemaBlockEditor` generated from `schema`. Supply for full control
+     * (wireframe canvas, diagram editor).
+     */
+    Edit?: FC<BlockEditProps<TData>>;
+    /** Allowed placements: `["block"]`, `["inline"]`, or both. */
+    placement: BlockPlacement[];
+    /** Human label for menus + agent schema export. */
+    label: string;
+    /** Tabler icon component for UI menus (never emoji/robot/sparkle). */
+    icon?: FC<{
+        size?: number;
+        className?: string;
+    }>;
+    /** One-line description for the agent schema export. */
+    description: string;
+    /** Optional default `data` factory for slash-menu insertion (an empty block). */
+    empty?: () => TData;
+    /**
+     * Optional block-specific source-patch handlers, generalizing bespoke ops
+     * like `update-custom-html`. Keyed by op name; the registry dispatches a
+     * matching patch op here. Generic ops (`update-block` shallow-merge) need none.
+     */
+    patches?: Record<string, (data: TData, op: Record<string, unknown>) => TData>;
+}
+/** Identity helper for authoring a spec with full type inference. */
+export declare function defineBlock<TData>(spec: BlockSpec<TData>): BlockSpec<TData>;
+//# sourceMappingURL=types.d.ts.map

package/dist/client/blocks/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/blocks/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AAEH,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,EAAE,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACxC,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC;IAClD,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACjD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC,CAAC;IACnE;;;;OAIG;IACH,SAAS,EAAE,CAAC,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC;IAC/D;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,KAAK,GAAG,MAAM,CAAC;IACrC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;IAC5C,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;CAC9E;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,OAAO,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACxB,6CAA6C;IAC7C,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC1D,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACpE,iDAAiD;IACjD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,oEAAoE;IACpE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,mEAAmE;IACnE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IACvD;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE;QAC7B,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;QACjC,QAAQ,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,KAAK,KAAK,CAAC,SAAS,CAAC;IACtB;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE;QACpB,KAAK,EAAE,WAAW,CAAC;QACnB,kEAAkE;QAClE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;QACvC,oDAAoD;QACpD,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,mEAAmE;QACnE,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,KAAK,KAAK,CAAC,SAAS,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc,CAAC,KAAK;IACnC,IAAI,EAAE,KAAK,CAAC;IACZ,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,GAAG,EAAE,kBAAkB,CAAC;CACzB;AAED,MAAM,WAAW,SAAS,CAAC,KAAK,GAAG,OAAO;IACxC,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,6BAA6B;IAC7B,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3B,gFAAgF;IAChF,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACjC,8DAA8D;IAC9D,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,IAAI,CAAC,EAAE,EAAE,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;IACpB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC;CAC/E;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAE3E"}

package/dist/client/blocks/types.js

@@ -0,0 +1,5 @@
+/** Identity helper for authoring a spec with full type inference. */
+export function defineBlock(spec) {
+    return spec;
+}
+//# sourceMappingURL=types.js.map

package/dist/client/blocks/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/client/blocks/types.ts"],"names":[],"mappings":"AAwNA,qEAAqE;AACrE,MAAM,UAAU,WAAW,CAAQ,IAAsB;IACvD,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["import type { FC } from \"react\";\nimport type { ZodType } from \"zod\";\n\n/**\n * Block-registry contract. A `BlockSpec` describes one document block end to end:\n * its data shape (`schema`), how it round-trips to MDX source (`mdx`), how it\n * renders read-only (`Read`) and how it is edited (`Edit`, or an auto-generated\n * schema-driven editor when omitted), where it can be placed (`placement`), and\n * metadata for menus / agent schema export.\n *\n * The registry runs ALONGSIDE existing per-block code (the plan `PlanBlockView`\n * switch + `serializeBlock`/`parseBlock`). Renderers check the registry first;\n * unregistered block types fall through to the legacy code path unchanged. The\n * MDX `tag` and attribute shape for a converted block MUST match the historical\n * encoding (e.g. `<Callout tone>…body…</Callout>`) so stored `.mdx` files still\n * parse byte-compatibly.\n */\n\n/** Where a block can be placed in a document. */\nexport type BlockPlacement = \"block\" | \"inline\";\n\n/**\n * A serialized MDX/NFM attribute value before the shared `prop()` encoder runs.\n * `prop()` decides string-vs-JSON encoding; this is just the value domain.\n */\nexport type MdxAttrValue =\n  | string\n  | number\n  | boolean\n  | unknown[]\n  | Record<string, unknown>;\n\n/**\n * Type-narrowed reader over the resolved MDX attributes of a parsed block node.\n * The values are already estree/JSON-resolved by the shared attribute reader\n * (the same engine `plan-mdx.ts` uses), so a spec's `fromAttrs` never touches\n * the AST directly.\n */\nexport interface BlockAttrReader {\n  string(name: string): string | undefined;\n  number(name: string): number | undefined;\n  bool(name: string): boolean | undefined;\n  array<T = unknown>(name: string): T[] | undefined;\n  object<T = unknown>(name: string): T | undefined;\n  raw(name: string): unknown;\n}\n\n/**\n * Maps a block's validated data to/from its MDX component representation.\n * `tag` is the JSX component name in source (e.g. \"Callout\"). It MUST match the\n * historical name in `plan-mdx.ts` `BLOCK_COMPONENTS` / stored `.mdx` files or\n * existing plans break.\n */\nexport interface BlockMdxConfig<TData> {\n  /** JSX component name in MDX source. Stable contract — never rename. */\n  tag: string;\n  /**\n   * Encode `data` → a flat attribute bag. The registry serializer runs each\n   * value through the shared `prop()` encoder (string-vs-JSON heuristic) and\n   * preserves insertion order, so write the keys in the exact historical order.\n   * Return `undefined` for a key (or omit it) to drop the attribute. When\n   * `childrenField` is set, that field is excluded from the attribute bag.\n   */\n  toAttrs: (data: TData) => Record<string, MdxAttrValue | undefined>;\n  /**\n   * Decode resolved attributes (+ optional children markdown) → data. Must\n   * tolerate missing/partial attributes for backward-compat (mirror today's\n   * `?? []` / `?? \"\"` defaults).\n   */\n  fromAttrs: (attrs: BlockAttrReader, children: string) => TData;\n  /**\n   * When set, this data field is a markdown string serialized as MDX *children*\n   * between the open/close tags (prose-bearing blocks: rich-text, callout)\n   * rather than as a prop — so the body survives as real, inline-editable MDX\n   * prose in source.\n   */\n  childrenField?: keyof TData & string;\n  /**\n   * Opt-in custom children serializer for blocks whose internals are nested MDX\n   * components rather than a single markdown string (e.g. wireframe → Screen/kit\n   * primitives). When present it overrides `childrenField`. `serializeChildren`\n   * returns the raw inner MDX; `parseChildren` receives the child MDX AST nodes.\n   */\n  serializeChildren?: (data: TData) => string;\n  parseChildren?: (childNodes: unknown[], idContext: string) => Partial<TData>;\n}\n\n/**\n * App-injected capabilities. Core blocks stay app-agnostic by taking these\n * rather than importing app services — mirroring `createImageExtension`'s\n * `onImageUpload` injection. Provided via `BlockRegistryProvider`.\n */\nexport interface BlockRenderContext {\n  /** Markdown dialect for the auto-editor's rich-text field. */\n  dialect?: \"gfm\" | \"nfm\";\n  /** Resolve an asset id → displayable URL. */\n  resolveAssetSrc?: (assetId: string) => string | undefined;\n  /** Open the shared asset picker (returns the chosen asset). */\n  pickAsset?: () => Promise<{ assetId: string; url?: string } | null>;\n  /** Upload a local file, returns a hosted URL. */\n  uploadFile?: (file: File) => Promise<{ url: string; assetId?: string }>;\n  /** Call an app action by name (for blocks that fetch live data). */\n  callAction?: (name: string, args: unknown) => Promise<unknown>;\n  /** Sanitizer for HTML-bearing blocks. Provided by the app/core. */\n  sanitizeHtml?: (html: string, css?: string) => string;\n  /**\n   * Render a markdown string with the app's read-only markdown renderer. Lets a\n   * core block (whose `Read` lives in core) defer prose rendering to the app's\n   * markdown reader (e.g. the plan `PlanMarkdownReader`) without importing it.\n   */\n  renderMarkdown?: (markdown: string) => React.ReactNode;\n  /**\n   * Render an inline, editable rich-markdown field. The auto-editor calls this\n   * for a `markdown()`-tagged field so the app owns the editor wiring (collab,\n   * autosave debounce, dialect) rather than core hardcoding it.\n   */\n  renderMarkdownEditor?: (props: {\n    value: string;\n    onChange: (next: string) => void;\n    editable: boolean;\n    blockId?: string;\n  }) => React.ReactNode;\n  /**\n   * Render a nested child block through the app's own block dispatcher. Container\n   * blocks whose `Read`/`Edit` live in core (e.g. tabs) call this to render each\n   * child so the recursion keeps flowing through the SAME app renderer the\n   * top-level document uses — registered children render via their spec, and\n   * unregistered (not-yet-converted) children still fall through the app's legacy\n   * switch. This is the coexistence seam: a core container never has to know\n   * about app-specific child block types. Returns `null`/`undefined` when no\n   * dispatcher is wired (read-only/SSR-only contexts can omit it).\n   */\n  renderBlock?: (props: {\n    block: NestedBlock;\n    /** Commit a replacement for this child block (edit mode only). */\n    onChange?: (next: NestedBlock) => void;\n    /** Whether the parent container is being edited. */\n    editing?: boolean;\n    /** Tighten embedded visuals in dense contexts (e.g. tab panes). */\n    compactVisuals?: boolean;\n  }) => React.ReactNode;\n}\n\n/**\n * The minimal shape of a nested child block passed to {@link\n * BlockRenderContext.renderBlock}. It mirrors the app's block union loosely (the\n * app casts it back to its own block type) — a discriminating `type`, a stable\n * `id`, optional heading/summary, and the type-specific `data`.\n */\nexport interface NestedBlock {\n  type: string;\n  id: string;\n  title?: string;\n  summary?: string;\n  data: unknown;\n  [key: string]: unknown;\n}\n\n/** Props passed to a block's read-only renderer. */\nexport interface BlockReadProps<TData> {\n  data: TData;\n  /** Stable block id (for anchors, comment targeting, source patches). */\n  blockId: string;\n  /** Block heading, when present. */\n  title?: string;\n  /** Block trailing summary, when present. */\n  summary?: string;\n  /** Injected app capabilities. */\n  ctx: BlockRenderContext;\n}\n\n/** Props passed to a block's editor (custom or schema-generated). */\nexport interface BlockEditProps<TData> {\n  data: TData;\n  onChange: (next: TData) => void;\n  editable: boolean;\n  blockId: string;\n  title?: string;\n  summary?: string;\n  /** Injected app capabilities. */\n  ctx: BlockRenderContext;\n}\n\nexport interface BlockSpec<TData = unknown> {\n  /** Discriminator. Equals the runtime block `type`. */\n  type: string;\n  /** Zod schema for `data`. Drives validation AND the schema-auto-editor. */\n  schema: ZodType<TData>;\n  /** MDX round-trip config. */\n  mdx: BlockMdxConfig<TData>;\n  /** Read-only renderer (replaces a `PlanBlockView` switch branch / NodeView). */\n  Read: FC<BlockReadProps<TData>>;\n  /**\n   * Optional editor. When omitted, the registry renders the schema-driven\n   * `SchemaBlockEditor` generated from `schema`. Supply for full control\n   * (wireframe canvas, diagram editor).\n   */\n  Edit?: FC<BlockEditProps<TData>>;\n  /** Allowed placements: `[\"block\"]`, `[\"inline\"]`, or both. */\n  placement: BlockPlacement[];\n  /** Human label for menus + agent schema export. */\n  label: string;\n  /** Tabler icon component for UI menus (never emoji/robot/sparkle). */\n  icon?: FC<{ size?: number; className?: string }>;\n  /** One-line description for the agent schema export. */\n  description: string;\n  /** Optional default `data` factory for slash-menu insertion (an empty block). */\n  empty?: () => TData;\n  /**\n   * Optional block-specific source-patch handlers, generalizing bespoke ops\n   * like `update-custom-html`. Keyed by op name; the registry dispatches a\n   * matching patch op here. Generic ops (`update-block` shallow-merge) need none.\n   */\n  patches?: Record<string, (data: TData, op: Record<string, unknown>) => TData>;\n}\n\n/** Identity helper for authoring a spec with full type inference. */\nexport function defineBlock<TData>(spec: BlockSpec<TData>): BlockSpec<TData> {\n  return spec;\n}\n"]}

package/dist/client/composer/ComposerPlusMenu.js

@@ -461,9 +461,14 @@ function ComposerPlusMenuFull({ onSelectMode, }) {
 }
 function AssetsPickerModal({ open, onOpenChange, }) {
     const iframeRef = useRef(null);
+    const [pickerReady, setPickerReady] = useState(false);
     const sourceUrl = useMemo(() => assetPickerUrl(), []);
     const iframeUrl = useMemo(() => withEmbeddedParams(sourceUrl), [sourceUrl]);
     const targetOrigin = useMemo(() => assetPickerOrigin(iframeUrl), [iframeUrl]);
+    useEffect(() => {
+        if (open)
+            setPickerReady(false);
+    }, [iframeUrl, open]);
     useEffect(() => {
         if (!open || !targetOrigin)
             return;
@@ -475,6 +480,7 @@ function AssetsPickerModal({ open, onOpenChange, }) {
             if (!isEmbedEnvelope(event.data))
                 return;
             if (event.data.type === "ready") {
+                setPickerReady(true);
                 iframeRef.current?.contentWindow?.postMessage(embedEnvelope("message", {
                     name: "configure",
                     payload: { mediaType: "image", count: 3 },
@@ -520,6 +526,9 @@ function AssetsPickerModal({ open, onOpenChange, }) {
     return createPortal(_jsx("div", { className: "fixed inset-0 z-[280] flex items-center justify-center bg-black/50 p-3", role: "dialog", "aria-modal": "true", "aria-labelledby": "composer-assets-picker-title", onMouseDown: (event) => {
             if (event.target === event.currentTarget)
                 onOpenChange(false);
-        }, children: _jsxs("div", { className: "flex h-[min(86vh,760px)] w-[min(96vw,1040px)] flex-col overflow-hidden rounded-xl border border-border bg-background shadow-2xl", children: [_jsxs("div", { className: "flex h-12 shrink-0 items-center justify-between border-b border-border px-4", children: [_jsx("div", { id: "composer-assets-picker-title", className: "text-sm font-medium text-foreground", children: "Generate image" }), _jsx("button", { type: "button", onClick: () => onOpenChange(false), className: "flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", "aria-label": "Close image picker", children: _jsx(IconX, { className: "h-4 w-4" }) })] }), targetOrigin ? (_jsx("iframe", { ref: iframeRef, src: iframeUrl, title: "Assets image picker", className: "min-h-0 flex-1 border-0 bg-background", sandbox: "allow-scripts allow-same-origin allow-forms allow-popups allow-downloads", allow: "clipboard-read; clipboard-write; microphone; fullscreen", referrerPolicy: "strict-origin-when-cross-origin" })) : (_jsx("div", { className: "flex min-h-0 flex-1 items-center justify-center p-8 text-center text-sm text-muted-foreground", children: "The configured image picker URL is not valid." }))] }) }), document.body);
+        }, children: _jsxs("div", { className: "flex h-[min(86vh,760px)] w-[min(96vw,1040px)] flex-col overflow-hidden rounded-xl border border-border bg-background shadow-2xl", children: [_jsxs("div", { className: "flex h-12 shrink-0 items-center justify-between border-b border-border px-4", children: [_jsx("div", { id: "composer-assets-picker-title", className: "text-sm font-medium text-foreground", children: "Generate image" }), _jsx("button", { type: "button", onClick: () => onOpenChange(false), className: "flex h-8 w-8 items-center justify-center rounded-md text-muted-foreground hover:bg-accent hover:text-foreground", "aria-label": "Close image picker", children: _jsx(IconX, { className: "h-4 w-4" }) })] }), targetOrigin ? (_jsxs("div", { className: "relative min-h-0 flex-1 overflow-hidden bg-background", children: [!pickerReady && _jsx(AssetsPickerLoadingSkeleton, {}), _jsx("iframe", { ref: iframeRef, src: iframeUrl, title: "Assets image picker", className: cn("absolute inset-0 h-full w-full border-0 bg-background transition-opacity duration-150", pickerReady ? "opacity-100" : "pointer-events-none opacity-0"), sandbox: "allow-scripts allow-same-origin allow-forms allow-popups allow-downloads", allow: "clipboard-read; clipboard-write; microphone; fullscreen", referrerPolicy: "strict-origin-when-cross-origin" })] })) : (_jsx("div", { className: "flex min-h-0 flex-1 items-center justify-center p-8 text-center text-sm text-muted-foreground", children: "The configured image picker URL is not valid." }))] }) }), document.body);
+}
+function AssetsPickerLoadingSkeleton() {
+    return (_jsxs("div", { className: "absolute inset-0 flex flex-col gap-5 p-5", role: "status", "aria-label": "Loading Assets picker", children: [_jsxs("div", { className: "flex items-center gap-3", children: [_jsx("div", { className: "h-9 flex-1 animate-pulse rounded-md bg-muted" }), _jsx("div", { className: "h-9 w-24 animate-pulse rounded-md bg-muted" })] }), _jsx("div", { className: "grid min-h-0 flex-1 grid-cols-2 gap-4 sm:grid-cols-3 lg:grid-cols-4", children: Array.from({ length: 8 }).map((_, index) => (_jsxs("div", { className: "flex min-w-0 flex-col gap-2", children: [_jsx("div", { className: "aspect-square w-full animate-pulse rounded-lg bg-muted" }), _jsx("div", { className: "h-3 w-3/4 animate-pulse rounded bg-muted" }), _jsx("div", { className: "h-3 w-1/2 animate-pulse rounded bg-muted" })] }, index))) })] }));
 }
 //# sourceMappingURL=ComposerPlusMenu.js.map