@tai42/studio-sdk 30.0.1 → 31.0.0

package/dist/schema-form/collapsed-object-field.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button } from '../components/primitives';
+import { defaultValueForSchema } from './default-value';
+import { FieldGroup } from './field-group';
+import { useSeedingAction } from './seeding-action';
+export function CollapsedObjectField({ heading, description, error, definition, shape, root, onChange, }) {
+    const add = useSeedingAction(shape);
+    return (_jsx(FieldGroup, { heading: heading, description: description, error: add.failure ?? error, atRoot: false, children: _jsx("div", { children: _jsx(Button, { type: "button", variant: "secondary", onClick: () => {
+                    const level = add.seed(() => defaultValueForSchema(definition, root));
+                    if (level.ok)
+                        onChange(level.value);
+                }, children: "Add" }) }) }));
+}
+//# sourceMappingURL=collapsed-object-field.js.map

package/dist/schema-form/collapsed-object-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collapsed-object-field.js","sourceRoot":"","sources":["../../src/schema-form/collapsed-object-field.tsx"],"names":[],"mappings":";AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,UAAU,oBAAoB,CAAC,EACnC,OAAO,EACP,WAAW,EACX,KAAK,EACL,UAAU,EACV,KAAK,EACL,IAAI,EACJ,QAAQ,GAWT;IACC,MAAM,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACpC,OAAO,CACL,KAAC,UAAU,IACT,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,GAAG,CAAC,OAAO,IAAI,KAAK,EAC3B,MAAM,EAAE,KAAK,YAEb,wBACE,KAAC,MAAM,IACL,IAAI,EAAC,QAAQ,EACb,OAAO,EAAC,WAAW,EACnB,OAAO,EAAE,GAAG,EAAE;oBACZ,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;oBACtE,IAAI,KAAK,CAAC,EAAE;wBAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACtC,CAAC,oBAGM,GACL,GACK,CACd,CAAC;AACJ,CAAC"}

package/dist/schema-form/context.d.ts

@@ -1,13 +1,22 @@
 /**
  * Ambient React contexts for the schema-form tree: the optional argument
  * completion provider, the default media-upload byte cap, the record-entry value
- * renderer, and the expression-field door. A field deep in the tree reads these
+ * renderer, the expression-field door, and the object shapes being drawn above a
+ * field. A field deep in the tree reads these
  * here rather than every intermediate node drilling the prop.
  */
 import type { ComponentType, ReactNode } from 'react';
+import type { TemplatedTextCatalog } from '../state-binding/types';
 import type { CompletionProvider } from './SchemaForm';
 import type { JsonSchema } from './types';
 export declare const CompletionProviderContext: import("react").Context<CompletionProvider | undefined>;
