@tai42/studio-sdk 9.2.1 → 9.3.0

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

@@ -1,40 +1,33 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { Suspense, lazy, useCallback, useContext, useMemo, useState } from 'react';
+import { Suspense, useCallback, useContext, useMemo, useState } from 'react';
 import { CompletionInput } from '../components/completion-input';
 import { Field } from '../components/field';
 import { AlertTriangleIcon } from '../components/icons';
 import { TextInput, Textarea } from '../components/inputs';
 import { errorMessage } from '../errors';
-import { CompletionProviderContext } from './context';
+import { CompletionProviderContext, ExpressionFieldContext } from './context';
 import { MediaField } from './media-field';
-// The lazily-loaded jq door. Defining it at module scope (never inside a
-// component) is what keeps the lazy component's identity stable across renders,
-// so React resolves the chunk once and never re-suspends a mounted field. The
-// `import('../jq')` here is a DYNAMIC import — the sole runtime edge from
-// `schema-form` to the jq door — so the visual editor, worker, and wasm live in
-// a split chunk that a non-annotated form never requests. The `type`-only
-// import of `JqInputShapeDescriptor` above is erased at compile time and adds no
-// such edge.
-const JqField = lazy(async () => {
-    const { JqField } = await import('../jq');
-    return { default: JqField };
-});
 export function StringField({ heading, description, error, format, media, expression, argName, value, required, onChange, }) {
     const completionProvider = useContext(CompletionProviderContext);
+    const expressionField = useContext(ExpressionFieldContext);
     const current = typeof value === 'string' ? value : '';
     // An empty optional field emits `undefined` (drops the key); a required one
     // keeps the empty string so validation can flag it.
     const emit = (next) => {
         onChange(next === '' && !required ? undefined : next);
     };
-    // An expression-annotated field renders the jq field — the resting control plus
-    // the visual-editor door. Checked before `media` because the expression
+    // An expression-annotated field renders the injected door — the resting control
+    // plus its visual-editor button. Checked before `media` because the expression
     // annotation is the more specific, deliberate opt-in (`x-tai42-expression`);
-    // a schema carrying both is contradictory, and a jq expression is text, not an
+    // a schema carrying both is contradictory, and an expression is text, not an
     // upload. Not reachable together with the completion provider path: an
     // expression is authored, not completed from server suggestions.
-    if (expression !== undefined) {
-        return (_jsx(JqExpressionField, { heading: heading, description: description, error: error, expression: expression, argName: argName, value: current, onChange: emit }));
+    //
+    // With no door injected the annotation is INERT: the field falls through to the
+    // ordinary paths below, exactly as a malformed annotation does, so a form
+    // renders the same bytes either way.
+    if (expression !== undefined && expressionField !== undefined) {
+        return (_jsx(ExpressionField, { component: expressionField, heading: heading, description: description, error: error, expression: expression, argName: argName, value: current, onChange: emit }));
     }
     // A media-annotated field renders the upload control instead of a text box.
     if (media !== undefined) {
@@ -74,51 +67,51 @@ function CompletionField({ argName, value, onChange, provider, }) {
                 }, fetchCompletions: fetchCompletions, onError: onError }), failure === null ? null : (_jsxs("p", { role: "status", className: "tai-field-hint", style: { margin: 0 }, children: [_jsx(AlertTriangleIcon, {}), `Suggestions are unavailable: ${failure}`] }))] }));
 }
 /**
- * An expression-annotated string field, rendered as `JqField`: a multiline
- * resting control with the always-present visual-editor door. `JqField` 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 jq-studio's input-shape descriptor, and the form's per-field error
- * feeds the `error` prop.
+ * An expression-annotated string 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`.
  *
- * Deliberately unwired:
- * - `serverValidate` — no author-time validation endpoint applies to a
- *   schema-declared field (the WASM runtime still powers the Test panel locally).
- * - `onEditorOpenChange` — the hosts that render `SchemaForm` register no global
- *   keyboard shortcuts, so there is nothing to mute while the editor is open.
- * - `compact` — the form renders every sibling field with a visible label;
- *   the compact variant (visually-hidden label, icon-only door) is for dense
- *   host rows, which the schema form does not have.
+ * 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.
  *
- * The door is code-split ({@link JqField} is a `lazy` component), so it mounts
- * inside a `Suspense` boundary. Its 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 the chunk resolves, and the swap to the live door does not flash.
+ * 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).
  */
