@agent-native/core 0.41.1 → 0.43.0

package/dist/client/blocks/library/diff.config.js

@@ -1,18 +1,40 @@
 import { z } from "zod";
+/**
+ * A 1-based line reference: `"3"` or `"3-5"` (inclusive). Whitespace tolerant.
+ * Matches the `annotated-code` line-ref schema so both blocks validate refs
+ * identically.
+ */
+const lineRefSchema = z
+    .string()
+    .trim()
+    .regex(/^\d+(\s*-\s*\d+)?$/, {
+    message: 'lines must be a 1-based line ref like "3" or "3-5"',
+})
+    .max(40);
+const diffAnnotationSchema = z.object({
+    side: z.enum(["before", "after"]).optional(),
+    lines: lineRefSchema,
+    label: z.string().trim().max(160).optional(),
+    note: z.string().trim().min(1).max(4_000),
+});
 export const diffSchema = z.object({
     filename: z.string().trim().max(400).optional(),
     language: z.string().trim().max(40).optional(),
     before: z.string().max(100_000),
     after: z.string().max(100_000),
     mode: z.enum(["unified", "split"]).optional(),
+    annotations: z.array(diffAnnotationSchema).max(80).optional(),
 });
 /**
- * MDX config: `filename`, `language`, `mode`, `before`, and `after` are flat
- * attributes — the `<Diff id … filename language mode before after />`
- * self-closing form. Insertion order of `toAttrs` is the on-disk attribute order.
- * `fromAttrs` mirrors a forgiving parse (`before ?? ""`, `after ?? ""`, optional
- * `filename`/`language`/`mode` undefined when absent) so a plan missing an
- * attribute still parses.
+ * MDX config: `filename`, `language`, `mode`, `before`, `after`, and
+ * `annotations` are flat attributes — the
+ * `<Diff id … filename language mode before after annotations />` self-closing
+ * form. Insertion order of `toAttrs` is the on-disk attribute order. `before`/
+ * `after` are multiline string attributes (round-trip through the shared `prop()`
+ * encoder); `annotations` is a JSON array attribute, encoded the same way as the
+ * `annotated-code` block. `fromAttrs` mirrors a forgiving parse (`before ?? ""`,
+ * `after ?? ""`, `annotations ?? []`, optional `filename`/`language`/`mode`
+ * undefined when absent) so a plan missing an attribute still parses.
  */
 export const diffMdx = {
     tag: "Diff",
@@ -22,6 +44,7 @@ export const diffMdx = {
         mode: data.mode,
         before: data.before,
         after: data.after,
+        annotations: data.annotations,
     }),
     fromAttrs: (attrs) => ({
         filename: attrs.string("filename"),
@@ -29,6 +52,7 @@ export const diffMdx = {
         mode: attrs.string("mode"),
         before: attrs.string("before") ?? "",
         after: attrs.string("after") ?? "",
+        annotations: attrs.array("annotations") ?? [],
     }),
 };
 //# sourceMappingURL=diff.config.js.map

