@petrarca/sonnet-schema-designer 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -1,122 +1,15 @@
-import { JsonSchemaProperty, JsonSchema, RefResolver, UISchema, UILayoutConfig, UISchemaOptions, UILayoutGroupConfig, UILayoutRowConfig } from '@petrarca/sonnet-core/schema';
+import { P as PropertyPath, S as SlotKind, U as UiSchemaMap, N as NewPropertyKind, C as ConditionCombinator, a as PropertyTypeChoice, D as DesignerModel, E as EnumChoice, T as TableHints, V as ValueTypeAnswer, Q as QuestionnaireDesignerCapabilities } from './index-Cu6JZdYj.js';
+export { A as ABSENT_KEY, b as ABSENT_WIDGET, c as ANSWER_TYPE_LABELS, d as ANSWER_TYPE_LIMITS, e as AnswerFragment, f as AnswerType, g as AnswerTypeChange, B as BuiltinAnswerType, h as CHOICE_WITH_TEXT_WIDGET, i as CODEABLE_CONCEPT_ANSWER, j as CODING_ANSWER, k as ChildSlot, l as ChoiceOption, m as Completion, n as Condition, o as ConditionalItems, p as DEFAULT_VALUE_TYPES, F as FieldType, L as LIMIT_LABELS, q as LimitKeyword, r as Limits, s as LockedItem, t as NewItem, O as OTHER_OPTION, u as PathSegment, v as PathSlot, w as QUANTITY_ANSWER, x as QuestionItem, y as QuestionnaireItem, z as QuestionnaireView, R as RecognizedAnswer, G as ResolvedQuestionnaireCapabilities, H as SectionItem, I as ShowIf, J as TextItem, K as ValueTypeSettings, M as absentProperty, W as addBranch, X as addConditional, Y as addDefinition, Z as addElse, _ as addItem, $ as addLayoutGroup, a0 as addProperty, a1 as answerTypeFragment, a2 as answerTypeLabel, a3 as answeredOrExcused, a4 as branch, a5 as changeAnswerType, a6 as changePropertyType, a7 as childContainer, a8 as childSlots, a9 as choiceTextWhen, aa as classifyQuestionnaire, ab as codingBindingOf, ac as condition, ad as containerFields, ae as containerOrder, af as declaredReasons, ag as def, ah as definitionUsageCount, ai as definitionsOf, aj as deleteItem, ak as deleteProperty, al as embeddedHints, am as getProperty, an as getScopedLayout, ao as getUiEntryAtPath, ap as isAsked, aq as isBuiltinAnswerType, ar as isComplete, as as isContainer, at as isContainerType, au as isReservedKey, av as isValidKey, aw as itemsOf, ax as keyFromText, ay as limitsFor, az as limitsOf, aA as moveBranch, aB as moveItem, aC as moveLayoutGroup, aD as moveProperty, aE as newBranch, aF as newCondition, aG as newProperty, aH as optionsOf, aI as otherTextMember, aJ as parsePathKey, aK as pathKey, aL as placeFieldInGroup, aM as prop, aN as questionnaireCapabilitiesSchema, aO as rawChoiceAndText, aP as readConditional, aQ as readEnumChoices, aR as readReasons, aS as readTableHints, aT as recognizeAnswerType, aU as removeBranch, aV as removeConditional, aW as removeDefinition, aX as removeElse, aY as removeLayoutGroup, aZ as renameDefinition, a_ as renameLayoutGroup, a$ as renameProperty, b0 as reorderItem, b1 as resolveQuestionnaireCapabilities, b2 as samePath, b3 as sameSegment, b4 as schemaAsRootProp, b5 as sectionPathOf, b6 as setChoiceTextWhen, b7 as setCondition, b8 as setConditionalBehavior, b9 as setDefaultAnswer, ba as setEnum, bb as setGlobalOptions, bc as setHelp, bd as setItemText, be as setKey, bf as setKeywords, bg as setLayoutGroupRule, bh as setLimit, bi as setOptions, bj as setPlaceholder, bk as setPresentation, bl as setPropertyLayout, bm as setQuestionRequired, bn as setQuestionnaireText, bo as setReadOnly, bp as setReasons, bq as setReference, br as setRequired, bs as setRootLayout, bt as setRootLayoutRows, bu as setScopedGroupRows, bv as setScopedLayoutGroups, bw as setScopedLayoutMode, bx as setScopedLayoutOptions, by as setScopedLayoutRows, bz as setScopedLayoutVariant, bA as setSectionRepeats, bB as setShowIf, bC as setTableHints, bD as setUiEntry, bE as setValueTypeSettings, bF as showIfToIf, bG as slot, bH as unlessReasonKey, bI as unlessReasonMember, bJ as updateProperty, bK as validateQuestionnaireCapabilities, bL as valueTypeAnswer, bM as valueTypeOf } from './index-Cu6JZdYj.js';
+import { JsonSchemaProperty, JsonSchema, RefResolver, UISchema, UILayoutConfig, UILayoutRowConfig, UILayoutGroupConfig, UISchemaOptions } from '@petrarca/sonnet-core/schema';
 import { z } from 'zod';