-function JqExpressionField({ heading, description, error, expression, argName, value, onChange, }) {
-    // Memoised: the descriptor's identity feeds jq-studio's own memoisation, so a
+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(JqExpressionFieldSkeleton, { heading: heading, description: description, error: error, value: value }), children: _jsx(JqField, { label: heading, description: description, error: error, shape: shape, multiline: true, value: value, onChange: onChange }) }));
+    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 the jq door chunk loads. It mirrors the live
- * door's footprint — the same label/description/error chrome wrapping a
+ * 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 inert
  * (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 JqExpressionFieldSkeleton({ heading, description, error, value, }) {
+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 jq-studio's input-shape
- * descriptor. A bare annotation (`language` only) maps to NO descriptor — the
- * undeclared-shape `JqField` 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.
+ * 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 !== undefined ||

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tai42/studio-sdk",
-  "version": "9.2.1",
+  "version": "9.3.0",
   "description": "The Studio plugin contract, shared UI components, and hooks that every feature builds on.",
   "license": "Apache-2.0",
   "author": "tai42 <oss@tai42.ai>",
@@ -44,6 +44,10 @@
       "types": "./dist/testing.d.ts",
       "import": "./dist/testing.js"
     },
+    "./schema-form": {
+      "types": "./dist/schema-form/index.d.ts",
+      "import": "./dist/schema-form/index.js"
+    },
     "./tokens.css": "./dist/components/tokens.css",
     "./fonts.css": "./dist/components/fonts.css",
     "./components.css": "./dist/components/components.css",
@@ -91,7 +95,7 @@
     "@radix-ui/react-tabs": "^1.1.16",
     "@radix-ui/react-tooltip": "^1.2.11",
     "@tai42/jq-studio": "^0.1.3",
-    "@tai42/api-client": "9.2.1"
+    "@tai42/api-client": "9.3.0"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json && node scripts/copy-assets.mjs",
@@ -99,7 +103,7 @@
     "lint": "eslint src scripts --max-warnings 0",
     "format:check": "prettier --check \"src/**/*.{ts,tsx,css}\" \"scripts/**/*.mjs\"",
     "test": "vitest run",
-    "api:check": "api-extractor run --config config/api-extractor.index.json && api-extractor run --config config/api-extractor.host.json && api-extractor run --config config/api-extractor.testing.json",
-    "api:update": "api-extractor run --local --config config/api-extractor.index.json && api-extractor run --local --config config/api-extractor.host.json && api-extractor run --local --config config/api-extractor.testing.json"
+    "api:check": "api-extractor run --config config/api-extractor.index.json && api-extractor run --config config/api-extractor.host.json && api-extractor run --config config/api-extractor.testing.json && api-extractor run --config config/api-extractor.schema-form.json",
+    "api:update": "api-extractor run --local --config config/api-extractor.index.json && api-extractor run --local --config config/api-extractor.host.json && api-extractor run --local --config config/api-extractor.testing.json && api-extractor run --local --config config/api-extractor.schema-form.json"
   }
 }

package/src/index.ts