package/dist/client/blocks/library/diff.config.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/diff.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkCxB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC9C,CAAmC,CAAC;AAErC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,OAAO,GAA6B;IAC/C,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC;IACF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QAClC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAyB;QAClD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACpC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;KACnC,CAAC;CACH,CAAC","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC diff block: its data schema and MDX\n * round-trip config. Shared by the server MDX adapter (`plan-mdx.ts` via\n * `plan-block-registry.ts`) and the client spec (`planBlocks.tsx`). Keeping this\n * React-free means importing it into a server module never pulls React (or the\n * `diff` line-differ used only by the renderer) into the Nitro/SSR bundle.\n *\n * The schema MUST stay data-compatible with the `diff` branch of `planBlockSchema`\n * (`plan-content.ts`), and the MDX `tag` + flat attribute shape MUST match the\n * `<Diff filename language mode before after />` self-closing encoding so stored\n * `.mdx` round-trips. The `before`/`after` source lives in ATTRIBUTES (not MDX\n * children) — the shared `prop()` encoder round-trips multiline strings cleanly,\n * and keeping them attributes avoids the code being reflowed as prose.\n */\n\n/** Rendering layout for the diff body. */\nexport type DiffMode = \"unified\" | \"split\";\n\nexport interface DiffData {\n  /** Optional file path shown in the header (e.g. `src/add.ts`). */\n  filename?: string;\n  /** Optional language label rendered as a chip (e.g. `ts`). Purely cosmetic. */\n  language?: string;\n  /** Original (\"before\") source. */\n  before: string;\n  /** New (\"after\") source. */\n  after: string;\n  /** Layout: unified (default, one column) or split (side-by-side). */\n  mode?: DiffMode;\n}\n\nexport const diffSchema = z.object({\n  filename: z.string().trim().max(400).optional(),\n  language: z.string().trim().max(40).optional(),\n  before: z.string().max(100_000),\n  after: z.string().max(100_000),\n  mode: z.enum([\"unified\", \"split\"]).optional(),\n}) as unknown as z.ZodType<DiffData>;\n\n/**\n * MDX config: `filename`, `language`, `mode`, `before`, and `after` are flat\n * attributes — the `<Diff id … filename language mode before after />`\n * self-closing form. Insertion order of `toAttrs` is the on-disk attribute order.\n * `fromAttrs` mirrors a forgiving parse (`before ?? \"\"`, `after ?? \"\"`, optional\n * `filename`/`language`/`mode` undefined when absent) so a plan missing an\n * attribute still parses.\n */\nexport const diffMdx: BlockMdxConfig<DiffData> = {\n  tag: \"Diff\",\n  toAttrs: (data) => ({\n    filename: data.filename,\n    language: data.language,\n    mode: data.mode,\n    before: data.before,\n    after: data.after,\n  }),\n  fromAttrs: (attrs) => ({\n    filename: attrs.string(\"filename\"),\n    language: attrs.string(\"language\"),\n    mode: attrs.string(\"mode\") as DiffMode | undefined,\n    before: attrs.string(\"before\") ?? \"\",\n    after: attrs.string(\"after\") ?? \"\",\n  }),\n};\n"]}
+{"version":3,"file":"diff.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/diff.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAsDxB;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC;KACpB,MAAM,EAAE;KACR,IAAI,EAAE;KACN,KAAK,CAAC,oBAAoB,EAAE;IAC3B,OAAO,EAAE,oDAAoD;CAC9D,CAAC;KACD,GAAG,CAAC,EAAE,CAAC,CAAC;AAEX,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;CAC1C,CAA8B,CAAC;AAEhC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAC/B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC9D,CAAmC,CAAC;AAErC;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,OAAO,GAA6B;IAC/C,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IACF,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACrB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QAClC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAyB;QAClD,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE;QACpC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE;QAClC,WAAW,EAAE,KAAK,CAAC,KAAK,CAAiB,aAAa,CAAC,IAAI,EAAE;KAC9D,CAAC;CACH,CAAC","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the PLAN-SPECIFIC diff block: its data schema and MDX\n * round-trip config. Shared by the server MDX adapter (`plan-mdx.ts` via\n * `plan-block-registry.ts`) and the client spec (`planBlocks.tsx`). Keeping this\n * React-free means importing it into a server module never pulls React (or the\n * `diff` line-differ used only by the renderer) into the Nitro/SSR bundle.\n *\n * The schema MUST stay data-compatible with the `diff` branch of `planBlockSchema`\n * (`plan-content.ts`), and the MDX `tag` + flat attribute shape MUST match the\n * `<Diff filename language mode before after />` self-closing encoding so stored\n * `.mdx` round-trips. The `before`/`after` source lives in ATTRIBUTES (not MDX\n * children) — the shared `prop()` encoder round-trips multiline strings cleanly,\n * and keeping them attributes avoids the code being reflowed as prose.\n */\n\n/** Rendering layout for the diff body. */\nexport type DiffMode = \"unified\" | \"split\";\n\n/**\n * One line-anchored note attached to a diff, mirroring the `annotated-code`\n * annotation shape but adding `side`. The `lines` ref is 1-based against the\n * chosen side's source: `side: \"after\"` (the default) targets the new file's\n * line numbers, `side: \"before\"` the old file's. Optional ⇒ a diff without\n * annotations renders exactly as before.\n */\nexport interface DiffAnnotation {\n  /** Which side the line ref targets; defaults to \"after\". */\n  side?: \"before\" | \"after\";\n  /** 1-based line ref against that side's text: \"13\" or \"13-15\" (inclusive). */\n  lines: string;\n  /** Optional short label shown before the note (e.g. \"Validation\"). */\n  label?: string;\n  /** The note prose (markdown), rendered through `ctx.renderMarkdown`. */\n  note: string;\n}\n\nexport interface DiffData {\n  /** Optional file path shown in the header (e.g. `src/add.ts`). */\n  filename?: string;\n  /** Optional language label rendered as a chip (e.g. `ts`). Purely cosmetic. */\n  language?: string;\n  /** Original (\"before\") source. */\n  before: string;\n  /** New (\"after\") source. */\n  after: string;\n  /** Layout: unified (default, one column) or split (side-by-side). */\n  mode?: DiffMode;\n  /** Line-anchored notes over the before/after sides. */\n  annotations?: DiffAnnotation[];\n}\n\n/**\n * A 1-based line reference: `\"3\"` or `\"3-5\"` (inclusive). Whitespace tolerant.\n * Matches the `annotated-code` line-ref schema so both blocks validate refs\n * identically.\n */\nconst lineRefSchema = z\n  .string()\n  .trim()\n  .regex(/^\\d+(\\s*-\\s*\\d+)?$/, {\n    message: 'lines must be a 1-based line ref like \"3\" or \"3-5\"',\n  })\n  .max(40);\n\nconst diffAnnotationSchema = z.object({\n  side: z.enum([\"before\", \"after\"]).optional(),\n  lines: lineRefSchema,\n  label: z.string().trim().max(160).optional(),\n  note: z.string().trim().min(1).max(4_000),\n}) as z.ZodType<DiffAnnotation>;\n\nexport const diffSchema = z.object({\n  filename: z.string().trim().max(400).optional(),\n  language: z.string().trim().max(40).optional(),\n  before: z.string().max(100_000),\n  after: z.string().max(100_000),\n  mode: z.enum([\"unified\", \"split\"]).optional(),\n  annotations: z.array(diffAnnotationSchema).max(80).optional(),\n}) as unknown as z.ZodType<DiffData>;\n\n/**\n * MDX config: `filename`, `language`, `mode`, `before`, `after`, and\n * `annotations` are flat attributes — the\n * `<Diff id … filename language mode before after annotations />` self-closing\n * form. Insertion order of `toAttrs` is the on-disk attribute order. `before`/\n * `after` are multiline string attributes (round-trip through the shared `prop()`\n * encoder); `annotations` is a JSON array attribute, encoded the same way as the\n * `annotated-code` block. `fromAttrs` mirrors a forgiving parse (`before ?? \"\"`,\n * `after ?? \"\"`, `annotations ?? []`, optional `filename`/`language`/`mode`\n * undefined when absent) so a plan missing an attribute still parses.\n */\nexport const diffMdx: BlockMdxConfig<DiffData> = {\n  tag: \"Diff\",\n  toAttrs: (data) => ({\n    filename: data.filename,\n    language: data.language,\n    mode: data.mode,\n    before: data.before,\n    after: data.after,\n    annotations: data.annotations,\n  }),\n  fromAttrs: (attrs) => ({\n    filename: attrs.string(\"filename\"),\n    language: attrs.string(\"language\"),\n    mode: attrs.string(\"mode\") as DiffMode | undefined,\n    before: attrs.string(\"before\") ?? \"\",\n    after: attrs.string(\"after\") ?? \"\",\n    annotations: attrs.array<DiffAnnotation>(\"annotations\") ?? [],\n  }),\n};\n"]}

package/dist/client/blocks/library/question-form.config.d.ts