-import React from 'react';
+import * as React from 'react';
+import React__default from 'react';
 import { WidgetOptionDef } from '@petrarca/sonnet-forms/widget-options';
+import * as lucide_react from 'lucide-react';
+import { LucideIcon } from 'lucide-react';
+import { WidgetRegistry } from '@petrarca/sonnet-forms';
 import { TableUiSchema } from '@petrarca/sonnet-ui';
 
-/**
- * Path navigation over a JsonSchema tree.
- *
- * A path is a list of typed segments from the root down to a property. Most
- * segments are property keys (`{kind:"prop"}`) -- object children nest through
- * `properties`, array-of-object children through `items.properties`, and the
- * navigator descends through `items` transparently so an array and its item
- * object share one editing surface.
- *
- * Logic constructs introduce non-property segments: `{kind:"branch"}` for a
- * `oneOf`/`allOf` element, and `{kind:"slot"}` for a fixed schema slot
- * (`then`/`else`/`items`). The discriminated union keeps the distinction
- * explicit and type-checked; a single codec (pathKey/parsePathKey) owns all
- * conversion to/from strings.
- */
-
-/** A fixed schema slot that holds a single sub-schema. */
-type PathSlot = "then" | "else" | "items";
-/**
- * The array a conditional (if/then/else) member lives in. `allOf` = every
- * condition must hold (AND); `anyOf` = any condition suffices (OR). Maps to
- * FHIR `enableBehavior` "all" / "any".
- */
-type ConditionCombinator = "allOf" | "anyOf";
-/** One step in a property path. */
-type PathSegment = {
-    kind: "prop";
-    key: string;
-} | {
-    kind: "branch";
-    index: number;
-} | {
-    kind: "condition";
-    combinator: ConditionCombinator;
-    index: number;
-} | {
-    kind: "slot";
-    slot: PathSlot;
-} | {
-    kind: "def";
-    name: string;
-};
-type PropertyPath = PathSegment[];
-/**
- * Whether a property key is reserved by the path codec. Keys matching
- * `/^#(branch|condition|def|slot):/` would corrupt the pathKey/parsePathKey
- * round-trip. The designer guards against these at rename/add time.
- */
-declare function isReservedKey(key: string): boolean;
-/** Construct a property-key segment. */
-declare function prop(key: string): PathSegment;
-/** Construct a branch (oneOf element) segment. */
-declare function branch(index: number): PathSegment;
-/** Construct a condition (if/then/else member) segment for a combinator array. */
-declare function condition(index: number, combinator?: ConditionCombinator): PathSegment;
-/** Construct a fixed-slot segment. */
-declare function slot(name: PathSlot): PathSegment;
-/** Construct a definition ($defs entry) segment. Root-only in practice. */
-declare function def(name: string): PathSegment;
-/** Serialize a path to a stable string (React key, selection id, scope value). */
-declare function pathKey(path: PropertyPath): string;
-/** Parse a string produced by {@link pathKey} back into a path. */
-declare function parsePathKey(key: string): PropertyPath;
-/** Whether two path segments refer to the same position. */
-declare function sameSegment(a: PathSegment, b: PathSegment): boolean;
-/** Whether two paths refer to the same node (structural comparison). */
-declare function samePath(a: PropertyPath | null, b: PropertyPath | null): boolean;
-/** How a child slot is presented and mutated. */
-type SlotKind = "property" | "branch" | "conditional" | "definition";
-/** A single editable child of a property (or the root). */
-interface ChildSlot {
-    /** Segment appended to the parent path to reach this child. */
-    segment: PathSegment;
-    /** Display label for the tree row. */
-    label: string;
-    /** The child schema. */
-    property: JsonSchemaProperty;
-    kind: SlotKind;
-    removable: boolean;
-    reorderable: boolean;
-}
-/**
- * The properties map that holds a property's named children, or undefined when
- * it has none. Object children live in `properties`; array-of-object children
- * live in `items.properties`. (Logic constructs use branch/slot children and
- * are surfaced via {@link childSlots}, not here.)
- */
-declare function childContainer(prop: JsonSchemaProperty): Record<string, JsonSchemaProperty> | undefined;
-/**
- * The reusable definitions map of a schema. Canonically 2020-12 `$defs`; also
- * reads Draft-7 `definitions` so both dialects surface as editable nodes. New
- * definitions are always authored into `$defs` (see mutate.addDefinition).
- */
-declare function definitionsOf(property: JsonSchemaProperty): Record<string, JsonSchemaProperty> | undefined;
-/**
- * The ordered child slots of a property (the single extension point for the
- * tree/inspector/mutations). Surfaces object/array property children, oneOf
- * branches, if/then/else conditionals (allOf/anyOf members), and $defs
- * definitions (root-only in practice).
- */
-declare function childSlots(property: JsonSchemaProperty): ChildSlot[];
-/**
- * Wrap a JsonSchema root as an object-shaped JsonSchemaProperty so the path
- * navigation machinery can traverse it with the same stepInto logic as any
- * nested property. Pass the keys needed by the caller; unused fields default
- * to undefined.
- */
-declare function schemaAsRootProp(schema: JsonSchema): JsonSchemaProperty;
-/** Resolve a path to its property definition, or undefined if not found. */
-declare function getProperty(schema: JsonSchema, path: PropertyPath): JsonSchemaProperty | undefined;
-/** Whether a property has (or can have) child slots (properties, branches, conditionals). */
-declare function isContainer(prop: JsonSchemaProperty): boolean;
-
 /**
  * Read-shaping: turn a JsonSchema into a property tree for the designer UI.
  *
@@ -175,230 +68,6 @@ interface LayoutScope {
 /** Enumerate all layout scopes: the root form plus every object/array container. */
 declare function layoutScopes(schema: JsonSchema): LayoutScope[];
 
