@bendyline/squisq 1.3.0 → 1.4.0

package/dist/jsonForm/chooseControl.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pick a `ControlKind` for a schema node. The single dispatcher used by
+ * both `<JsonView>` and `<JsonEditor>` so view and edit modes always
+ * agree on what each field _is_, even when their UIs differ.
+ *
+ * Order of precedence:
+ *   1. Explicit `squisq.control` hint
+ *   2. `format` keyword (color/date/time/datetime/markdown/textarea)
+ *   3. Enum cardinality (segmented vs. combobox)
+ *   4. Numeric range (slider when both min and max present)
+ *   5. String length (multiline when maxLength > 200)
+ *   6. Type-default (object/array/boolean/string/number)
+ */
+import type { ControlKind, SquisqAnnotatedSchema } from './types.js';
+export declare function chooseControl(schema: SquisqAnnotatedSchema): ControlKind;
+/** Return the first concrete type of a schema, ignoring `null` for nullable shorthand. */
+export declare function primaryType(schema: SquisqAnnotatedSchema): string | undefined;
+/** Inspect `items` to decide whether an array holds objects or primitives. */
+export declare function arrayItemKind(schema: SquisqAnnotatedSchema): 'object' | 'primitive';
+//# sourceMappingURL=chooseControl.d.ts.map

package/dist/jsonForm/chooseControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chooseControl.d.ts","sourceRoot":"","sources":["../../src/jsonForm/chooseControl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAKrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,WAAW,CA+CxE;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,QAAQ,GAAG,WAAW,CAInF"}

package/dist/jsonForm/chooseControl.js

@@ -0,0 +1,82 @@
+/**
+ * Pick a `ControlKind` for a schema node. The single dispatcher used by
+ * both `<JsonView>` and `<JsonEditor>` so view and edit modes always
+ * agree on what each field _is_, even when their UIs differ.
+ *
+ * Order of precedence:
+ *   1. Explicit `squisq.control` hint
+ *   2. `format` keyword (color/date/time/datetime/markdown/textarea)
+ *   3. Enum cardinality (segmented vs. combobox)
+ *   4. Numeric range (slider when both min and max present)
+ *   5. String length (multiline when maxLength > 200)
+ *   6. Type-default (object/array/boolean/string/number)
+ */
+const ENUM_SEGMENTED_LIMIT = 4;
+const MULTILINE_LENGTH_THRESHOLD = 200;
+export function chooseControl(schema) {
+    const hint = schema.squisq?.control;
+    if (hint)
+        return hint;
+    const type = primaryType(schema);
+    if (schema.format && type === 'string') {
+        switch (schema.format) {
+            case 'color':
+                return 'color';
+            case 'date':
+                return 'date';
+            case 'time':
+                return 'time';
+            case 'date-time':
+                return 'datetime';
+            case 'markdown':
+                return 'richtext';
+            case 'textarea':
+                return 'multiline';
+        }
+    }
+    if (schema.enum && schema.enum.length > 0) {
+        return schema.enum.length <= ENUM_SEGMENTED_LIMIT ? 'segmented' : 'combobox';
+    }
+    if (schema.oneOf || schema.anyOf)
+        return 'tabs';
+    switch (type) {
+        case 'array':
+            return arrayItemKind(schema) === 'object' ? 'card-stack' : 'chip-bin';
+        case 'object':
+            return 'group';
+        case 'boolean':
+            return 'toggle';
+        case 'integer':
+        case 'number':
+            return hasFiniteRange(schema) ? 'slider' : 'stepper';
+        case 'string':
+            if (typeof schema.maxLength === 'number' && schema.maxLength > MULTILINE_LENGTH_THRESHOLD) {
+                return 'multiline';
+            }
+            return 'text';
+        default:
+            return 'text';
+    }
+}
+/** Return the first concrete type of a schema, ignoring `null` for nullable shorthand. */
+export function primaryType(schema) {
+    const t = schema.type;
+    if (typeof t === 'string')
+        return t;
+    if (Array.isArray(t))
+        return t.find((x) => x !== 'null');
+    return undefined;
+}
+/** Inspect `items` to decide whether an array holds objects or primitives. */
+export function arrayItemKind(schema) {
+    const items = Array.isArray(schema.items) ? schema.items[0] : schema.items;
+    if (!items)
+        return 'primitive';
+    return primaryType(items) === 'object' ? 'object' : 'primitive';
+}
+function hasFiniteRange(schema) {
+    const min = schema.minimum ?? schema.exclusiveMinimum;
+    const max = schema.maximum ?? schema.exclusiveMaximum;
+    return typeof min === 'number' && typeof max === 'number';
+}
+//# sourceMappingURL=chooseControl.js.map