@@ -0,0 +1,69 @@
+import { z } from "zod";
+import type { BlockMdxConfig } from "../types.js";
+/**
+ * Pure (React-free) part of the shared `question-form` and `visual-questions`
+ * blocks: their data schema and MDX round-trip config. Lives in core so any
+ * app's server/shared registry and the client spec (`question-form.tsx`)
+ * consume one definition. Keeping it React-free means importing it into a server
+ * module never pulls React into the Nitro/SSR bundle.
+ *
+ * `question-form` is the general-purpose respondent-facing form (Open Questions,
+ * single/multi/freeform answers, recommended options, optional inline
+ * wireframe/diagram previews). `visual-questions` is the same data shape and UI,
+ * branded for an explicit visual-intake flow before a plan. Both originated in
+ * the plan template (the data shape mirrors the legacy `visual-questions` block)
+ * before moving here, so their MDX `tag` + attribute encoding MUST match the
+ * historical `<QuestionForm questions submitLabel />` / `<VisualQuestions … />`
+ * forms so stored `.mdx` round-trips byte-compatibly.
+ *
+ * The per-option `wireframe`/`diagram` previews stay opaque (`unknown`) at the
+ * core layer: the core block renders them through `ctx.renderBlock` (the same
+ * nested-block seam tabs/columns use) so core never imports an app's wireframe
+ * or diagram renderer. Each app supplies the matching `wireframe`/`diagram`
+ * block spec and shape.
+ */
+export type QuestionMode = "single" | "multi" | "freeform";
+export interface QuestionFormOption {
+    id: string;
+    label: string;
+    detail?: string;
+    /** Authored recommendation only (not a runtime answer). */
+    recommended?: boolean;
+    /**
+     * Optional inline visual previews for this option. Kept opaque at the core
+     * layer; rendered via `ctx.renderBlock` as a nested `wireframe`/`diagram`
+     * block so core stays app-agnostic. Apps validate the concrete shape with
+     * their own wireframe/diagram schemas.
+     */
+    wireframe?: unknown;
+    diagram?: unknown;
+}
+export interface QuestionFormQuestion {
+    id: string;
+    title: string;
+    subtitle?: string;
+    mode: QuestionMode;
+    options?: QuestionFormOption[];
+    allowOther?: boolean;
+    placeholder?: string;
+    required?: boolean;
+}
+export interface QuestionFormData {
+    questions: QuestionFormQuestion[];
+    submitLabel?: string;
+}
+/** `visual-questions` shares the exact `question-form` data shape. */
+export type VisualQuestionsData = QuestionFormData;
+export declare const questionFormSchema: z.ZodType<QuestionFormData>;
+/** `visual-questions` validates with the same schema as `question-form`. */
+export declare const visualQuestionsSchema: z.ZodType<VisualQuestionsData>;
+/**
+ * MDX config: `questions` and `submitLabel` are both attributes (the questions
+ * array is JSON-encoded by the shared `prop()` encoder). Mirrors the legacy
+ * `<QuestionForm questions={[…]} submitLabel="…" />` encoding so stored `.mdx`
+ * round-trips byte-compatibly.
+ */
+export declare const questionFormMdx: BlockMdxConfig<QuestionFormData>;
+/** `visual-questions` uses the historical `<VisualQuestions … />` tag. */
+export declare const visualQuestionsMdx: BlockMdxConfig<VisualQuestionsData>;
+//# sourceMappingURL=question-form.config.d.ts.map

package/dist/client/blocks/library/question-form.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-form.config.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/question-form.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2DAA2D;IAC3D,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,oBAAoB,EAAE,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,sEAAsE;AACtE,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,CAAC;AA0BnD,eAAO,MAAM,kBAAkB,EAGd,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAE7C,4EAA4E;AAC5E,eAAO,MAAM,qBAAqB,EACC,CAAC,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElE;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,cAAc,CAAC,gBAAgB,CAU5D,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,EAAE,cAAc,CAAC,mBAAmB,CAUlE,CAAC"}

package/dist/client/blocks/library/question-form.config.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+const idSchema = z.string().trim().min(1).max(120);
+const questionOptionSchema = z.object({
+    id: idSchema,
+    label: z.string().trim().min(1).max(220),
+    detail: z.string().trim().max(800).optional(),
+    recommended: z.boolean().optional(),
+    // Opaque at the core layer — the inline preview renders via `ctx.renderBlock`
+    // with the app's own wireframe/diagram block spec; the app validates the shape.
+    wireframe: z.unknown().optional(),
+    diagram: z.unknown().optional(),
+});
+const questionSchema = z.object({
+    id: idSchema,
+    title: z.string().trim().min(1).max(260),
+    subtitle: z.string().trim().max(700).optional(),
+    mode: z.enum(["single", "multi", "freeform"]),
+    options: z.array(questionOptionSchema).max(40).optional(),
+    allowOther: z.boolean().optional(),
+    placeholder: z.string().trim().max(240).optional(),
+    required: z.boolean().optional(),
+});
+export const questionFormSchema = z.object({
+    questions: z.array(questionSchema).min(1).max(40),
+    submitLabel: z.string().trim().max(80).optional(),
+});
+/** `visual-questions` validates with the same schema as `question-form`. */
+export const visualQuestionsSchema = questionFormSchema;
+/**
+ * MDX config: `questions` and `submitLabel` are both attributes (the questions
+ * array is JSON-encoded by the shared `prop()` encoder). Mirrors the legacy
+ * `<QuestionForm questions={[…]} submitLabel="…" />` encoding so stored `.mdx`
+ * round-trips byte-compatibly.
+ */
+export const questionFormMdx = {
+    tag: "QuestionForm",
+    toAttrs: (data) => ({
+        questions: data.questions,
+        submitLabel: data.submitLabel,
+    }),
+    fromAttrs: (attrs) => ({
+        questions: attrs.array("questions") ?? [],
+        submitLabel: attrs.string("submitLabel"),
+    }),
+};
+/** `visual-questions` uses the historical `<VisualQuestions … />` tag. */
+export const visualQuestionsMdx = {
+    tag: "VisualQuestions",
+    toAttrs: (data) => ({
+        questions: data.questions,
+        submitLabel: data.submitLabel,
+    }),
+    fromAttrs: (attrs) => ({
+        questions: attrs.array("questions") ?? [],
+        submitLabel: attrs.string("submitLabel"),
+    }),
+};
+//# sourceMappingURL=question-form.config.js.map