+/**
+ * The object shapes (an object model's `shape`) being drawn by the fields above
+ * this one. An object field whose shape is already here is a definition nested
+ * inside itself; it draws its fields only when its value holds that level, so a
+ * self-referencing schema draws to the depth of its data rather than forever.
+ */
+export declare const ExpandedShapesContext: import("react").Context<ReadonlySet<object>>;
 export declare const MaxUploadBytesContext: import("react").Context<number>;
 /** One record entry, handed to a host-supplied value renderer. */
 export interface RecordEntryContext {
@@ -122,4 +131,21 @@ export type ExpressionFieldComponent = ComponentType<ExpressionFieldProps>;
  * single form.
  */
 export declare const ExpressionFieldContext: import("react").Context<ExpressionFieldComponent | undefined>;
+/**
+ * The hook a host supplies so a form's templated-text fields can offer stored
+ * templates: it returns the catalog (the template ids plus the storage-presence and
+ * fetch state) the field's stored-template picker reads. The form holds no data edge,
+ * so the host owns the fetch; a field calls the hook only when it renders, so a form
+ * without a templated-text field never fetches the catalog.
+ *
+ * It is a HOOK, called on every render of a templated-text field, so the injected
+ * reference must be stable (a module-level function).
+ */
+export type UseTemplatedTextCatalog = () => TemplatedTextCatalog | undefined;
+/**
+ * The ambient stored-template source for the whole form. Absent (the default), a
+ * templated-text field gets no catalog, as every `TemplatedTextField` given none:
+ * the stored source offers no templates and inline content is authored as usual.
+ */
+export declare const TemplatedTextCatalogContext: import("react").Context<UseTemplatedTextCatalog>;
 //# sourceMappingURL=context.d.ts.map

package/dist/schema-form/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/schema-form/context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/schema-form/context.ts"],"names":[],"mappings":"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"}

package/dist/schema-form/context.js

@@ -3,6 +3,13 @@ import { DEFAULT_MAX_UPLOAD_BYTES } from './media';
 // Ambient completion provider for the whole form. A string field deep in the
 // tree reads it here rather than every intermediate node drilling the prop.
 export const CompletionProviderContext = createContext(undefined);
+/**
+ * The object shapes (an object model's `shape`) being drawn by the fields above
+ * this one. An object field whose shape is already here is a definition nested
+ * inside itself; it draws its fields only when its value holds that level, so a
+ * self-referencing schema draws to the depth of its data rather than forever.
+ */
+export const ExpandedShapesContext = createContext(new Set());
 // Ambient default upload cap for the whole form; a media field reads it here so
 // intermediate object/array nodes never drill the prop.
 export const MaxUploadBytesContext = createContext(DEFAULT_MAX_UPLOAD_BYTES);
@@ -22,4 +29,11 @@ export const RecordEntryRendererContext = createContext(undefined);
  * single form.
  */
 export const ExpressionFieldContext = createContext(undefined);
+const useNoTemplatedTextCatalog = () => undefined;
+/**
+ * The ambient stored-template source for the whole form. Absent (the default), a
+ * templated-text field gets no catalog, as every `TemplatedTextField` given none:
+ * the stored source offers no templates and inline content is authored as usual.
+ */
+export const TemplatedTextCatalogContext = createContext(useNoTemplatedTextCatalog);
 //# sourceMappingURL=context.js.map

package/dist/schema-form/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/schema-form/context.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAInD,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAiC,SAAS,CAAC,CAAC;AAElG,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAS,wBAAwB,CAAC,CAAC;AAyBrF,iFAAiF;AACjF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAkC,SAAS,CAAC,CAAC;AAwFpG;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CACjD,SAAS,CACV,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/schema-form/context.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAGtC,OAAO,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAInD,6EAA6E;AAC7E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAiC,SAAS,CAAC,CAAC;AAElG;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;AAEnF,gFAAgF;AAChF,wDAAwD;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,aAAa,CAAS,wBAAwB,CAAC,CAAC;AAyBrF,iFAAiF;AACjF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,0BAA0B,GAAG,aAAa,CAAkC,SAAS,CAAC,CAAC;AAwFpG;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CACjD,SAAS,CACV,CAAC;AAcF,MAAM,yBAAyB,GAA4B,GAAG,EAAE,CAAC,SAAS,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,aAAa,CAA0B,yBAAyB,CAAC,CAAC"}

package/dist/schema-form/default-value.d.ts

@@ -9,12 +9,27 @@ export declare function defaultValueForSchema(schema: JsonSchema, root?: JsonSch
  * A SELF-CONSISTENT skeleton for a schema — the seed a variant switch (or any
  * other programmatic reseed) commits as the field's new value. Where
  * {@link defaultValueForSchema} deliberately leaves a required scalar absent so
- * a fresh form flags it, a committed skeleton must validate against its own
- * schema, so here EVERY required field with a known empty value is minted:
- * required strings seed `''`, numbers `0`, booleans `false` — consistently with
- * the `[]` / `{}` / nested-object seeds the default path already mints. Kinds
- * with no empty value to name (enum, union, free-form JSON) stay absent either
- * way: inventing a choice would be a lie the user never made.
+ * a fresh form flags it, a committed skeleton carries no missing required field,
+ * so here EVERY required field with a known empty value is minted: required
+ * strings seed `''`, numbers `0`, booleans `false`, a templated text an empty
+ * inline source `{ content: '' }` — consistently with the `[]` / `{}` /
+ * nested-object seeds the default path already mints. A minted empty value is
+ * not promised to pass its own value check: an empty templated text fails it
+ * ("needs inline content or a stored template"), as does `''` under a
+ * `minLength` or a `pattern`, and validation reports that error like any
+ * other. Kinds with no empty value to name (enum,
+ * union, free-form JSON) stay absent either way: inventing a choice would be a
+ * lie the user never made.
  */
 export declare function skeletonValueForSchema(schema: JsonSchema, root?: JsonSchema): unknown;
+/**
+ * Thrown by {@link defaultValueForSchema} and {@link skeletonValueForSchema} when the
+ * schema admits no finite value: a chain of required properties refers back to its
+ * own definition with no `null` accepted on the way. A caller that seeds on a user
+ * action catches exactly this type to show the failure on its field; any other error
+ * is not a seeding outcome and propagates.
+ */
+export declare class NoFiniteValueError extends Error {
+    constructor();
+}
 //# sourceMappingURL=default-value.d.ts.map

package/dist/schema-form/default-value.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default-value.d.ts","sourceRoot":"","sources":["../../src/schema-form/default-value.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAc1C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,UAAmB,GAAG,OAAO,CAE5F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,UAAmB,GAAG,OAAO,CAE7F"}
+{"version":3,"file":"default-value.d.ts","sourceRoot":"","sources":["../../src/schema-form/default-value.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAc1C;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,UAAmB,GAAG,OAAO,CAE5F;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,UAAmB,GAAG,OAAO,CAE7F;AASD;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;CAO5C"}

package/dist/schema-form/default-value.js

@@ -12,8 +12,9 @@
  *    opted into.
  *
  * `skeletonValueForSchema` is the sibling entry for programmatic reseeds (a
- * union variant switch): same walk, but required scalars mint their type's
- * empty value so the committed seed validates against its own schema.
+ * union variant switch): same walk, but every required field with a known empty
+ * value is minted, so the committed seed has no missing required field. A minted
+ * empty value may still fail its own value check (see the sibling's docstring).
  */
 import { classifySchema } from './classify';
 /** The explicit `default` (wrapper takes precedence over the resolved node), if any. */
@@ -30,33 +31,85 @@ function explicitDefault(raw, resolved) {
  * whole-tool-schema call).
  */
 export function defaultValueForSchema(schema, root = schema) {
-    return seedValue(schema, root, false);
+    return finiteSeed(seedValue(schema, root, false, new Set()));
 }
 /**
  * A SELF-CONSISTENT skeleton for a schema — the seed a variant switch (or any
  * other programmatic reseed) commits as the field's new value. Where
  * {@link defaultValueForSchema} deliberately leaves a required scalar absent so
- * a fresh form flags it, a committed skeleton must validate against its own
- * schema, so here EVERY required field with a known empty value is minted:
- * required strings seed `''`, numbers `0`, booleans `false` — consistently with
- * the `[]` / `{}` / nested-object seeds the default path already mints. Kinds
- * with no empty value to name (enum, union, free-form JSON) stay absent either
- * way: inventing a choice would be a lie the user never made.
+ * a fresh form flags it, a committed skeleton carries no missing required field,
+ * so here EVERY required field with a known empty value is minted: required
+ * strings seed `''`, numbers `0`, booleans `false`, a templated text an empty
+ * inline source `{ content: '' }` — consistently with the `[]` / `{}` /
+ * nested-object seeds the default path already mints. A minted empty value is
+ * not promised to pass its own value check: an empty templated text fails it
+ * ("needs inline content or a stored template"), as does `''` under a
+ * `minLength` or a `pattern`, and validation reports that error like any
+ * other. Kinds with no empty value to name (enum,
+ * union, free-form JSON) stay absent either way: inventing a choice would be a
+ * lie the user never made.
  */
 export function skeletonValueForSchema(schema, root = schema) {
-    return seedValue(schema, root, true);
+    return finiteSeed(seedValue(schema, root, true, new Set()));
+}
+/**
+ * The walk's answer when an object's required structure leads back into an object
+ * shape it is already inside with no `null` accepted anywhere on the way: that
+ * nesting never ends, so the object has no finite value.
+ */
+const NO_FINITE_VALUE = Symbol('no finite value');
+/**
+ * Thrown by {@link defaultValueForSchema} and {@link skeletonValueForSchema} when the
+ * schema admits no finite value: a chain of required properties refers back to its
+ * own definition with no `null` accepted on the way. A caller that seeds on a user
+ * action catches exactly this type to show the failure on its field; any other error
+ * is not a seeding outcome and propagates.
+ */
+export class NoFiniteValueError extends Error {
+    constructor() {
+        super('SchemaForm: the schema admits no finite value: its required properties refer back to their own definition with no null accepted on the way');
+        this.name = 'NoFiniteValueError';
+    }
+}
+/** The entry points' result: the seeded value, or {@link NoFiniteValueError} when none is finite. */
+function finiteSeed(seed) {
+    if (seed === NO_FINITE_VALUE)
+        throw new NoFiniteValueError();
+    return seed;
 }
 /**
  * Seed an object's required nested structure and any optional property that
  * carries an explicit default. A required property recurses; an optional one is
  * materialized only when it declares a `default`, so its own required children
  * never raise errors on a field the user did not opt into.
+ *
+ * `expanding` holds the object shapes being seeded on the way down. Reaching one of
+ * them again (a self-referencing definition) answers {@link NO_FINITE_VALUE}, and
+ * so does an object with any required property that answers it. A `nullable` object
+ * turns that answer into `null`, the value that ends the nesting there. So the
+ * answer climbs to the nearest nullable object above the point where the cycle
+ * closes, and reaches the entry point only when no object on the way accepts
+ * `null`: then no finite value exists.
+ */
+function seedObject(model, nullable, root, mintScalars, expanding) {
+    const seeded = seedProperties(model, root, mintScalars, expanding);
+    return seeded === NO_FINITE_VALUE && nullable ? null : seeded;
+}
+/**
+ * An object's own seed (see {@link seedObject}): its properties' seeds, or
+ * {@link NO_FINITE_VALUE} when its shape is already being seeded above or a required
+ * property has no finite value.
  */
-function seedObject(model, root, mintScalars) {
+function seedProperties(model, root, mintScalars, expanding) {
+    if (expanding.has(model.shape))
+        return NO_FINITE_VALUE;
+    const inside = new Set(expanding).add(model.shape);
     const entries = [];
     for (const [name, propSchema] of model.properties) {
         if (model.required.has(name)) {
-            const seeded = seedValue(propSchema, root, mintScalars);
+            const seeded = seedValue(propSchema, root, mintScalars, inside);
+            if (seeded === NO_FINITE_VALUE)
+                return NO_FINITE_VALUE;
             if (seeded !== undefined)
                 entries.push([name, seeded]);
             continue;
@@ -89,9 +142,11 @@ function seedScalar(kind, mintScalars) {
 /**
  * The shared seeding walk. `mintScalars` distinguishes the two entry points
  * above: `false` leaves value-less required scalars absent; `true` mints their
- * type's empty value.
+ * type's empty value. `expanding` holds the object shapes being seeded on the way
+ * down; a nullable object whose own seed has no finite value seeds `null` (see
+ * {@link seedObject}).
  */
-function seedValue(schema, root, mintScalars) {
+function seedValue(schema, root, mintScalars, expanding) {
     const classified = classifySchema(schema, root);
     const explicit = explicitDefault(schema, classified.schema);
     if (explicit.present)
@@ -101,7 +156,7 @@ function seedValue(schema, root, mintScalars) {
         case 'const':
             return model.value;
         case 'object':
-            return seedObject(model, root, mintScalars);
+            return seedObject(model, classified.nullable, root, mintScalars, expanding);
         case 'array':
         case 'multiselect':
             return [];
@@ -111,6 +166,10 @@ function seedValue(schema, root, mintScalars) {
         case 'number':
         case 'boolean':
             return seedScalar(model.kind, mintScalars);
+        case 'templated-text':
+            // Inline is the templated text's own starting mode, so its empty value is an
+            // empty inline source; the default path leaves it absent like a scalar.
+            return mintScalars ? { content: '' } : undefined;
         case 'enum':
         case 'union':
         case 'json':

package/dist/schema-form/default-value.js.map

@@ -1 +1 @@
-{"version":3,"file":"default-value.js","sourceRoot":"","sources":["../../src/schema-form/default-value.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"default-value.js","sourceRoot":"","sources":["../../src/schema-form/default-value.ts"],"names":[],"mappings":"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"}

package/dist/schema-form/expression-field.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The injected expression door as a schema-form field: an `x-tai42-expression`
+ * annotation mapped onto the door's input-shape descriptor, and the door mounted
+ * inside a Suspense boundary that paints a resting shell while a lazily-injected
+ * door resolves. A jq-annotated string draws it as the whole field; a jq-annotated
+ * templated-text field draws it as its inline editor.
+ *
+ * NO JQ EDGE: the door arrives from the host (see `ExpressionFieldContext`);
+ * this module names no jq type.
+ */
+import type { ReactNode } from 'react';
+import type { ExpressionFieldComponent } from './context';
+import type { ExpressionAnnotation } from './field-model';
+/**
+ * An expression-annotated field, rendered through the injected door: a
+ * multiline resting control with the door's own visual-editor button. The door
+ * brings its own label/description/error chrome (a11y-linked slots), so it is NOT
+ * wrapped in the form's `Field` component — the annotation's descriptor fields map
+ * onto the input-shape descriptor, and the form's per-field error feeds `error`.
+ *
+ * The door is rendered as an ELEMENT, never called as a function, so its hooks and
+ * state (editor open, worker handle) belong to it and survive re-renders of this
+ * field.
+ *
+ * It mounts inside a `Suspense` boundary because a host is free to inject a `lazy`
+ * door to keep the jq subgraph in a split chunk of ITS OWN bundle. The fallback
+ * paints the resting shell — label/description/error chrome around the current
+ * value in a read-only multiline control — so the field holds its layout and keeps
+ * the value visible while that chunk resolves, and the swap does not flash. A door
+ * injected eagerly never suspends and renders straight through.
+ *
+ * The form passes only the props the field owns; a jq door's `serverValidate`,
+ * `onEditorOpenChange`, and `compact` stay unwired, because no author-time
+ * validation endpoint applies to a schema-declared field, the hosts that render
+ * `SchemaForm` register no global shortcuts to mute, and every sibling field shows
+ * a visible label (the compact variant is for dense host rows).
+ */
+export declare function ExpressionField({ component: Door, heading, description, error, expression, argName, value, onChange, }: {
+    component: ExpressionFieldComponent;
+    heading: string;
+    description: string | undefined;
+    error: string | undefined;
+    expression: ExpressionAnnotation;
+    argName: string;
+    value: string;
+    onChange: (value: string) => void;
+}): ReactNode;
+//# sourceMappingURL=expression-field.d.ts.map

package/dist/schema-form/expression-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-field.d.ts","sourceRoot":"","sources":["../../src/schema-form/expression-field.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,wBAAwB,EAAwB,MAAM,WAAW,CAAC;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,SAAS,EAAE,IAAI,EACf,OAAO,EACP,WAAW,EACX,KAAK,EACL,UAAU,EACV,OAAO,EACP,KAAK,EACL,QAAQ,GACT,EAAE;IACD,SAAS,EAAE,wBAAwB,CAAC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,UAAU,EAAE,oBAAoB,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC,GAAG,SAAS,CA0BZ"}

package/dist/schema-form/expression-field.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Suspense, useMemo } from 'react';
+import { Field } from '../components/field';
+import { Textarea } from '../components/inputs';
+/**
+ * An expression-annotated field, rendered through the injected door: a
+ * multiline resting control with the door's own visual-editor button. The door
+ * brings its own label/description/error chrome (a11y-linked slots), so it is NOT
+ * wrapped in the form's `Field` component — the annotation's descriptor fields map
+ * onto the input-shape descriptor, and the form's per-field error feeds `error`.
+ *
+ * The door is rendered as an ELEMENT, never called as a function, so its hooks and
+ * state (editor open, worker handle) belong to it and survive re-renders of this
+ * field.
+ *
+ * It mounts inside a `Suspense` boundary because a host is free to inject a `lazy`
+ * door to keep the jq subgraph in a split chunk of ITS OWN bundle. The fallback
+ * paints the resting shell — label/description/error chrome around the current
+ * value in a read-only multiline control — so the field holds its layout and keeps
+ * the value visible while that chunk resolves, and the swap does not flash. A door
+ * injected eagerly never suspends and renders straight through.
+ *
+ * The form passes only the props the field owns; a jq door's `serverValidate`,
+ * `onEditorOpenChange`, and `compact` stay unwired, because no author-time
+ * validation endpoint applies to a schema-declared field, the hosts that render
+ * `SchemaForm` register no global shortcuts to mute, and every sibling field shows
+ * a visible label (the compact variant is for dense host rows).
+ */
+export function ExpressionField({ component: Door, heading, description, error, expression, argName, value, onChange, }) {
+    // Memoised: the descriptor's identity feeds the door's own memoisation, so a
+    // fresh object each keystroke would defeat it.
+    const shape = useMemo(() => expressionShape(expression, argName), [expression, argName]);
+    return (_jsx(Suspense, { fallback: _jsx(ExpressionFieldSkeleton, { heading: heading, description: description, error: error, value: value }), children: _jsx(Door, { label: heading, description: description, error: error, shape: shape, multiline: true, value: value, onChange: onChange }) }));
+}
+/**
+ * The resting shell shown while a lazily-injected door resolves. It mirrors the
+ * live door's footprint — the same label/description/error chrome wrapping a
+ * multiline control seeded with the current value — but the control is
+ * non-interactive (read-only, `aria-busy`) because there is nothing to edit yet. Matching the
+ * footprint is what keeps the Suspense swap from shifting layout or flashing.
+ */
+function ExpressionFieldSkeleton({ heading, description, error, value, }) {
+    return (_jsx(Field, { label: heading, description: description, error: error, children: _jsx(Textarea, { value: value, readOnly: true, "aria-busy": "true" }) }));
+}
+/**
+ * Map a classified expression annotation onto the door's input-shape descriptor.
+ * A bare annotation (`language` only) maps to NO descriptor — an undeclared shape
+ * is the honest rendering when the server said nothing about `.`. When any
+ * descriptor field is present, the required descriptor members the annotation
+ * omits fall back to neutral values rather than invented copy.
+ */
+function expressionShape(expression, argName) {
+    const declared = [
+        expression.label,
+        expression.blurb,
+        expression.keys,
+        expression.variables,
+        expression.returns,
+        expression.caveats,
+    ].some((field) => field !== undefined) || expression.hasSample;
+    if (!declared)
+        return undefined;
+    return {
+        // Opaque, host-namespaced, stable per field (memoisation/telemetry only).
+        id: argName === '' ? 'tai42.schema-form' : `tai42.schema-form.${argName}`,
+        label: expression.label ?? 'input',
+        blurb: expression.blurb ?? '',
+        keys: expression.keys ?? [],
+        returns: expression.returns ?? '',
+        ...(expression.caveats === undefined ? {} : { caveats: expression.caveats }),
+        ...(expression.hasSample ? { sample: expression.sample } : {}),
+        ...(expression.variables === undefined
+            ? {}
+            : { variables: expression.variables.map(expressionVariable) }),
+    };
+}
+/** Map one classified annotation variable onto the door's variable descriptor. */
+function expressionVariable(variable) {
+    return {
+        name: variable.name,
+        blurb: variable.blurb,
+        // The annotation glosses no sub-keys of a variable's value, so the door gets
+        // the variable's shape as untyped (empty keys).
+        keys: [],
+        ...(variable.hasSample ? { sample: variable.sample } : {}),
+    };
+}
+//# sourceMappingURL=expression-field.js.map

package/dist/schema-form/expression-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-field.js","sourceRoot":"","sources":["../../src/schema-form/expression-field.tsx"],"names":[],"mappings":"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"}

package/dist/schema-form/field-model.d.ts

@@ -65,10 +65,11 @@ export interface ExpressionAnnotationVariable {
     readonly sample: unknown;
 }
 /**
- * The `x-tai42-expression` annotation on a string schema: the server declares
- * that the field's value is authored in a pipeline expression language (only jq
- * today) and optionally describes what `.` is for that expression. The renderer
- * uses it to open the visual-editor door instead of a plain text box. The shape
+ * The `x-tai42-expression` annotation on a string or templated-text property: the
+ * server declares that the field's value is authored in a pipeline expression
+ * language (only jq today) and optionally describes what `.` is for that expression.
+ * The renderer uses it to open the visual-editor door instead of a plain text box
+ * (on a templated-text field, as its inline editor). The shape
  * mirrors jq-studio's input-shape descriptor WITHOUT importing it — classification
  * stays a pure schema concern; the renderer maps this onto a jq field declaration.
  */
@@ -157,13 +158,31 @@ export type FieldModel = {
     readonly kind: 'object';
     readonly properties: readonly (readonly [string, JsonSchema])[];
     readonly required: ReadonlySet<string>;
+    /**
+     * The schema's own `properties` map, by identity. Every classification of one
+     * definition — through a `$ref`, a null-union or single-`allOf` wrapper, or an
+     * annotated property site — carries this same map, so a walker recognises a
+     * definition nested inside itself (a self-referencing schema) by it.
+     */
+    readonly shape: Readonly<Record<string, JsonSchema>>;
 } | {
     readonly kind: 'record';
     readonly values: JsonSchema;
+} | {
+    readonly kind: 'templated-text';
+    /** Present when the property's `x-tai42-expression` annotation declares its
+     *  inline content an expression: the inline editor is the expression door. */
+    readonly expression: ExpressionAnnotation | undefined;
 } | {
     readonly kind: 'union';
     readonly variants: readonly UnionVariant[];
     readonly discriminator: string | undefined;
+    /**
+     * The schema's own `anyOf`/`oneOf` member list, by identity: every
+     * classification of one union carries this same list, so a field can tell
+     * whether it still draws the union it drew before.
+     */
+    readonly members: readonly JsonSchema[];
 } | {
     readonly kind: 'json';
     readonly jsonType: 'object' | 'array' | 'any';

package/dist/schema-form/field-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-model.d.ts","sourceRoot":"","sources":["../../src/schema-form/field-model.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"field-model.d.ts","sourceRoot":"","sources":["../../src/schema-form/field-model.ts"],"names":[],"mappings":"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"}

package/dist/schema-form/field-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-node.d.ts","sourceRoot":"","sources":["../../src/schema-form/field-node.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAQ,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAiB7C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGxE,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7D,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;CACjC;AAMD;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAuBvD;AA6LD,eAAO,MAAM,SAAS,2DAAsB,CAAC"}
+{"version":3,"file":"field-node.d.ts","sourceRoot":"","sources":["../../src/schema-form/field-node.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAQ,KAAK,SAAS,EAAc,MAAM,OAAO,CAAC;AAoBzD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGxE,UAAU,cAAc;IACtB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,SAAS,CAAC;IAC9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC7D,8EAA8E;IAC9E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;CACjC;AAMD;;;;;;GAMG;AACH,iBAAS,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CA0BvD;AA8ND,eAAO,MAAM,SAAS,2DAAsB,CAAC"}

package/dist/schema-form/field-node.js

@@ -5,13 +5,15 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * inline; every other kind delegates to a dedicated field component). Object,
  * array, and union renderers recurse back through here for their children.
  */
-import { memo } from 'react';
+import { memo, useContext } from 'react';
 import { Checkbox } from '../components/checkbox';
 import { Field } from '../components/field';
 import { NumberInput, TextInput } from '../components/inputs';
-import { ownValue } from '../guards';
+import { isRecord, ownValue } from '../guards';
 import { ArrayField } from './array-field';
 import { classifySchema } from './classify';
+import { CollapsedObjectField } from './collapsed-object-field';
+import { ExpandedShapesContext } from './context';
 import { EnumField } from './enum-field';
 import { FieldGroup } from './field-group';
 import { JsonField } from './json-field';
@@ -20,6 +22,7 @@ import { ObjectFields } from './object-fields';
 import { RecordField } from './record-field';
 import { scalarLabel } from './resolve';
 import { StringField } from './string-field';
+import { TemplatedField } from './templated-field';
 import { UnionField } from './union-field';
 function labelText(explicit, label) {
     return explicit ?? label ?? 'Value';
@@ -33,12 +36,15 @@ function labelText(explicit, label) {
  */
 function FieldNodeImpl(props) {
     const { root, value, onChange, path, required, idPrefix, errors } = props;
+    const expanded = useContext(ExpandedShapesContext);
     const classified = classifySchema(props.schema, root);
     const base = labelText(classified.title, props.label);
     const heading = props.markRequired === true && required ? `${base} *` : base;
     const { model, description } = classified;
     return renderField({
         model,
+        definition: classified.schema,
+        expanded,
         nullable: classified.nullable,
         heading,
         description,
@@ -71,6 +77,8 @@ function renderField(args) {
             return (_jsx(NumberField, { heading: heading, description: description, error: error, integer: model.integer, value: value, onChange: onChange }));
         case 'boolean':
             return (_jsx(BooleanField, { heading: heading, description: description, error: error, value: value, onChange: onChange }));
+        case 'templated-text':
+            return (_jsx(TemplatedField, { heading: heading, description: description, error: error, expression: model.expression, argName: path, required: required, value: value, onChange: onChange }));
         case 'multiselect':
             return (_jsx(MultiSelectField, { heading: heading, description: description, error: error, model: model, value: value, onChange: onChange }));
         default:
@@ -85,7 +93,12 @@ function renderCompositeField(args, model) {
         case 'array':
             return (_jsx(ArrayField, { heading: heading, description: description, error: error, items: model.items, root: root, value: value, onChange: onChange, path: path, errors: errors, idPrefix: idPrefix, words: args.listWords }));
         case 'object':
-            return (_jsx(FieldGroup, { heading: heading, description: description, error: error, atRoot: path === '', children: _jsx(ObjectFields, { properties: model.properties, requiredKeys: model.required, root: root, value: value, onChange: onChange, path: path, errors: errors, idPrefix: idPrefix, skip: undefined, fieldWording: fieldWording }) }));
+            // A definition nested inside itself draws its fields only for a level the
+            // value holds; an absent level is one Add button, so the nesting stops at the data.
+            if (args.expanded.has(model.shape) && !isRecord(value)) {
+                return (_jsx(CollapsedObjectField, { heading: heading, description: description, error: error, definition: args.definition, shape: model.shape, root: root, onChange: onChange }));
+            }
+            return (_jsx(FieldGroup, { heading: heading, description: description, error: error, atRoot: path === '', children: _jsx(ObjectFields, { properties: model.properties, shape: model.shape, requiredKeys: model.required, root: root, value: value, onChange: onChange, path: path, errors: errors, idPrefix: idPrefix, skip: undefined, fieldWording: fieldWording }) }));
         case 'record':
             return (_jsx(RecordField, { heading: heading, description: description, error: error, values: model.values, root: root, value: value, onChange: onChange, path: path, errors: errors, idPrefix: idPrefix }));
         case 'union':