package/dist/jsonForm/chooseControl.js.map

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

package/dist/jsonForm/evaluateWhen.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Evaluate a `SquisqWhen` rule against the current root data. Pure;
+ * renderers call this on every render with fresh data.
+ */
+import type { SquisqWhen } from './types.js';
+export declare function evaluateWhen(when: SquisqWhen, rootData: unknown): boolean;
+/**
+ * Resolve a `boolean | SquisqWhen` flag (used by `hidden`/`disabled`)
+ * to a final boolean. Literal booleans pass through.
+ */
+export declare function resolveFlag(flag: boolean | SquisqWhen | undefined, rootData: unknown): boolean;
+//# sourceMappingURL=evaluateWhen.d.ts.map

package/dist/jsonForm/evaluateWhen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluateWhen.d.ts","sourceRoot":"","sources":["../../src/jsonForm/evaluateWhen.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG7C,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAsBzE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAI9F"}

package/dist/jsonForm/evaluateWhen.js

@@ -0,0 +1,65 @@
+/**
+ * Evaluate a `SquisqWhen` rule against the current root data. Pure;
+ * renderers call this on every render with fresh data.
+ */
+import { getByPointer } from './pointer.js';
+export function evaluateWhen(when, rootData) {
+    const actual = getByPointer(rootData, when.field);
+    if (when.equals !== undefined) {
+        return deepEqual(actual, when.equals);
+    }
+    if (when.oneOf !== undefined) {
+        return when.oneOf.some((v) => deepEqual(actual, v));
+    }
+    if (when.matches !== undefined) {
+        if (typeof actual !== 'string')
+            return false;
+        try {
+            return new RegExp(when.matches).test(actual);
+        }
+        catch {
+            return false;
+        }
+    }
+    if (when.truthy !== undefined) {
+        return Boolean(actual) === when.truthy;
+    }
+    // No operator specified — defaults to "field has any defined value".
+    return actual !== undefined && actual !== null;
+}
+/**
+ * Resolve a `boolean | SquisqWhen` flag (used by `hidden`/`disabled`)
+ * to a final boolean. Literal booleans pass through.
+ */
+export function resolveFlag(flag, rootData) {
+    if (flag === undefined)
+        return false;
+    if (typeof flag === 'boolean')
+        return flag;
+    return evaluateWhen(flag, rootData);
+}
+function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === null || b === null)
+        return false;
+    if (typeof a !== typeof b)
+        return false;
+    if (typeof a !== 'object')
+        return false;
+    if (Array.isArray(a)) {
+        if (!Array.isArray(b) || a.length !== b.length)
+            return false;
+        return a.every((v, i) => deepEqual(v, b[i]));
+    }
+    if (Array.isArray(b))
+        return false;
+    const ao = a;
+    const bo = b;
+    const ak = Object.keys(ao);
+    const bk = Object.keys(bo);
+    if (ak.length !== bk.length)
+        return false;
+    return ak.every((k) => deepEqual(ao[k], bo[k]));
+}
+//# sourceMappingURL=evaluateWhen.js.map

package/dist/jsonForm/evaluateWhen.js.map

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

package/dist/jsonForm/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `@bendyline/squisq/jsonForm` — headless JSON Form logic.
+ *
+ * Pure utilities consumed by `<JsonView>` (read-only) in
+ * `@bendyline/squisq-react` and `<JsonEditor>` (editable) in
+ * `@bendyline/squisq-editor-react`. Zero React deps.
+ */
+export type { ControlKind, SquisqHints, SquisqWhen, SquisqAnnotatedSchema, JsonFormValidationError, JsonFormValidator, } from './types.js';
+export { chooseControl, primaryType, arrayItemKind } from './chooseControl.js';
+export { evaluateWhen, resolveFlag } from './evaluateWhen.js';
+export { toPointer, pointerSegments, getByPointer, setByPointer, resolveRef } from './pointer.js';
+export { inferSchema } from './inferSchema.js';
+export type { InferSchemaOptions } from './inferSchema.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/jsonForm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jsonForm/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/jsonForm/index.js