-/**
- * Pure edit operations over { schema, uiSchema }.
- *
- * Every function returns a new pair; nothing mutates in place. Operations keep
- * the schema and uiSchema consistent -- renaming a property rewrites the property
- * key, the uiSchema entry, the required entry, and any x-ui-order reference at
- * the same level. Mirrors the graph-model/mutate.ts discipline.
- */
-
-type UiSchemaMap = Record<string, UISchema>;
-interface DesignerModel {
-    schema: JsonSchema;
-    uiSchema: UiSchemaMap;
-}
-/** Kinds that can be created as a new property. */
-type NewPropertyKind = "scalar" | "object" | "array" | "oneOf";
-/** A default property for a newly created property of a given kind. */
-declare function newProperty(kind: NewPropertyKind): JsonSchemaProperty;
-/** A default oneOf branch: an object with a const-valued `kind` discriminator. */
-declare function newBranch(value: string): JsonSchemaProperty;
-/** Add a property under a parent path (root when empty). Returns the new model. */
-declare function addProperty(model: DesignerModel, parentPath: PropertyPath, kind: NewPropertyKind): {
-    model: DesignerModel;
-    path: PropertyPath;
-};
-/** Add a branch to the oneOf property at `path`. Returns the new model + branch path. */
-declare function addBranch(model: DesignerModel, path: PropertyPath): {
-    model: DesignerModel;
-    path: PropertyPath;
-};
-/** Remove the branch at `path` (a branch segment). Returns the new model. */
-declare function removeBranch(model: DesignerModel, path: PropertyPath): DesignerModel;
-/** Move the branch at `path` up (-1) or down (+1) among its siblings. */
-declare function moveBranch(model: DesignerModel, path: PropertyPath, direction: -1 | 1): DesignerModel;
-/**
- * A seed conditional member: an empty `if` (no field yet) plus an empty `then`.
- * The condition is filled in by setCondition; `then` fields are added like any
- * object's properties.
- */
-declare function newCondition(): JsonSchemaProperty;
-/**
- * Add a conditional (if/then/else) to the object at `objectPath` (root when
- * empty), appended to the given combinator array (`allOf` = AND, default;
- * `anyOf` = OR). Returns the new model + the condition path.
- */
-declare function addConditional(model: DesignerModel, objectPath: PropertyPath, combinator?: ConditionCombinator): {
-    model: DesignerModel;
-    path: PropertyPath;
-};
-/** Remove the conditional at `path` (a condition segment). Returns the new model. */
-declare function removeConditional(model: DesignerModel, path: PropertyPath): DesignerModel;
-/** Write the `if` of the conditional at `path` from a condition triple. */
-declare function setCondition(model: DesignerModel, path: PropertyPath, ifSchema: JsonSchemaProperty): DesignerModel;
-/** Add an empty `else` branch to the conditional at `path`. */
-declare function addElse(model: DesignerModel, path: PropertyPath): DesignerModel;
-/** Remove the `else` branch from the conditional at `path`. */
-declare function removeElse(model: DesignerModel, path: PropertyPath): DesignerModel;
-/**
- * Switch the combinator (AND/OR) for the conditionals of the object at
- * `objectPath`. Migrates every conditional member from the current combinator
- * array to `next`. Non-conditional members (structural allOf/anyOf entries)
- * stay put. No-op when already using `next` or when there are no conditionals.
- */
-declare function setConditionalBehavior(model: DesignerModel, objectPath: PropertyPath, next: ConditionCombinator): DesignerModel;
-/** Delete the property at path. Returns the new model. */
-declare function deleteProperty(model: DesignerModel, path: PropertyPath): DesignerModel;
-/** Rename the property at path. Rewrites key, order, required, and uiSchema. */
-declare function renameProperty(model: DesignerModel, path: PropertyPath, nextKey: string): {
-    model: DesignerModel;
-    path: PropertyPath;
-};
-/** Move the property at path up (-1) or down (+1) among its siblings. */
-declare function moveProperty(model: DesignerModel, path: PropertyPath, direction: -1 | 1): DesignerModel;
-/** Toggle whether the property at path is required among its siblings. */
-declare function setRequired(model: DesignerModel, path: PropertyPath, required: boolean): DesignerModel;
-/** Replace the property definition at path (merges the given partial). */
-declare function updateProperty(model: DesignerModel, path: PropertyPath, patch: Partial<JsonSchemaProperty>): DesignerModel;
-/** The kind a property can be changed to: a JSON Schema type, or a "oneOf" union. */
-type PropertyTypeChoice = NonNullable<JsonSchemaProperty["type"]> | "oneOf";
-/**
- * Change the kind of the property at path, reshaping structural keys: object
- * adds an empty `properties`; array adds `items`; oneOf adds branches + a
- * discriminator; leaving a kind strips its keys. Type-specific validation keys
- * that no longer apply are dropped.
- */
-declare function changePropertyType(model: DesignerModel, path: PropertyPath, next: PropertyTypeChoice): DesignerModel;
-/**
- * Point the property at path to a definition by name, writing a local `$ref`
- * (`#/$defs/<name>`) and stripping type-specific keys. Turns a plain property
- * into a reference usage. No-op for the root or an unknown target.
- */
-declare function setReference(model: DesignerModel, path: PropertyPath, name: string): DesignerModel;
-/**
- * Add a new empty object definition under `$defs`. Returns the new model and the
- * path to the created definition for selection.
- */
-declare function addDefinition(model: DesignerModel, name?: string): {
-    model: DesignerModel;
-    path: PropertyPath;
-};
-/**
- * Rename a `$defs` entry, preserving order, and rewrite every local `$ref` that
- * targets it (both `#/$defs/` and `#/definitions/` forms) to the new pointer.
- * No-op on collision, reserved, or empty names.
- */
-declare function renameDefinition(model: DesignerModel, oldName: string, newName: string): {
-    model: DesignerModel;
-    path: PropertyPath;
-};
-/**
- * Remove a `$defs` entry. Blocked (no-op) while any local `$ref` still targets
- * it; the UI surfaces the usage count. Drops the `$defs` map when it empties.
- */
-declare function removeDefinition(model: DesignerModel, name: string): DesignerModel;
-/** Whether a definition is referenced anywhere (for UI delete-guard messaging). */
-declare function definitionUsageCount(schema: JsonSchema, name: string): number;
-/** One enum choice: a value and an optional display label. */
-interface EnumChoice {
-    value: string;
-    label?: string;
-}
-declare function setEnum(model: DesignerModel, path: PropertyPath, choices: EnumChoice[]): DesignerModel;
-/** Read the current enum choices for a property + its uiSchema entry. */
-declare function readEnumChoices(prop: JsonSchemaProperty, uiEntry: UISchema | undefined): EnumChoice[];
-/** Table presentation hints for a property (embedded in the schema). */
-interface TableHints {
-    cell?: string;
-    cellOptions?: Record<string, unknown>;
-    column?: NonNullable<JsonSchemaProperty["x-ui-column"]>;
-}
-/**
- * Set (or clear) a property's table hints: x-ui-cell, x-ui-cell-options, and
- * x-ui-column. These live embedded on the property (EntityTable reads them
- * there). Empty values clear the corresponding key.
- */
-declare function setTableHints(model: DesignerModel, path: PropertyPath, hints: TableHints): DesignerModel;
-/** Read a property's current table hints. */
-declare function readTableHints(prop: JsonSchemaProperty): TableHints;
-/** Read the UISchema entry for a property path, or undefined. */
-declare function getUiEntryAtPath(uiSchema: UiSchemaMap, path: PropertyPath): UISchema | undefined;
-/** Set (or clear) the UISchema entry at a property path (any nesting depth). */
-declare function setUiEntry(model: DesignerModel, path: PropertyPath, entry: UISchema | undefined): DesignerModel;
-/**
- * Set (or clear) the x-ui-layout of an object/array property at path. Object
- * layout lives on the property; array layout lives on `items`.
- */
-declare function setPropertyLayout(model: DesignerModel, path: PropertyPath, layout: UILayoutConfig | undefined): DesignerModel;
-/** Set (or clear) the root form layout (uiSchema["x-ui-layout"]). */
-declare function setRootLayout(model: DesignerModel, layout: UILayoutConfig | undefined): DesignerModel;
-/**
- * Set (or clear) the root layout rows (uiSchema["x-ui-layout"].rows),
- * preserving other x-ui-layout keys. Clearing rows to empty removes the key;
- * if x-ui-layout then has no keys, it is removed entirely.
- */
-declare function setRootLayoutRows(model: DesignerModel, rows: UILayoutConfig["rows"]): DesignerModel;
-/**
- * Set the layout rows for a scope: the root form (path []) or an object/array
- * container (its property path). Root rows live in uiSchema["x-ui-layout"];
- * a container's rows live on the property's x-ui-layout (array -> items).
- * Preserves other x-ui-layout keys.
- */
-declare function setScopedLayoutRows(model: DesignerModel, scopePath: PropertyPath, rows: UILayoutConfig["rows"]): DesignerModel;
-/** Read the current x-ui-layout for a scope (root or a container property). */
-declare function getScopedLayout(schema: JsonSchema, uiSchema: UiSchemaMap, scopePath: PropertyPath): UILayoutConfig | undefined;
-/**
- * Merge scalar layout options (direction/gap/labels/compact) into a scope's
- * x-ui-layout, preserving rows and other keys. Undefined values clear the key.
- */
-declare function setScopedLayoutOptions(model: DesignerModel, scopePath: PropertyPath, options: Pick<UILayoutConfig, "direction" | "gap" | "labels" | "compact">): DesignerModel;
-/**
- * Set the group definitions for a scope, preserving other x-ui-layout keys.
- * Passing an empty list (or undefined) clears groups, returning the scope to the
- * flat row layout. Root groups live in uiSchema["x-ui-layout"]; a container's
- * live on the property's x-ui-layout (array -> items).
- *
- * Groups and flat rows are mutually exclusive (the renderer gives groups
- * precedence), so setting groups drops `rows` -- otherwise the orphaned list
- * would be invisible in both the form and the designer.
- */
-declare function setScopedLayoutGroups(model: DesignerModel, scopePath: PropertyPath, groups: UILayoutConfig["groups"]): DesignerModel;
-/** Append an empty group. The label defaults to the next ordinal ("Group 3"). */
-declare function addLayoutGroup(model: DesignerModel, scopePath: PropertyPath, label?: string): DesignerModel;
-/** Rename one group. No-op for an unknown index or a blank label. */
-declare function renameLayoutGroup(model: DesignerModel, scopePath: PropertyPath, groupIndex: number, label: string): DesignerModel;
-/**
- * Place a property into one group's row, removing it from wherever it currently
- * sits across *all* groups. Passing a null target returns it to the pool.
- *
- * Needed because each group owns its own rows: without a cross-group operation a
- * field could only be moved between groups by visiting its old group first.
- */
-declare function placeFieldInGroup(model: DesignerModel, scopePath: PropertyPath, key: string, target: {
-    groupIndex: number;
-    rowIndex: number;
-} | null): DesignerModel;
-/** Move one group left (-1) or right (+1). No-op at the ends. */
-declare function moveLayoutGroup(model: DesignerModel, scopePath: PropertyPath, groupIndex: number, direction: -1 | 1): DesignerModel;
-/**
- * Set (or clear) a group's show/hide rule. Passing undefined makes the group
- * unconditional.
- */
-declare function setLayoutGroupRule(model: DesignerModel, scopePath: PropertyPath, groupIndex: number, rule: UILayoutGroupConfig["rule"]): DesignerModel;
-/**
- * Set the group presentation for a scope ("groups", "stepper", or a custom
- * template name). Passing undefined restores the default group presentation.
- */
-declare function setScopedLayoutVariant(model: DesignerModel, scopePath: PropertyPath, variant: UILayoutConfig["variant"]): DesignerModel;
-/**
- * Remove one group. Its rows are not discarded: removing the last remaining group
- * flattens them back into the scope's flat row layout, so a single click can
- * never destroy every field placement.
- */
-declare function removeLayoutGroup(model: DesignerModel, scopePath: PropertyPath, groupIndex: number): DesignerModel;
-/** Replace the rows of one group in a scope. No-op for an unknown group index. */
-declare function setScopedGroupRows(model: DesignerModel, scopePath: PropertyPath, groupIndex: number, rows: UILayoutRowConfig[]): DesignerModel;
-/**
- * Switch a scope between flat rows and groups, carrying the existing layout over
- * so no field placement is lost: rows become the first group's rows, and leaving
- * group mode flattens every group's rows back into one list.
- */
-declare function setScopedLayoutMode(model: DesignerModel, scopePath: PropertyPath, mode: "rows" | "groups"): DesignerModel;
-/** Set (or clear) the root global options (uiSchema["x-ui-globalOptions"]). */
-declare function setGlobalOptions(model: DesignerModel, options: UISchemaOptions | undefined): DesignerModel;
-
 /**
  * Type -> compatible form widgets for the inspector's widget dropdown.
  *
@@ -466,8 +135,8 @@ type PreviewKind = z.infer<typeof previewKindSchema>;
  */
 declare const capabilitiesSchema: z.ZodObject<{
     mode: z.ZodDefault<z.ZodEnum<{
-        full: "full";
         data: "data";
+        full: "full";
     }>>;
     previews: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         form: "form";
@@ -593,6 +262,12 @@ interface DesignerState {
     replaceSchema: (schema: JsonSchema) => void;
     /** Replace the whole UI Schema map (from the editable UI Schema source tab). */
     replaceUiSchema: (uiSchema: UiSchemaMap) => void;
+    /**
+     * Apply one edit to the current model -- schema and uiSchema together, in one
+     * commit. For editors built on the pure model operations (the questionnaire
+     * designer). Gated by capabilities.locked; keeps the selection.
+     */
+    applyEdit: (edit: (model: DesignerModel) => DesignerModel) => void;
     setEnum: (path: PropertyPath, choices: EnumChoice[]) => void;
     setUiEntry: (path: PropertyPath, entry: UISchema | undefined) => void;
     setTableHints: (path: PropertyPath, hints: TableHints) => void;
@@ -631,9 +306,10 @@ declare function useDesignerState(args: UseDesignerStateArgs): DesignerState;
 /**
  * SchemaDesigner -- visual, controlled designer for a JsonSchema (+ uiSchema).
  *
- * Layout: Tree | Preview | Inspector. The preview (the live form) is the hero
- * and takes the flexible center, matching visual-builder convention; the
- * inspector is the resizable/collapsible right pane. Controlled via `schema` +
+ * Layout: Tree | Preview | Inspector, in the DesignerFrame the package's
+ * designers share. The preview (the live form) is the hero and takes the
+ * flexible center, matching visual-builder convention; the inspector is the
+ * resizable/collapsible right pane. Controlled via `schema` +
  * `uiSchema` + `onChange`, or uncontrolled via `initialSchema`. Read-only is a
  * mode of the same component.
  *
@@ -670,7 +346,101 @@ interface SchemaDesignerProps {
      */
     refResolver?: RefResolver;
 }
-declare function SchemaDesigner(props: SchemaDesignerProps): React.ReactElement;
+declare function SchemaDesigner(props: SchemaDesignerProps): React__default.ReactElement;
+
+/** A value type as the questionnaire designer offers it. */
+interface QuestionnaireValueType extends ValueTypeAnswer {
+    /** Its icon in the question list; a generic one when omitted. */
+    icon?: LucideIcon;
+    /** The widgets its form entry needs, when they are not the renderer's own. */
+    widgets?: WidgetRegistry;
+}
+/** The quantity, as sonnet contributes it. */
+declare const QUANTITY_VALUE_TYPE: QuestionnaireValueType;
+/** The coded value, as sonnet contributes it. */
+declare const CODING_VALUE_TYPE: QuestionnaireValueType;
+/** The value types the designer offers when it is handed none: the core types. */
+declare const DEFAULT_QUESTIONNAIRE_VALUE_TYPES: readonly QuestionnaireValueType[];
+/** The icon of a contributed value type when it names none. */
+declare const VALUE_TYPE_ICON: React.ForwardRefExoticComponent<Omit<lucide_react.LucideProps, "ref"> & React.RefAttributes<SVGSVGElement>>;
+
+/**
+ * QuestionnaireDesigner -- a questionnaire designer for people who author
+ * forms, not schemas. It edits the same JSON Schema (+ uiSchema) as the schema
+ * designer, in the same frame: the questions on the left, the live form in the
+ * centre, the selected question on the right, in the author's words.
+ *
+ * It never loses information: every part of a schema is shown, the parts it
+ * does not understand are kept as they are (classifyQuestionnaire), and every
+ * edit changes only what it touches (edit.ts). A capability profile limits
+ * what may be built; the way to the schema designer is the application's to
+ * offer. See docs/design/questionnaires.md.
+ */
+
+interface QuestionnaireDesignerProps {
+    /** Controlled schema. Provide with onChange. */
+    schema?: JsonSchema;
+    /** Controlled uiSchema map (form presentation hints). */
+    uiSchema?: Record<string, UISchema>;
+    /** Uncontrolled seed schema (used when `schema` is omitted). */
+    initialSchema?: JsonSchema;
+    /** Uncontrolled seed uiSchema. */
+    initialUiSchema?: Record<string, UISchema>;
+    /** Called on every edit with the new schema + uiSchema. */
+    onChange?: (schema: JsonSchema, uiSchema: Record<string, UISchema>) => void;
+    /** View-only: no edit affordances, onChange never fires. */
+    readOnly?: boolean;
+    /** What the author may build; every capability on when omitted. */
+    capabilities?: QuestionnaireDesignerCapabilities;
+    /**
+     * Open the same schema in the schema designer -- for what this designer does
+     * not offer. The application switches; nothing is converted. Without it, or
+     * with the profile's `switchToDesigner` off, no way is shown.
+     */
+    onOpenSchemaDesigner?: () => void;
+    /**
+     * The value types offered as answer types, beside the built-in ones -- the
+     * core types when omitted. An application adds its own here; see
+     * docs/design/value-types.md (workspace).
+     */
+    valueTypes?: readonly QuestionnaireValueType[];
+    /**
+     * Keywords a question keeps when its answer type changes -- an application's
+     * annotations that do not depend on the type, such as a converter's
+     * (sonnet-fhir: `FHIR_TYPE_INDEPENDENT_ANNOTATIONS`). Any other keyword the
+     * question carries beyond its type is dropped, and named first.
+     */
+    keptOnTypeChange?: readonly string[];
+}
+declare function QuestionnaireDesigner(props: QuestionnaireDesignerProps): React__default.ReactElement;
+
+/**
+ * DesignerFrame -- the frame the designers of this package share: a list pane
+ * on the left, the hero in the centre, a details pane on the right, in one
+ * box. Both side panes resize and collapse; the left one grows to fill when
+ * there is no centre. One frame, so the schema designer and the questionnaire
+ * designer look and behave as one family.
+ */
+
+interface DesignerFrameProps {
+    /** The left pane's content; given the function that collapses the pane. */
+    left: (collapse: () => void) => React__default.ReactNode;
+    /** The label of the button that brings the collapsed left pane back. */
+    leftExpandLabel: string;
+    /** The centre; none hides it, and the left pane fills its place. */
+    center?: React__default.ReactNode;
+    /** The right pane's heading. */
+    rightHeading: string;
+    /** Actions beside the right pane's heading -- shown on its collapsed rail too. */
+    rightActions?: React__default.ReactNode;
+    /** The right pane's content. */
+    right: React__default.ReactNode;
+    /** What the right pane is called in its collapse and expand labels. */
+    rightName: string;
+    /** Rendered inside the frame, after the panes (a sheet, a dialog). */
+    children?: React__default.ReactNode;
+}
+declare function DesignerFrame({ left, leftExpandLabel, center, rightHeading, rightActions, right, rightName, children, }: DesignerFrameProps): React__default.ReactElement;
 
 /**
  * PropertyTree -- the left pane. Renders the schema's properties as a
@@ -683,7 +453,7 @@ interface PropertyTreeProps {
     /** When provided, renders a collapse button in the header. */
     onCollapse?: () => void;
 }