package/dist/client/blocks/library/question-form.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-form.config.js","sourceRoot":"","sources":["../../../../src/client/blocks/library/question-form.config.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport type { BlockMdxConfig } from \"../types.js\";\n\n/**\n * Pure (React-free) part of the shared `question-form` and `visual-questions`\n * blocks: their data schema and MDX round-trip config. Lives in core so any\n * app's server/shared registry and the client spec (`question-form.tsx`)\n * consume one definition. Keeping it React-free means importing it into a server\n * module never pulls React into the Nitro/SSR bundle.\n *\n * `question-form` is the general-purpose respondent-facing form (Open Questions,\n * single/multi/freeform answers, recommended options, optional inline\n * wireframe/diagram previews). `visual-questions` is the same data shape and UI,\n * branded for an explicit visual-intake flow before a plan. Both originated in\n * the plan template (the data shape mirrors the legacy `visual-questions` block)\n * before moving here, so their MDX `tag` + attribute encoding MUST match the\n * historical `<QuestionForm questions submitLabel />` / `<VisualQuestions … />`\n * forms so stored `.mdx` round-trips byte-compatibly.\n *\n * The per-option `wireframe`/`diagram` previews stay opaque (`unknown`) at the\n * core layer: the core block renders them through `ctx.renderBlock` (the same\n * nested-block seam tabs/columns use) so core never imports an app's wireframe\n * or diagram renderer. Each app supplies the matching `wireframe`/`diagram`\n * block spec and shape.\n */\n\nexport type QuestionMode = \"single\" | \"multi\" | \"freeform\";\n\nexport interface QuestionFormOption {\n  id: string;\n  label: string;\n  detail?: string;\n  /** Authored recommendation only (not a runtime answer). */\n  recommended?: boolean;\n  /**\n   * Optional inline visual previews for this option. Kept opaque at the core\n   * layer; rendered via `ctx.renderBlock` as a nested `wireframe`/`diagram`\n   * block so core stays app-agnostic. Apps validate the concrete shape with\n   * their own wireframe/diagram schemas.\n   */\n  wireframe?: unknown;\n  diagram?: unknown;\n}\n\nexport interface QuestionFormQuestion {\n  id: string;\n  title: string;\n  subtitle?: string;\n  mode: QuestionMode;\n  options?: QuestionFormOption[];\n  allowOther?: boolean;\n  placeholder?: string;\n  required?: boolean;\n}\n\nexport interface QuestionFormData {\n  questions: QuestionFormQuestion[];\n  submitLabel?: string;\n}\n\n/** `visual-questions` shares the exact `question-form` data shape. */\nexport type VisualQuestionsData = QuestionFormData;\n\nconst idSchema = z.string().trim().min(1).max(120);\n\nconst questionOptionSchema = z.object({\n  id: idSchema,\n  label: z.string().trim().min(1).max(220),\n  detail: z.string().trim().max(800).optional(),\n  recommended: z.boolean().optional(),\n  // Opaque at the core layer — the inline preview renders via `ctx.renderBlock`\n  // with the app's own wireframe/diagram block spec; the app validates the shape.\n  wireframe: z.unknown().optional(),\n  diagram: z.unknown().optional(),\n}) as z.ZodType<QuestionFormOption>;\n\nconst questionSchema = z.object({\n  id: idSchema,\n  title: z.string().trim().min(1).max(260),\n  subtitle: z.string().trim().max(700).optional(),\n  mode: z.enum([\"single\", \"multi\", \"freeform\"]),\n  options: z.array(questionOptionSchema).max(40).optional(),\n  allowOther: z.boolean().optional(),\n  placeholder: z.string().trim().max(240).optional(),\n  required: z.boolean().optional(),\n}) as z.ZodType<QuestionFormQuestion>;\n\nexport const questionFormSchema = z.object({\n  questions: z.array(questionSchema).min(1).max(40),\n  submitLabel: z.string().trim().max(80).optional(),\n}) as unknown as z.ZodType<QuestionFormData>;\n\n/** `visual-questions` validates with the same schema as `question-form`. */\nexport const visualQuestionsSchema =\n  questionFormSchema as unknown as z.ZodType<VisualQuestionsData>;\n\n/**\n * MDX config: `questions` and `submitLabel` are both attributes (the questions\n * array is JSON-encoded by the shared `prop()` encoder). Mirrors the legacy\n * `<QuestionForm questions={[…]} submitLabel=\"…\" />` encoding so stored `.mdx`\n * round-trips byte-compatibly.\n */\nexport const questionFormMdx: BlockMdxConfig<QuestionFormData> = {\n  tag: \"QuestionForm\",\n  toAttrs: (data) => ({\n    questions: data.questions,\n    submitLabel: data.submitLabel,\n  }),\n  fromAttrs: (attrs) => ({\n    questions: attrs.array<QuestionFormQuestion>(\"questions\") ?? [],\n    submitLabel: attrs.string(\"submitLabel\"),\n  }),\n};\n\n/** `visual-questions` uses the historical `<VisualQuestions … />` tag. */\nexport const visualQuestionsMdx: BlockMdxConfig<VisualQuestionsData> = {\n  tag: \"VisualQuestions\",\n  toAttrs: (data) => ({\n    questions: data.questions,\n    submitLabel: data.submitLabel,\n  }),\n  fromAttrs: (attrs) => ({\n    questions: attrs.array<QuestionFormQuestion>(\"questions\") ?? [],\n    submitLabel: attrs.string(\"submitLabel\"),\n  }),\n};\n"]}

package/dist/client/blocks/library/question-form.d.ts