@@ -0,0 +1,12 @@
+/**
+ * `@bendyline/squisq/jsonForm` — headless JSON Form logic.
+ *
+ * Pure utilities consumed by `<JsonView>` (read-only) in
+ * `@bendyline/squisq-react` and `<JsonEditor>` (editable) in
+ * `@bendyline/squisq-editor-react`. Zero React deps.
+ */
+export { chooseControl, primaryType, arrayItemKind } from './chooseControl.js';
+export { evaluateWhen, resolveFlag } from './evaluateWhen.js';
+export { toPointer, pointerSegments, getByPointer, setByPointer, resolveRef } from './pointer.js';
+export { inferSchema } from './inferSchema.js';
+//# sourceMappingURL=index.js.map

package/dist/jsonForm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jsonForm/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAClG,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/jsonForm/inferSchema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Infer a JSON Schema from an example JSON value. Thin facade over
+ * `genson-js` so consumers don't depend on it directly and we can swap
+ * the implementation later.
+ */
+import type { SquisqAnnotatedSchema } from './types.js';
+export interface InferSchemaOptions {
+    /** Additional samples merged into the inferred schema for broader coverage. */
+    additionalSamples?: readonly unknown[];
+}
+export declare function inferSchema(sample: unknown, options?: InferSchemaOptions): SquisqAnnotatedSchema;
+//# sourceMappingURL=inferSchema.d.ts.map

package/dist/jsonForm/inferSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferSchema.d.ts","sourceRoot":"","sources":["../../src/jsonForm/inferSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,iBAAiB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACxC;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,OAAO,EACf,OAAO,GAAE,kBAAuB,GAC/B,qBAAqB,CAOvB"}

package/dist/jsonForm/inferSchema.js

@@ -0,0 +1,15 @@
+/**
+ * Infer a JSON Schema from an example JSON value. Thin facade over
+ * `genson-js` so consumers don't depend on it directly and we can swap
+ * the implementation later.
+ */
+import { createSchema, mergeSchemas } from 'genson-js';
+export function inferSchema(sample, options = {}) {
+    const base = createSchema(sample);
+    if (!options.additionalSamples || options.additionalSamples.length === 0) {
+        return base;
+    }
+    const extras = options.additionalSamples.map((s) => createSchema(s));
+    return mergeSchemas([base, ...extras]);
+}
+//# sourceMappingURL=inferSchema.js.map

package/dist/jsonForm/inferSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inferSchema.js","sourceRoot":"","sources":["../../src/jsonForm/inferSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQvD,MAAM,UAAU,WAAW,CACzB,MAAe,EACf,UAA8B,EAAE;IAEhC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAA0B,CAAC;IAC3D,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,CAA0B,CAAC,CAAC;IAC9F,OAAO,YAAY,CAAC,CAAC,IAAI,EAAE,GAAG,MAAM,CAAY,CAA0B,CAAC;AAC7E,CAAC"}

package/dist/jsonForm/pointer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * JSON Pointer helpers (RFC 6901) plus immutable get/set, plus a tiny
+ * dotted-path normalizer so hosts can write `user.role` instead of
+ * `/user/role`. `$ref` resolution is local-only (`#/$defs/Foo`).
+ */
+import type { SquisqAnnotatedSchema } from './types.js';
+/** Normalize a path to a JSON Pointer string. Accepts both forms. */
+export declare function toPointer(path: string): string;
+/** Split a JSON Pointer into decoded segments. Empty string → []. */
+export declare function pointerSegments(pointer: string): string[];
+/** Read a value from data by path (dotted or pointer). Returns undefined if missing. */
+export declare function getByPointer(data: unknown, path: string): unknown;
+/**
+ * Return a structurally-shared copy of `data` with the value at `path`
+ * replaced. Intermediate objects/arrays are cloned along the path; the
+ * rest is shared by reference. Creates intermediate objects if missing.
+ */
+export declare function setByPointer<T>(data: T, path: string, value: unknown): T;
+/**
+ * Resolve a local `$ref` (e.g. `#/$defs/Foo`) against the root schema.
+ * Returns the original schema if no `$ref` is present, or `undefined`
+ * if the reference cannot be resolved. Cross-document refs are not
+ * supported.
+ */
+export declare function resolveRef(schema: SquisqAnnotatedSchema, root: SquisqAnnotatedSchema): SquisqAnnotatedSchema | undefined;
+//# sourceMappingURL=pointer.d.ts.map