-declare function PropertyTree({ state, onCollapse, }: PropertyTreeProps): React.ReactElement;
+declare function PropertyTree({ state, onCollapse, }: PropertyTreeProps): React__default.ReactElement;
 
 /**
  * PreviewPane -- the center pane. Tabs: Form (live rendered form), JSON Schema
@@ -701,7 +471,7 @@ interface PreviewPaneProps {
     /** Apply an edited profile (from the Capabilities tab). */
     onCapabilitiesChange?: (next: SchemaDesignerCapabilities) => void;
 }
-declare function PreviewPane({ state, capabilities, onCapabilitiesChange, }: PreviewPaneProps): React.ReactElement;
+declare function PreviewPane({ state, capabilities, onCapabilitiesChange, }: PreviewPaneProps): React__default.ReactElement;
 
 /**
  * TablePreview -- renders the schema as an EntityTable using auto-generated
@@ -713,7 +483,7 @@ interface TablePreviewProps {
     schema: JsonSchema;
     uiSchema?: TableUiSchema;
 }
-declare function TablePreview({ schema, uiSchema, }: TablePreviewProps): React.ReactElement;
+declare function TablePreview({ schema, uiSchema, }: TablePreviewProps): React__default.ReactElement;
 
 /**
  * Generate plausible sample rows from a JsonSchema, for the table preview.
@@ -742,7 +512,7 @@ declare function sampleRows(schema: JsonSchema, count?: number): Row[];
 interface FormLayoutDesignerProps {
     state: DesignerState;
 }
-declare function FormLayoutDesigner({ state, }: FormLayoutDesignerProps): React.ReactElement;
+declare function FormLayoutDesigner({ state, }: FormLayoutDesignerProps): React__default.ReactElement;
 
 /**
  * Inspector -- the right pane. Resolves the selected property and hosts the tabbed
@@ -755,7 +525,7 @@ interface InspectorProps {
     /** Option descriptors for custom widgets (merged over built-ins). */
     widgetOptions?: Record<string, WidgetOptionDef[]>;
 }