@@ -0,0 +1,20 @@
+import type { BlockReadProps, BlockEditProps } from "../types.js";
+import { type QuestionFormData, type VisualQuestionsData } from "./question-form.config.js";
+export declare function QuestionFormRead(props: BlockReadProps<QuestionFormData>): import("react/jsx-runtime").JSX.Element;
+export declare function VisualQuestionsRead(props: BlockReadProps<VisualQuestionsData>): import("react/jsx-runtime").JSX.Element;
+/** Shared editor for both `question-form` and `visual-questions`. */
+export declare function QuestionFormEdit({ data, onChange, editable, }: BlockEditProps<QuestionFormData>): import("react/jsx-runtime").JSX.Element;
+/**
+ * Full client spec for the shared `question-form` block. A respondent-facing
+ * intake form edited from the block panel (the schema-ish question shape lives
+ * behind the edit surface, not inline).
+ */
+export declare const questionFormBlock: import("../types.js").BlockSpec<QuestionFormData>;
+/**
+ * Full client spec for the shared `visual-questions` block — the same form UI
+ * and data shape as `question-form`, branded for explicit visual intake before a
+ * plan. Shares the Read/Edit internals; only the type, MDX tag, label, and seed
+ * differ.
+ */
+export declare const visualQuestionsBlock: import("../types.js").BlockSpec<QuestionFormData>;
+//# sourceMappingURL=question-form.d.ts.map

package/dist/client/blocks/library/question-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-form.d.ts","sourceRoot":"","sources":["../../../../src/client/blocks/library/question-form.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EAGf,MAAM,aAAa,CAAC;AACrB,OAAO,EAKL,KAAK,gBAAgB,EAIrB,KAAK,mBAAmB,EACzB,MAAM,2BAA2B,CAAC;AAoanC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,CAAC,gBAAgB,CAAC,2CAEvE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,CAAC,mBAAmB,CAAC,2CAG3C;AAaD,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,EAC/B,IAAI,EACJ,QAAQ,EACR,QAAQ,GACT,EAAE,cAAc,CAAC,gBAAgB,CAAC,2CAsTlC;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,mDAsB5B,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,mDAmC/B,CAAC"}

package/dist/client/blocks/library/question-form.js