package/dist/jsonForm/pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer.d.ts","sourceRoot":"","sources":["../../src/jsonForm/pointer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,qEAAqE;AACrE,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW9C;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAMzD;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAgBjE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAIxE;AA6BD;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,MAAM,EAAE,qBAAqB,EAC7B,IAAI,EAAE,qBAAqB,GAC1B,qBAAqB,GAAG,SAAS,CAWnC"}

package/dist/jsonForm/pointer.js

@@ -0,0 +1,102 @@
+/**
+ * JSON Pointer helpers (RFC 6901) plus immutable get/set, plus a tiny
+ * dotted-path normalizer so hosts can write `user.role` instead of
+ * `/user/role`. `$ref` resolution is local-only (`#/$defs/Foo`).
+ */
+/** Normalize a path to a JSON Pointer string. Accepts both forms. */
+export function toPointer(path) {
+    if (path === '' || path === '/')
+        return '';
+    if (path.startsWith('/'))
+        return path;
+    // Dotted form: split on `.` and escape per RFC 6901.
+    return ('/' +
+        path
+            .split('.')
+            .map((seg) => seg.replace(/~/g, '~0').replace(/\//g, '~1'))
+            .join('/'));
+}
+/** Split a JSON Pointer into decoded segments. Empty string → []. */
+export function pointerSegments(pointer) {
+    if (pointer === '')
+        return [];
+    return pointer
+        .slice(1)
+        .split('/')
+        .map((seg) => seg.replace(/~1/g, '/').replace(/~0/g, '~'));
+}
+/** Read a value from data by path (dotted or pointer). Returns undefined if missing. */
+export function getByPointer(data, path) {
+    const segments = pointerSegments(toPointer(path));
+    let cur = data;
+    for (const seg of segments) {
+        if (cur === null || cur === undefined)
+            return undefined;
+        if (Array.isArray(cur)) {
+            const idx = Number(seg);
+            if (!Number.isInteger(idx) || idx < 0 || idx >= cur.length)
+                return undefined;
+            cur = cur[idx];
+        }
+        else if (typeof cur === 'object') {
+            cur = cur[seg];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return cur;
+}
+/**
+ * Return a structurally-shared copy of `data` with the value at `path`
+ * replaced. Intermediate objects/arrays are cloned along the path; the
+ * rest is shared by reference. Creates intermediate objects if missing.
+ */
+export function setByPointer(data, path, value) {
+    const segments = pointerSegments(toPointer(path));
+    if (segments.length === 0)
+        return value;
+    return setRec(data, segments, 0, value);
+}
+function setRec(node, segments, i, value) {
+    const seg = segments[i];
+    const isLast = i === segments.length - 1;
+    // Decide whether the slot we're about to write into is an array index.
+    const nextSeg = isLast ? undefined : segments[i + 1];
+    const writingArrayChild = nextSeg !== undefined && /^\d+$/.test(nextSeg);
+    if (Array.isArray(node)) {
+        const idx = Number(seg);
+        const next = node.slice();
+        next[idx] = isLast
+            ? value
+            : setRec(node[idx] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);
+        return next;
+    }
+    const obj = (node && typeof node === 'object' ? { ...node } : {});
+    obj[seg] = isLast
+        ? value
+        : setRec(obj[seg] ?? (writingArrayChild ? [] : {}), segments, i + 1, value);
+    return obj;
+}
+/**
+ * Resolve a local `$ref` (e.g. `#/$defs/Foo`) against the root schema.
+ * Returns the original schema if no `$ref` is present, or `undefined`
+ * if the reference cannot be resolved. Cross-document refs are not
+ * supported.
+ */
+export function resolveRef(schema, root) {
+    if (!schema.$ref)
+        return schema;
+    const ref = schema.$ref;
+    if (!ref.startsWith('#/'))
+        return undefined;
+    const segments = pointerSegments(ref.slice(1));
+    let cur = root;
+    for (const seg of segments) {
+        if (cur === null || cur === undefined || typeof cur !== 'object')
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur ?? undefined;
+}
+//# sourceMappingURL=pointer.js.map

package/dist/jsonForm/pointer.js.map

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

package/dist/jsonForm/types.d.ts

@@ -0,0 +1,120 @@
+/**
+ * JSON Form types — Squisq's hint vocabulary layered on JSON Schema.
+ *
+ * Hints live inline on a JSON Schema under a single `squisq` key. The
+ * schema remains a valid JSON Schema; the extra key is ignored by
+ * standard validators. Renderers consult the hints to pick a control
+ * and tune its presentation.
+ */
+/**
+ * Every concrete control rendered by `<JsonView>` and `<JsonEditor>`.
+ *
+ * Auto-defaults pick one based on schema shape; hosts override via
+ * `squisq.control` when they want something specific (e.g. radio over
+ * segmented for a long, descriptive enum).
+ */
+export type ControlKind = 'text' | 'multiline' | 'richtext' | 'color' | 'date' | 'time' | 'datetime' | 'slider' | 'stepper' | 'segmented' | 'radio' | 'combobox' | 'toggle' | 'checkbox' | 'card' | 'card-stack' | 'chip-bin' | 'tabs' | 'group';
+/**
+ * Conditional rule: looked up by field path against the root data and
+ * compared with one of the operators. The first defined operator wins
+ * (in declaration order: equals, oneOf, matches, truthy).
+ */
+export interface SquisqWhen {
+    /**
+     * Path to the controlling field, relative to the root data.
+     * Accepts dotted-path (`user.role`) or JSON Pointer (`/user/role`).
+     */
+    field: string;
+    equals?: unknown;
+    oneOf?: readonly unknown[];
+    /** ECMAScript regex source; matched against the string value. */
+    matches?: string;
+    /** When true, condition holds if value is truthy; when false, if falsy. */
+    truthy?: boolean;
+}
+/**
+ * Hints for a single schema node. Attach via `squisq` on any JSON
+ * Schema object — properties, items, the root, or sub-schemas inside
+ * `oneOf`/`anyOf`.
+ */
+export interface SquisqHints {
+    /** Force a specific control. If omitted, picked from type/format/enum cardinality. */
+    control?: ControlKind;
+    /** Override schema `title` for display. */
+    label?: string;
+    /** Override schema `description` for the inline helper text. */
+    help?: string;
+    /** Placeholder text for empty fields. */
+    placeholder?: string;
+    /** Suggested layout sizing in a parent grid. Renderers may ignore on narrow viewports. */
+    width?: 'full' | 'half' | 'third' | 'auto';
+    /** Hide the field — literal, or a `SquisqWhen` evaluated against root data. */
+    hidden?: boolean | SquisqWhen;
+    /** Disable the field — literal, or a `SquisqWhen` evaluated against root data. */
+    disabled?: boolean | SquisqWhen;
+    /** Override schema's required-ness for the UI only. */
+    required?: boolean;
+    /** For arrays of objects: how to label each card in a `card-stack`. */
+    itemLabel?: string | {
+        fromField: string;
+    };
+    /** Label for the "+ Add" button on arrays. */
+    addLabel?: string;
+    /** Label for the remove button on arrays. */
+    removeLabel?: string;
+    /** Slider/stepper visual step. Falls back to schema `multipleOf`. */
+    step?: number;
+    /** Optional human-readable labels for enum values. */
+    enumLabels?: Record<string, string>;
+}
+/**
+ * The subset of JSON Schema we understand, with an optional `squisq`
+ * key. We deliberately keep this as a structural type so any JSON
+ * Schema authored elsewhere can be passed in without conversion.
+ */
+export interface SquisqAnnotatedSchema {
+    type?: string | readonly string[];
+    format?: string;
+    title?: string;
+    description?: string;
+    default?: unknown;
+    examples?: readonly unknown[];
+    enum?: readonly unknown[];
+    const?: unknown;
+    properties?: Record<string, SquisqAnnotatedSchema>;
+    required?: readonly string[];
+    additionalProperties?: boolean | SquisqAnnotatedSchema;
+    items?: SquisqAnnotatedSchema | readonly SquisqAnnotatedSchema[];
+    minItems?: number;
+    maxItems?: number;
+    minimum?: number;
+    maximum?: number;
+    exclusiveMinimum?: number;
+    exclusiveMaximum?: number;
+    multipleOf?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    oneOf?: readonly SquisqAnnotatedSchema[];
+    anyOf?: readonly SquisqAnnotatedSchema[];
+    allOf?: readonly SquisqAnnotatedSchema[];
+    $ref?: string;
+    $defs?: Record<string, SquisqAnnotatedSchema>;
+    definitions?: Record<string, SquisqAnnotatedSchema>;
+    squisq?: SquisqHints;
+}
+/**
+ * A validation error reported by the consumer-supplied `validate` prop.
+ * Matches the shape of common validators (ajv, etc.) without depending
+ * on any specific one.
+ */
+export interface JsonFormValidationError {
+    /** JSON Pointer to the failing value, e.g. `/sections/0/heading`. */
+    path: string;
+    /** Human-readable message. */
+    message: string;
+    /** Optional schema keyword that failed (e.g. "required", "minimum"). */
+    keyword?: string;
+}
+export type JsonFormValidator = (value: unknown, schema: SquisqAnnotatedSchema) => readonly JsonFormValidationError[];
+//# sourceMappingURL=types.d.ts.map

package/dist/jsonForm/types.d.ts.map

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

package/dist/jsonForm/types.js

@@ -0,0 +1,10 @@
+/**
+ * JSON Form types — Squisq's hint vocabulary layered on JSON Schema.
+ *
+ * Hints live inline on a JSON Schema under a single `squisq` key. The
+ * schema remains a valid JSON Schema; the extra key is ignored by
+ * standard validators. Renderers consult the hints to pick a control
+ * and tune its presentation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/jsonForm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/jsonForm/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/markdown/convert.d.ts

@@ -9,7 +9,7 @@
  * The conversion is designed for perfect round-tripping:
  * toMdast(fromMdast(tree)) should produce an equivalent mdast tree.
  */
-import type { MarkdownDocument } from './types.js';
+import type { MarkdownDocument, MarkdownInlineNode } from './types.js';
 /**
  * Minimal interface for mdast/unist nodes.
  * Using a generic shape avoids hard dependency on @types/mdast
@@ -60,6 +60,16 @@ interface MdastNode {
 export declare function fromMdast(root: MdastNode, options?: {
     parseHtml?: boolean;
 }): MarkdownDocument;
+/**
+ * Walk an inline-children list and split each text node on `{[token]}`
+ * occurrences whose tokens resolve to known FontAwesome icons. Returns
+ * a new array — unresolved tokens are left as literal text so authors
+ * can write `{[notathing]}` verbatim if they really mean to.
+ *
+ * Exposed for the heading code path, which first strips the trailing
+ * template annotation and then runs this on what remains.
+ */
+export declare function splitInlineIcons(nodes: MarkdownInlineNode[]): MarkdownInlineNode[];
 /**
  * Convert a MarkdownDocument back to an mdast Root node.
  *

package/dist/markdown/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/markdown/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,gBAAgB,EASjB,MAAM,YAAY,CAAC;AAOpB;;;;GAIG;AACH,UAAU,aAAa;IACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAmKD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,CAO9F;AA0YD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAMxD"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../src/markdown/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAEhB,kBAAkB,EAQnB,MAAM,YAAY,CAAC;AAQpB;;;;GAIG;AACH,UAAU,aAAa;IACrB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzD,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxD;AAED,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAwKD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,gBAAgB,CAO9F;AA6BD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,EAAE,CAiBlF;AA8cD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,CAMxD"}