-declare function Inspector({ state, widgetOptions, }: InspectorProps): React.ReactElement;
+declare function Inspector({ state, widgetOptions, }: InspectorProps): React__default.ReactElement;
 
 /**
  * DataTab -- edits a property's data definition (type, title, description,
@@ -768,7 +538,7 @@ interface DataTabProps {
     node: PropertyNode;
     state: DesignerState;
 }
-declare function DataTab({ node, state }: DataTabProps): React.ReactElement;
+declare function DataTab({ node, state }: DataTabProps): React__default.ReactElement;
 
 /**
  * UITab -- edits a property's form presentation hints: the widget (x-ui-widget)
@@ -787,7 +557,7 @@ interface UITabProps {
     /** Consumer-supplied option descriptors for custom widgets (merged over built-ins). */
     widgetOptions?: Record<string, WidgetOptionDef[]>;
 }
-declare function UITab({ node, state, widgetOptions, }: UITabProps): React.ReactElement;
+declare function UITab({ node, state, widgetOptions, }: UITabProps): React__default.ReactElement;
 
 /**
  * EnumEditor -- edits a scalar property's allowed values (enum) and optional
@@ -803,7 +573,7 @@ interface EnumEditorProps {
     node: PropertyNode;
     state: DesignerState;
 }
-declare function EnumEditor({ node, state, }: EnumEditorProps): React.ReactElement;
+declare function EnumEditor({ node, state, }: EnumEditorProps): React__default.ReactElement;
 
 /**
  * TableHintsTab -- edits a property's table presentation hints (x-ui-cell,
@@ -819,7 +589,7 @@ interface TableHintsTabProps {
     node: PropertyNode;
     state: DesignerState;
 }
-declare function TableHintsTab({ node, state, }: TableHintsTabProps): React.ReactElement;
+declare function TableHintsTab({ node, state, }: TableHintsTabProps): React__default.ReactElement;
 
 /**
  * FormSettingsSheet -- form-level (root) settings in a right-side Sheet, opened
@@ -836,6 +606,7 @@ interface FormSettingsSheetProps {
     onOpenChange: (open: boolean) => void;
     state: DesignerState;
 }
-declare function FormSettingsSheet({ open, onOpenChange, state, }: FormSettingsSheetProps): React.ReactElement;
+declare function FormSettingsSheet({ open, onOpenChange, state, }: FormSettingsSheetProps): React__default.ReactElement;
 
-export { type CapabilitiesValidation, type ChildSlot, type ConditionCombinator, DataTab, type DesignerModel, type DesignerState, type EnumChoice, EnumEditor, FormLayoutDesigner, FormSettingsSheet, Inspector, type LayoutScope, type NewPropertyKind, type PathSegment, type PathSlot, type PreviewKind, PreviewPane, type PropertyKind, type PropertyNode, type PropertyPath, PropertyTree, type PropertyTypeChoice, type ResolvedCapabilities, SchemaDesigner, type SchemaDesignerCapabilities, type SchemaDesignerProps, type SlotKind, type TableHints, TableHintsTab, TablePreview, UITab, type UiSchemaMap, type UseDesignerStateArgs, type WidgetChoice, addBranch, addConditional, addDefinition, addElse, addLayoutGroup, addProperty, branch, buildPropertyTree, capabilitiesSchema, changePropertyType, childContainer, childSlots, compatibleWidgets, condition, def, definitionUsageCount, definitionsOf, deleteProperty, embedUiSchema, getProperty, getScopedLayout, getUiEntryAtPath, isContainer, isReservedKey, layoutScopes, moveBranch, moveLayoutGroup, moveProperty, newBranch, newCondition, newProperty, orderedKeys, parsePathKey, pathKey, placeFieldInGroup, prop, propertyKind, readEnumChoices, readTableHints, removeBranch, removeConditional, removeDefinition, removeElse, removeLayoutGroup, renameDefinition, renameLayoutGroup, renameProperty, resolveCapabilities, samePath, sameSegment, sampleRows, schemaAsRootProp, setCondition, setConditionalBehavior, setEnum, setGlobalOptions, setLayoutGroupRule, setPropertyLayout, setReference, setRequired, setRootLayout, setRootLayoutRows, setScopedGroupRows, setScopedLayoutGroups, setScopedLayoutMode, setScopedLayoutOptions, setScopedLayoutRows, setScopedLayoutVariant, setTableHints, setUiEntry, slot, updateProperty, useDesignerState, validateCapabilities };
+export { CODING_VALUE_TYPE, ConditionCombinator, DEFAULT_QUESTIONNAIRE_VALUE_TYPES, DataTab, DesignerFrame, DesignerModel, EnumChoice, EnumEditor, FormLayoutDesigner, FormSettingsSheet, Inspector, NewPropertyKind, PreviewPane, PropertyPath, PropertyTree, PropertyTypeChoice, QUANTITY_VALUE_TYPE, QuestionnaireDesigner, QuestionnaireDesignerCapabilities, SchemaDesigner, SlotKind, TableHints, TableHintsTab, TablePreview, UITab, UiSchemaMap, VALUE_TYPE_ICON, ValueTypeAnswer, buildPropertyTree, capabilitiesSchema, compatibleWidgets, embedUiSchema, layoutScopes, orderedKeys, propertyKind, resolveCapabilities, sampleRows, useDesignerState, validateCapabilities };
+export type { CapabilitiesValidation, DesignerFrameProps, DesignerState, LayoutScope, PreviewKind, PropertyKind, PropertyNode, QuestionnaireDesignerProps, QuestionnaireValueType, ResolvedCapabilities, SchemaDesignerCapabilities, SchemaDesignerProps, UseDesignerStateArgs, WidgetChoice };