@@ -0,0 +1,286 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+import { IconCheck, IconChevronDown, IconClipboardText, IconPlus, IconSend, IconTrash, } from "@tabler/icons-react";
+import { cn } from "../../utils.js";
+import { defineBlock } from "../types.js";
+import { questionFormSchema, questionFormMdx, visualQuestionsSchema, visualQuestionsMdx, } from "./question-form.config.js";
+function isAnswered(question, answer) {
+    if (question.mode === "freeform")
+        return Boolean(answer?.text?.trim());
+    return Boolean(answer?.selected?.length || answer?.text?.trim());
+}
+/**
+ * Build a readable, agent-ready summary string from the questions + collected
+ * answers. Generic replacement for the plan-specific `summarizeQuestionForm`.
+ */
+function summarizeAnswers(blockId, blockTitle, questions, answers) {
+    const lines = [
+        "Use these question answers to revise the plan:",
+        blockId ? `Question block: ${blockId}` : "",
+        blockTitle ? `Section: ${blockTitle}` : "",
+        "",
+    ].filter((line) => line !== "");
+    for (const question of questions) {
+        const answer = answers[question.id];
+        const selectedLabels = question.options
+            ?.filter((option) => answer?.selected?.includes(option.id))
+            .map((option) => option.label) ?? [];
+        const other = answer?.text?.trim();
+        const value = question.mode === "freeform"
+            ? other
+            : [...selectedLabels, ...(other ? [`Other: ${other}`] : [])].join(", ");
+        lines.push(`- ${question.title}: ${value || "No answer yet"}`);
+    }
+    return lines.join("\n");
+}
+/** Render an inline preview (wireframe or diagram) through the app's dispatcher. */
+function OptionVisual({ type, data, blockId, ctx, }) {
+    if (!data || !ctx.renderBlock)
+        return null;
+    const block = {
+        id: `${blockId}-${type}`,
+        type,
+        data,
+    };
+    return (_jsx(_Fragment, { children: ctx.renderBlock({ block, editing: false, compactVisuals: true }) }));
+}
+function QuestionView({ question, index, answer, blockId, ctx, onAnswer, }) {
+    const selected = answer?.selected ?? [];
+    const hasVisualOptions = Boolean(question.options?.some((option) => option.wireframe || option.diagram));
+    return (_jsxs("article", { className: "grid gap-4 sm:grid-cols-[36px_minmax(0,1fr)]", children: [_jsx("div", { className: "flex size-7 items-center justify-center rounded-full border border-border bg-card text-xs font-semibold text-muted-foreground", children: index + 1 }), _jsxs("div", { children: [_jsx("h3", { className: "text-lg font-semibold leading-7 text-foreground", children: question.title }), question.subtitle && (_jsx("p", { className: "mt-1.5 max-w-3xl text-sm leading-6 text-muted-foreground", children: question.subtitle })), question.mode === "freeform" ? (_jsx("textarea", { value: answer?.text ?? "", onChange: (event) => onAnswer({ text: event.target.value }), className: "mt-4 min-h-28 w-full rounded-xl border border-border bg-card px-3 py-2 text-sm text-foreground outline-none transition-colors placeholder:text-muted-foreground focus-visible:ring-1 focus-visible:ring-ring", "data-plan-interactive": true, placeholder: question.placeholder || "Add details..." })) : (_jsxs("div", { className: cn("mt-4", hasVisualOptions
+                            ? "grid gap-4 md:grid-cols-2"
+                            : "grid max-w-4xl gap-3"), children: [question.options?.map((option) => {
+                                const isSelected = selected.includes(option.id);
+                                return (_jsxs("button", { type: "button", "data-plan-interactive": true, "aria-pressed": isSelected, className: cn(hasVisualOptions
+                                        ? "grid gap-4 rounded-xl border border-border bg-card p-4 text-left transition-colors hover:bg-accent/30"
+                                        : "grid w-full gap-2 rounded-xl border border-border bg-card px-4 py-3 text-left text-foreground transition-colors hover:border-primary/40 hover:bg-accent/30", isSelected && "border-primary/40 bg-primary/10"), onClick: () => {
+                                        if (question.mode === "single") {
+                                            onAnswer({ ...answer, selected: [option.id] });
+                                            return;
+                                        }
+                                        onAnswer({
+                                            ...answer,
+                                            selected: isSelected
+                                                ? selected.filter((id) => id !== option.id)
+                                                : [...selected, option.id],
+                                        });
+                                    }, children: [_jsxs("div", { className: "flex min-w-0 items-start gap-3", children: [_jsx("span", { className: cn("mt-0.5 flex size-5 shrink-0 items-center justify-center border", question.mode === "single" ? "rounded-full" : "rounded", isSelected
+                                                        ? "border-primary bg-primary text-primary-foreground"
+                                                        : "border-border"), children: isSelected && _jsx(IconCheck, { className: "size-3.5" }) }), _jsxs("span", { children: [_jsx("span", { className: "text-base font-semibold leading-6 text-foreground", children: option.label }), option.recommended && (_jsxs(_Fragment, { children: [" ", _jsx("span", { className: "ml-3 rounded-md border border-primary/30 px-2 py-0.5 align-middle text-[11px] font-medium uppercase tracking-[0.12em] text-primary", children: "Recommended" })] })), option.detail && (_jsx("span", { className: "mt-1 block max-w-2xl whitespace-pre-line text-sm font-normal leading-6 text-muted-foreground", children: option.detail }))] })] }), hasVisualOptions && (option.wireframe || option.diagram) && (_jsxs("div", { className: "ml-8 grid gap-4 lg:grid-cols-[minmax(0,1fr)_280px]", children: [option.wireframe != null && (_jsx(OptionVisual, { type: "wireframe", data: option.wireframe, blockId: `${blockId}-${option.id}`, ctx: ctx })), option.diagram != null && (_jsx(OptionVisual, { type: "diagram", data: option.diagram, blockId: `${blockId}-${option.id}`, ctx: ctx }))] }))] }, option.id));
+                            }), question.allowOther !== false && (_jsx("input", { value: answer?.text ?? "", onChange: (event) => onAnswer({ ...answer, text: event.target.value }), className: cn("h-10 w-full rounded-lg border border-border bg-card px-4 text-sm text-foreground outline-none transition-colors placeholder:text-muted-foreground focus-visible:ring-1 focus-visible:ring-ring", hasVisualOptions ? "md:col-span-2" : "sm:w-80"), "data-plan-interactive": true, placeholder: question.placeholder || "Other — type your own answer…" }))] }))] })] }));
+}
+/** The "Send to agent" affordance: a popover (via the app surface) when wired. */
+function SubmitMenu({ blockId, ctx, onSubmit, buildSummary, }) {
+    const [open, setOpen] = useState(false);
+    const trigger = (_jsxs("button", { type: "button", "data-plan-interactive": true, className: "inline-flex h-9 shrink-0 items-center gap-1.5 rounded-md bg-primary px-4 text-sm font-medium text-primary-foreground transition-colors hover:bg-primary/90", children: ["Send to agent", _jsx(IconChevronDown, { className: "size-3.5 opacity-70" })] }));
+    const menu = (_jsxs("div", { className: "grid gap-1", children: [_jsx("div", { className: "px-1 py-1 text-xs font-semibold text-muted-foreground", children: "Send feedback" }), _jsxs("button", { type: "button", "data-plan-interactive": true, disabled: !onSubmit, onClick: () => {
+                    onSubmit?.(buildSummary());
+                    setOpen(false);
+                }, className: "grid grid-cols-[auto_1fr] items-start gap-2 rounded-md px-2 py-2 text-left text-sm text-foreground transition-colors hover:bg-accent disabled:cursor-not-allowed disabled:opacity-50", children: [_jsx(IconSend, { className: "mt-0.5 size-4" }), _jsxs("span", { className: "grid gap-0.5", children: [_jsx("span", { children: "Send to inline agent" }), _jsx("span", { className: "text-xs font-normal leading-4 text-muted-foreground", children: "Posts answered questions into the app side agent." })] })] }), _jsxs("button", { type: "button", "data-plan-interactive": true, onClick: () => {
+                    void navigator.clipboard.writeText(buildSummary());
+                    setOpen(false);
+                }, className: "grid grid-cols-[auto_1fr] items-start gap-2 rounded-md px-2 py-2 text-left text-sm text-foreground transition-colors hover:bg-accent", children: [_jsx(IconClipboardText, { className: "mt-0.5 size-4" }), _jsxs("span", { className: "grid gap-0.5", children: [_jsx("span", { children: "Copy for your agent" }), _jsx("span", { className: "text-xs font-normal leading-4 text-muted-foreground", children: "Copies a prompt you can paste into chat." })] })] })] }));
+    // Prefer the app-provided popover surface (shadcn Popover in plan/content);
+    // core stays shadcn-free. Without a surface, fall back to a single button that
+    // submits directly so the form still works.
+    const surface = ctx.renderEditSurface?.({
+        title: "Send to agent",
+        open,
+        onOpenChange: setOpen,
+        blockId,
+        blockType: "question-form",
+        trigger,
+        children: menu,
+    });
+    if (surface)
+        return _jsx(_Fragment, { children: surface });
+    return (_jsx("button", { type: "button", "data-plan-interactive": true, disabled: !onSubmit, onClick: () => onSubmit?.(buildSummary()), className: "inline-flex h-9 shrink-0 items-center gap-1.5 rounded-md bg-primary px-4 text-sm font-medium text-primary-foreground transition-colors hover:bg-primary/90 disabled:cursor-not-allowed disabled:opacity-50", children: "Send to agent" }));
+}
+/** Shared read renderer for both `question-form` and `visual-questions`. */
+function QuestionFormReadInner({ data, blockId, title, ctx, }) {
+    const questions = data.questions;
+    const [answers, setAnswers] = useState({});
+    const submitCtx = ctx;
+    useEffect(() => {
+        setAnswers({});
+    }, [blockId]);
+    const setAnswer = (questionId, next) => {
+        setAnswers((current) => ({ ...current, [questionId]: next }));
+    };
+    const answered = questions.filter((question) => isAnswered(question, answers[question.id])).length;
+    const buildSummary = () => summarizeAnswers(blockId, title, questions, answers);
+    return (_jsxs("section", { className: "an-questions-block plan-questions-block", "data-block-id": blockId, children: [title && (_jsx("h2", { className: "text-[1.45rem] font-semibold leading-tight text-foreground", children: title })), _jsx("div", { className: "mt-7 grid gap-8", children: questions.map((question, index) => (_jsx(QuestionView, { question: question, index: index, answer: answers[question.id], blockId: blockId, ctx: ctx, onAnswer: (next) => setAnswer(question.id, next) }, question.id))) }), _jsxs("div", { className: "sticky bottom-0 mt-10 flex items-center justify-between gap-4 border-t border-border bg-background py-4 backdrop-blur", children: [_jsxs("p", { className: "text-sm font-semibold text-muted-foreground", children: [answered, "/", questions.length, " answered"] }), _jsx("div", { "data-plan-interactive": true, children: _jsx(SubmitMenu, { blockId: blockId, ctx: ctx, onSubmit: submitCtx.onQuestionFormSubmit, buildSummary: buildSummary }) })] })] }));
+}
+export function QuestionFormRead(props) {
+    return _jsx(QuestionFormReadInner, { ...props });
+}
+export function VisualQuestionsRead(props) {
+    return _jsx(QuestionFormReadInner, { ...props });
+}
+const inlineInputClass = "w-full rounded-md border border-border bg-background px-3 py-2 text-sm text-foreground shadow-sm outline-none transition-colors placeholder:text-muted-foreground focus-visible:ring-1 focus-visible:ring-ring";
+const inlineTextareaClass = "w-full resize-y rounded-md border border-border bg-background px-3 py-2 text-sm leading-6 text-foreground shadow-sm outline-none transition-colors placeholder:text-muted-foreground focus-visible:ring-1 focus-visible:ring-ring";
+const inlineLabelClass = "text-[11px] font-semibold uppercase tracking-[0.08em] text-muted-foreground";
+function newLocalId(prefix) {
+    return `${prefix}-${Math.random().toString(36).slice(2, 10)}`;
+}
+/** Shared editor for both `question-form` and `visual-questions`. */
+export function QuestionFormEdit({ data, onChange, editable, }) {
+    const updateQuestion = (questionId, patch) => onChange({
+        ...data,
+        questions: data.questions.map((question) => question.id === questionId ? { ...question, ...patch } : question),
+    });
+    const addQuestion = () => {
+        if (data.questions.length >= 40)
+            return;
+        onChange({
+            ...data,
+            questions: [
+                ...data.questions,
+                {
+                    id: newLocalId("question"),
+                    title: "New question",
+                    mode: "freeform",
+                    placeholder: "Type an answer...",
+                },
+            ],
+        });
+    };
+    const removeQuestion = (questionId) => {
+        if (data.questions.length <= 1)
+            return;
+        onChange({
+            ...data,
+            questions: data.questions.filter((question) => question.id !== questionId),
+        });
+    };
+    const setQuestionMode = (question, mode) => updateQuestion(question.id, {
+        mode,
+        options: mode === "freeform"
+            ? question.options
+            : question.options && question.options.length > 0
+                ? question.options
+                : [
+                    { id: newLocalId("option"), label: "Option A" },
+                    { id: newLocalId("option"), label: "Option B" },
+                ],
+    });
+    const updateOption = (questionId, optionId, patch) => onChange({
+        ...data,
+        questions: data.questions.map((question) => question.id === questionId
+            ? {
+                ...question,
+                options: (question.options ?? []).map((option) => option.id === optionId ? { ...option, ...patch } : option),
+            }
+            : question),
+    });
+    const addOption = (questionId) => onChange({
+        ...data,
+        questions: data.questions.map((question) => question.id === questionId && (question.options?.length ?? 0) < 40
+            ? {
+                ...question,
+                options: [
+                    ...(question.options ?? []),
+                    { id: newLocalId("option"), label: "New option" },
+                ],
+            }
+            : question),
+    });
+    const removeOption = (questionId, optionId) => onChange({
+        ...data,
+        questions: data.questions.map((question) => {
+            if (question.id !== questionId)
+                return question;
+            const nextOptions = (question.options ?? []).filter((option) => option.id !== optionId);
+            return { ...question, options: nextOptions };
+        }),
+    });
+    return (_jsxs("div", { className: "grid gap-6", "data-plan-interactive": true, children: [_jsx("div", { className: "grid gap-4", children: data.questions.map((question, index) => {
+                    const options = question.options ?? [];
+                    return (_jsxs("article", { className: "rounded-lg border border-border bg-card p-4", children: [_jsxs("div", { className: "mb-4 flex items-center justify-between gap-3", children: [_jsxs("span", { className: inlineLabelClass, children: ["Question ", index + 1] }), data.questions.length > 1 && (_jsx("button", { type: "button", "aria-label": `Delete question ${index + 1}`, className: "inline-flex size-8 items-center justify-center rounded-md border border-border text-muted-foreground hover:bg-muted hover:text-foreground", disabled: !editable, onClick: () => removeQuestion(question.id), children: _jsx(IconTrash, { className: "size-4" }) }))] }), _jsxs("div", { className: "grid gap-3 md:grid-cols-[minmax(0,1fr)_12rem]", children: [_jsxs("label", { className: "grid gap-1.5", children: [_jsx("span", { className: inlineLabelClass, children: "Title" }), _jsx("input", { className: inlineInputClass, value: question.title, disabled: !editable, onChange: (event) => updateQuestion(question.id, {
+                                                    title: event.target.value,
+                                                }) })] }), _jsxs("label", { className: "grid gap-1.5", children: [_jsx("span", { className: inlineLabelClass, children: "Mode" }), _jsxs("select", { className: inlineInputClass, value: question.mode, disabled: !editable, onChange: (event) => setQuestionMode(question, event.target.value), children: [_jsx("option", { value: "freeform", children: "Freeform" }), _jsx("option", { value: "single", children: "Single choice" }), _jsx("option", { value: "multi", children: "Multi choice" })] })] })] }), _jsxs("label", { className: "mt-3 grid gap-1.5", children: [_jsx("span", { className: inlineLabelClass, children: "Subtitle" }), _jsx("textarea", { className: inlineTextareaClass, rows: 2, value: question.subtitle ?? "", disabled: !editable, onChange: (event) => updateQuestion(question.id, {
+                                            subtitle: event.target.value || undefined,
+                                        }) })] }), _jsxs("div", { className: "mt-3 grid gap-3 md:grid-cols-[minmax(0,1fr)_auto_auto]", children: [_jsxs("label", { className: "grid gap-1.5", children: [_jsx("span", { className: inlineLabelClass, children: "Placeholder" }), _jsx("input", { className: inlineInputClass, value: question.placeholder ?? "", disabled: !editable, onChange: (event) => updateQuestion(question.id, {
+                                                    placeholder: event.target.value || undefined,
+                                                }) })] }), _jsxs("label", { className: "flex items-end gap-2 text-sm font-semibold text-muted-foreground", children: [_jsx("input", { type: "checkbox", className: "mb-2 size-4", checked: Boolean(question.required), disabled: !editable, onChange: (event) => updateQuestion(question.id, {
+                                                    required: event.target.checked || undefined,
+                                                }) }), "Required"] }), question.mode !== "freeform" && (_jsxs("label", { className: "flex items-end gap-2 text-sm font-semibold text-muted-foreground", children: [_jsx("input", { type: "checkbox", className: "mb-2 size-4", checked: question.allowOther !== false, disabled: !editable, onChange: (event) => updateQuestion(question.id, {
+                                                    allowOther: event.target.checked ? undefined : false,
+                                                }) }), "Allow write-in"] }))] }), question.mode !== "freeform" && (_jsxs("div", { className: "mt-4 grid gap-3", children: [options.map((option) => (_jsxs("div", { className: "grid gap-3 rounded-md border border-border/80 bg-background p-3 md:grid-cols-[minmax(0,1fr)_minmax(0,1fr)_auto]", children: [_jsxs("label", { className: "grid gap-1.5", children: [_jsx("span", { className: inlineLabelClass, children: "Option" }), _jsx("input", { className: inlineInputClass, value: option.label, disabled: !editable, onChange: (event) => updateOption(question.id, option.id, {
+                                                            label: event.target.value,
+                                                        }) })] }), _jsxs("label", { className: "grid gap-1.5", children: [_jsx("span", { className: inlineLabelClass, children: "Detail" }), _jsx("input", { className: inlineInputClass, value: option.detail ?? "", disabled: !editable, onChange: (event) => updateOption(question.id, option.id, {
+                                                            detail: event.target.value || undefined,
+                                                        }) })] }), _jsxs("div", { className: "flex items-end gap-2", children: [_jsxs("button", { type: "button", className: cn("inline-flex h-9 items-center gap-1.5 rounded-md border border-border px-3 text-sm font-semibold text-muted-foreground hover:bg-muted hover:text-foreground", option.recommended && "border-ring text-foreground"), disabled: !editable, onClick: () => updateOption(question.id, option.id, {
+                                                            recommended: !option.recommended,
+                                                        }), children: [option.recommended && (_jsx(IconCheck, { className: "size-4" })), "Recommended"] }), options.length > 1 && (_jsx("button", { type: "button", "aria-label": `Delete ${option.label}`, className: "inline-flex size-9 items-center justify-center rounded-md border border-border text-muted-foreground hover:bg-muted hover:text-foreground", disabled: !editable, onClick: () => removeOption(question.id, option.id), children: _jsx(IconTrash, { className: "size-4" }) }))] })] }, option.id))), _jsxs("button", { type: "button", className: "inline-flex h-9 w-fit items-center gap-1.5 rounded-md border border-border px-3 text-sm font-semibold text-muted-foreground hover:bg-muted hover:text-foreground", disabled: !editable || options.length >= 40, onClick: () => addOption(question.id), children: [_jsx(IconPlus, { className: "size-4" }), "Add option"] })] }))] }, question.id));
+                }) }), _jsxs("button", { type: "button", className: "inline-flex h-9 w-fit items-center gap-1.5 rounded-md border border-border px-3 text-sm font-semibold text-muted-foreground hover:bg-muted hover:text-foreground", disabled: !editable || data.questions.length >= 40, onClick: addQuestion, children: [_jsx(IconPlus, { className: "size-4" }), "Add question"] })] }));
+}
+/**
+ * Full client spec for the shared `question-form` block. A respondent-facing
+ * intake form edited from the block panel (the schema-ish question shape lives
+ * behind the edit surface, not inline).
+ */
+export const questionFormBlock = defineBlock({
+    type: "question-form",
+    schema: questionFormSchema,
+    mdx: questionFormMdx,
+    Read: QuestionFormRead,
+    Edit: QuestionFormEdit,
+    placement: ["block"],
+    editSurface: "panel",
+    label: "Question form",
+    description: "An interactive respondent-facing form block for open questions, single-choice or multi-choice option rows, freeform answers, recommended options, and optional wireframe/diagram previews. Edit the question schema from the block panel.",
+    empty: () => ({
+        submitLabel: "Send to agent",
+        questions: [
+            {
+                id: "open-question",
+                title: "What should the agent clarify before revising this plan?",
+                mode: "freeform",
+                placeholder: "Add constraints, preferences, or a decision...",
+            },
+        ],
+    }),
+});
+/**
+ * Full client spec for the shared `visual-questions` block — the same form UI
+ * and data shape as `question-form`, branded for explicit visual intake before a
+ * plan. Shares the Read/Edit internals; only the type, MDX tag, label, and seed
+ * differ.
+ */
+export const visualQuestionsBlock = defineBlock({
+    type: "visual-questions",
+    schema: visualQuestionsSchema,
+    mdx: visualQuestionsMdx,
+    Read: VisualQuestionsRead,
+    Edit: QuestionFormEdit,
+    placement: ["block"],
+    editSurface: "panel",
+    label: "Visual questions",
+    description: "A visual-intake question block that renders the respondent-facing question UI (single/multi/freeform, recommended options, inline wireframe/diagram previews) and keeps schema editing in the block panel.",
+    empty: () => ({
+        submitLabel: "Send to agent",
+        questions: [
+            {
+                id: "visual-question",
+                title: "Which direction should this plan take?",
+                mode: "single",
+                options: [
+                    {
+                        id: "option-a",
+                        label: "Direction A",
+                        detail: "Keep the current shape and refine it.",
+                        recommended: true,
+                    },
+                    {
+                        id: "option-b",
+                        label: "Direction B",
+                        detail: "Try a larger structural revision.",
+                    },
+                ],
+                allowOther: true,
+            },
+        ],
+    }),
+});
+//# sourceMappingURL=question-form.js.map