@@ -372,6 +372,12 @@ export type { IconProps, IconComponent } from './components/icons';
 export {
   SchemaForm,
   RecordEntryRendererContext,
+  // The expression-door injection point: a host that wants `x-tai42-expression`
+  // fields to author through the visual editor hands `JqField` to a form (the
+  // `expressionField` prop) or mounts this context above its tree. A form with no
+  // door renders those fields as plain string inputs and stays free of the jq
+  // subgraph — the editor, its worker, and its wasm — entirely.
+  ExpressionFieldContext,
   SecretRefField,
   defaultValueForSchema,
   validateAgainstSchema,
@@ -382,6 +388,10 @@ export type {
   CompletionProvider,
   RecordEntryRenderer,
   RecordEntryContext,
+  ExpressionFieldComponent,
+  ExpressionFieldProps,
+  ExpressionInputShape,
+  ExpressionInputKey,
   SecretRefFieldProps,
   SecretRef,
   JsonSchema,

package/src/jq.ts

@@ -6,6 +6,14 @@
  * the drop-in `JqField`, the lower-level `JqEditorDialog`, the agnostic
  * field-declaration contract, and the runtime loader/worker helpers.
  *
+ * NOTHING IN THE SDK IMPORTS THIS MODULE. Every edge to it runs the other way: a
+ * host imports `JqField` from here and hands it in — to a `SchemaForm` through its
+ * `expressionField` prop or the ambient `ExpressionFieldContext`, or straight into
+ * its own JSX. That is what keeps this heavy subgraph — the visual editor, its
+ * worker file, and its wasm engine — OUT of the bundle of a consumer that imports
+ * the SDK for anything else; a bundler emits a dynamic import's chunks as surely
+ * as a static import's, so `lazy` inside the SDK would not have kept them out.
+ *
  * BUNDLE + WORKER SHARING. A plugin bundle externalises `@tai42/studio-sdk`, so
  * the SDK — and the one copy of `@tai42/jq-studio` it carries — ships once for the
  * whole deployment. A plugin that renders `JqField` shares the host's single jq

package/src/schema-form/SchemaForm.tsx

@@ -32,10 +32,26 @@
  * validator ignores it); these client-side caps are UX guards, and the SERVER
  * MUST independently validate the decoded size. The base64 decoding and cap
  * checks live in the sibling `media` module.
+ *
+ * EXPRESSION FIELDS ARE OPT-IN. A string field carrying `x-tai42-expression`
+ * renders an expression-authoring door — the SDK's `JqField` — only when the host
+ * INJECTS one, through {@link SchemaFormProps.expressionField} or the ambient
+ * {@link ExpressionFieldContext}; with no door it renders the plain string input.
+ * The form owns no edge to the door: importing it here, even dynamically behind
+ * `lazy`, would EMIT the visual editor, its worker file, and a multi-megabyte wasm
+ * engine into every consumer that bundles the SDK to render forms, whether or not
+ * a form ever authors an expression. Injection puts that weight on the hosts that
+ * want it and only there.
  */
 import type { ReactNode } from 'react';
+import { useContext } from 'react';
 
-import { CompletionProviderContext, MaxUploadBytesContext } from './context';
+import type { ExpressionFieldComponent } from './context';
+import {
+  CompletionProviderContext,
+  ExpressionFieldContext,
+  MaxUploadBytesContext,
+} from './context';
 import { FieldNode } from './field-node';
 import { DEFAULT_MAX_UPLOAD_BYTES } from './media';
 import { stackClass } from './styles';
@@ -70,6 +86,14 @@ export interface SchemaFormProps {
    * absent both, {@link DEFAULT_MAX_UPLOAD_BYTES} applies.
    */
   readonly maxUploadBytes?: number;
+  /**
+   * Optional. The expression-authoring door for `x-tai42-expression` fields —
+   * the SDK's `JqField`, which the host imports directly and passes here (see
+   * the module doc-comment). Omitted, the enclosing
+   * {@link ExpressionFieldContext} supplies it; absent both, an annotated field
+   * renders the plain string input.
+   */
+  readonly expressionField?: ExpressionFieldComponent;
 }
 
 /**
@@ -84,23 +108,30 @@ export function SchemaForm({
   idPrefix = 'schema-form',
   completionProvider,
   maxUploadBytes = DEFAULT_MAX_UPLOAD_BYTES,
+  expressionField,
 }: SchemaFormProps): ReactNode {
+  // The prop overrides the ambient door for this form only; omitted, the
+  // enclosing one flows through unchanged (providing `undefined` would BLIND the
+  // form to a door the host wired above it).
+  const ambientExpressionField = useContext(ExpressionFieldContext);
   return (
     <CompletionProviderContext.Provider value={completionProvider}>
       <MaxUploadBytesContext.Provider value={maxUploadBytes}>
-        <div className={stackClass} data-testid={idPrefix}>
-          <FieldNode
-            schema={schema}
-            root={schema}
-            value={value}
-            onChange={onChange}
-            path=""
-            label={undefined}
-            required
-            errors={errors}
-            idPrefix={idPrefix}
-          />
-        </div>
+        <ExpressionFieldContext.Provider value={expressionField ?? ambientExpressionField}>
+          <div className={stackClass} data-testid={idPrefix}>
+            <FieldNode
+              schema={schema}
+              root={schema}
+              value={value}
+              onChange={onChange}
+              path=""
+              label={undefined}
+              required
+              errors={errors}
+              idPrefix={idPrefix}
+            />
+          </div>
+        </ExpressionFieldContext.Provider>
       </MaxUploadBytesContext.Provider>
     </CompletionProviderContext.Provider>
   );

package/src/schema-form/context.ts

@@ -1,10 +1,11 @@
 /**
  * Ambient React contexts for the schema-form tree: the optional argument
- * completion provider and the default media-upload byte cap. A field deep in the
- * tree reads these here rather than every intermediate node drilling the prop.
+ * 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
+ * here rather than every intermediate node drilling the prop.
  */
 import { createContext } from 'react';
-import type { ReactNode } from 'react';
+import type { ComponentType, ReactNode } from 'react';
 
 import { DEFAULT_MAX_UPLOAD_BYTES } from './media';
 import type { CompletionProvider } from './SchemaForm';
@@ -44,3 +45,85 @@ export type RecordEntryRenderer = (entry: RecordEntryContext) => ReactNode;
 // Ambient record-entry value renderer for the whole form; the record field reads
 // it here so intermediate object/array/record nodes never drill the prop.
 export const RecordEntryRendererContext = createContext<RecordEntryRenderer | undefined>(undefined);
+
+/** One top-level key of the expression's input document, with a one-line gloss. */
+export interface ExpressionInputKey {
+  readonly name: string;
+  readonly gloss: string;
+}
+
+/**
+ * What `.` IS for an expression-annotated field, as the form hands it to the
+ * injected door. Built by the renderer from the schema's `x-tai42-expression`
+ * annotation.
+ *
+ * Like the annotation type it is built from, this MIRRORS jq-studio's input-shape
+ * descriptor without importing it: the schema-form tree names no jq type, in code
+ * OR in its declarations, which is what keeps a consumer that never injects a door
+ * free of the jq subgraph. `JqField` satisfies it structurally; a test pins that.
+ */
+export interface ExpressionInputShape {
+  /** Stable, host-namespaced id, opaque to the door (memoisation/telemetry). */
+  readonly id: string;
+  /** Short chip label — what `.` is here, e.g. "node envelope". */
+  readonly label: string;
+  /** One sentence: what `.` is in this field. */
+  readonly blurb: string;
+  /** The top-level keys of `.`, each with a one-liner. */
+  readonly keys: readonly ExpressionInputKey[];
+  /** What the expression must RETURN, e.g. "true or false". */
+  readonly returns: string;
+  /** Per-field caveats. */
+  readonly caveats?: readonly string[];
+  /** A static skeleton of `.` for the door's test surface. */
+  readonly sample?: unknown;
+}
+
+/**
+ * Exactly the props the form hands an injected expression field — no more, so any
+ * expression editor can satisfy the contract, and no less, so the form is free to
+ * pass all of them. The label/description/error slots are the door's own chrome:
+ * an expression field brings its a11y-linked label and helper slots, so the form
+ * does NOT wrap it in the usual `Field`.
+ */
+export interface ExpressionFieldProps {
+  readonly label: string;
+  readonly value: string;
+  readonly onChange: (value: string) => void;
+  readonly description?: ReactNode;
+  readonly error?: ReactNode;
+  readonly shape?: ExpressionInputShape;
+  /** Render a multiline resting control; the form always asks for one. */
+  readonly multiline?: boolean;
+}
+
+/**
+ * The expression-authoring door a host INJECTS into the form — `JqField`, imported
+ * by the host straight from the SDK's jq surface.
+ *
+ * It is a COMPONENT, rendered as an element, never called as a function: the door
+ * owns hooks and state (editor open, worker handle), which only survive as its own
+ * element identity. A host may inject a `lazy` door to keep the jq subgraph in a
+ * split chunk — the form mounts it inside a Suspense boundary that paints the
+ * resting shell while that chunk resolves.
+ */
+// The injected reference must be STABLE across renders (a module-level
+// component or memoized value): an inline arrow remounts the door — and drops
+// its open-editor state — on every parent render.
+export type ExpressionFieldComponent = ComponentType<ExpressionFieldProps>;
+
+/**
+ * The ambient door for the whole form. Absent (the default), an
+ * expression-annotated field renders the PLAIN string input, byte-identically to
+ * an unannotated one — the jq authoring door is opt-in, because the dynamic import
+ * that would fetch it on demand still EMITS its chunks, worker, and wasm into
+ * every consumer that bundles the SDK.
+ *
+ * A host wires it ONCE above its tree (`SchemaEditor`'s preview and
+ * `ElicitationForm` render forms a caller does not own the props of, and a plugin
+ * page renders its own); the form's own `expressionField` prop overrides it for a
+ * single form.
+ */
+export const ExpressionFieldContext = createContext<ExpressionFieldComponent | undefined>(
+  undefined,
+);

package/src/schema-form/index.ts

@@ -3,11 +3,43 @@
  * the tools and interactions features. Public surface: the `SchemaForm`
  * component plus the value/validation helpers a caller needs to seed, validate,
  * and submit.
+ *
+ * THE JQ-FREE ENTRY POINT. This module is published as
+ * `@tai42/studio-sdk/schema-form`, and a consumer that BUNDLES the SDK — a
+ * standalone widget rather than a host serving the SDK as a shared module —
+ * should import the form from here rather than from the package barrel. The
+ * barrel re-exports `JqField` off `@tai42/jq-studio`, and a bundler emits that
+ * package's Web Worker file and wasm engine from the mere presence of the
+ * MODULE in the graph: those assets are emitted while the module is transformed,
+ * before tree-shaking can drop the unused re-export. Reaching the form through
+ * this entry point, and injecting the door only where it is wanted (see
+ * `SchemaForm`'s `expressionField`), is what holds a form-only consumer at zero
+ * jq bytes.
+ *
+ * The design system reaches this entry point through relative imports, so the
+ * form renders complete; only the barrel's three CSS side-effect imports stay
+ * behind. A consumer importing from here loads the stylesheets it wants
+ * explicitly (`@tai42/studio-sdk/tokens.css` and `…/components.css`, plus
+ * `…/fonts.css` if it wants the bundled faces).
+ *
+ * For a BUNDLING consumer only. The shell and every Studio plugin externalise
+ * `@tai42/studio-sdk` and resolve it through the served import map, so they must
+ * keep importing the barrel: an import map that serves the barrel alone would
+ * leave this subpath to be bundled, and the second copy's contexts — the
+ * completion provider, the injected expression door — would be different objects
+ * from the ones the host provides.
  */
 export { SchemaForm } from './SchemaForm';
 export type { SchemaFormProps, CompletionProvider } from './SchemaForm';
 export { RecordEntryRendererContext } from './context';
 export type { RecordEntryRenderer, RecordEntryContext } from './context';
+export { ExpressionFieldContext } from './context';
+export type {
+  ExpressionFieldComponent,
+  ExpressionFieldProps,
+  ExpressionInputShape,
+  ExpressionInputKey,
+} from './context';
 export { SecretRefField } from './SecretRefField';
 export type { SecretRefFieldProps, SecretRef } from './SecretRefField';
 export { defaultValueForSchema } from './default-value';