@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/author/authored_fields.d.ts

@@ -0,0 +1,153 @@
+import type { ReactNode } from 'react';
+import { type ZodType } from 'zod';
+import type { PrimitiveNode } from '../define/primitive_module.js';
+/**
+ * Child-element type a schema field is filled from.
+ *
+ * `Symbol.for`: ESM and CJS builds must agree, same as `authorType`.
+ */
+export declare const authoredChild: unique symbol;
+/** Phantom props type for the child component. Not set at runtime. */
+export declare const authoredProps: unique symbol;
+/** Set when a field is filled from text children. */
+export declare const authoredText: unique symbol;
+/** Holds a {@link fromChildren} brand's `toItem`. */
+export declare const authoredToItem: unique symbol;
+/**
+ * A field filled from child elements of `TName`.
+ *
+ * Phantom: `z.infer` still reads the underlying schema. The shim reads `TName`
+ * and `TProps` off the field type, and the symbols off the schema value.
+ */
+export interface AuthoredChildBrand<TName extends string, TProps> {
+    readonly [authoredChild]: TName;
+    readonly [authoredProps]: TProps;
+}
+/** A child field whose `toItem` builds each item, so the shim fills none of the item's own brands. */
+export interface AuthoredToItemBrand {
+    readonly [authoredToItem]: (props: never, context: AuthorChildContext) => unknown;
+}
+/** A field filled from text children. */
+export interface AuthoredTextBrand {
+    readonly [authoredText]: true;
+}
+/** What {@link fromChildren}'s `toItem` receives. */
+export interface AuthorChildContext {
+    /** Nested elements, parsed as body nodes. */
+    parseChildren: (children: ReactNode) => PrimitiveNode[];
+}
+type ArrayItem<TSchema extends ZodType> = NonNullable<zOutput<TSchema>> extends readonly (infer Item)[] ? Item : NonNullable<zOutput<TSchema>>;
+type zInput<TSchema> = TSchema extends {
+    _zod: {
+        input: infer Input;
+    };
+} ? Input : never;
+type zOutput<TSchema> = TSchema extends {
+    _zod: {
+        output: infer Output;
+    };
+} ? Output : never;
+type WrapperOf<TInner> = {
+    _zod: {
+        def: {
+            type: 'optional' | 'nullable' | 'default' | 'readonly';
+            innerType: TInner;
+        };
+    };
+};
+type Unwrapped<TSchema> = TSchema extends WrapperOf<infer Inner> ? Unwrapped<Inner> : TSchema;
+/** Whether `F`, or a wrapper layer of it, carries a {@link fromChildren} brand. */
+type IsChildBranded<F> = F extends AuthoredChildBrand<string, unknown> ? true : F extends WrapperOf<infer Inner> ? IsChildBranded<Inner> : false;
+/** A branded field's item schema: the array element through any wrapper, or the unwrapped schema. */
+export type ItemSchema<TSchema> = Unwrapped<TSchema> extends {
+    element: infer Element;
+} ? Element : Unwrapped<TSchema>;
+/** Item fields a nested {@link fromChildren} brand fills from child elements. */
+type ChildBrandedKeys<TItemSchema> = TItemSchema extends {
+    shape: infer Shape;
+} ? string extends keyof Shape ? never : {
+    [K in keyof Shape]: IsChildBranded<Shape[K]> extends true ? K : never;
+}[keyof Shape] : never;
+/** `TOptional` is optional on the child props because text or child elements fill it. */
+type ChildProps<TItem, TOptional extends PropertyKey> = [TOptional] extends [
+    never
+] ? TItem & {
+    children?: ReactNode;
+} : Omit<TItem, TOptional> & Partial<Pick<TItem, Extract<TOptional, keyof TItem>>> & {
+    children?: ReactNode;
+};
+/**
+ * Brands `schema` as JSX children of `childType`.
+ *
+ * `options.text` copies leftover text onto that field. `options.toItem` replaces
+ * the default prop copy; its props annotation is the child component's props.
+ * The brand is read through `.optional()`, `.nullable()`, `.default()`, and
+ * `.readonly()`; any other method clones without it, so call it on `schema`
+ * before passing it in.
+ */
+export declare function fromChildren<const TName extends string, TSchema extends ZodType>(childType: TName, schema: TSchema): TSchema & AuthoredChildBrand<TName, ChildProps<ArrayItem<TSchema>, ChildBrandedKeys<ItemSchema<TSchema>>>>;
+export declare function fromChildren<const TName extends string, TSchema extends ZodType, const TText extends string>(childType: TName, schema: TSchema, options: {
+    text: TText;
+    toItem?: never;
+}): TSchema & AuthoredChildBrand<TName, ChildProps<ArrayItem<TSchema>, TText | ChildBrandedKeys<ItemSchema<TSchema>>>>;
+export declare function fromChildren<const TName extends string, TSchema extends ZodType, TPropsSchema extends ZodType>(childType: TName, schema: TSchema, options: {
+    text?: string;
+    propsSchema: TPropsSchema;
+    toItem(props: zInput<TPropsSchema> & {
+        children?: ReactNode;
+    }, context: AuthorChildContext): unknown;
+}): TSchema & AuthoredChildBrand<TName, zInput<TPropsSchema> & {
+    children?: ReactNode;
+}> & AuthoredToItemBrand;
+export declare function fromChildren<const TName extends string, TSchema extends ZodType, TProps>(childType: TName, schema: TSchema, options: {
+    text?: string;
+    toItem(props: TProps, context: AuthorChildContext): unknown;
+    propsSchema?: never;
+}): TSchema & AuthoredChildBrand<TName, TProps> & AuthoredToItemBrand;
+/**
+ * Brands `schema` as text children.
+ *
+ * Whitespace collapses unless `collapseWhitespace` is `false`.
+ */
+export declare const fromTextChildren: <TSchema extends ZodType>(schema: TSchema, options?: {
+    collapseWhitespace?: boolean;
+}) => TSchema & AuthoredTextBrand;
+/** One {@link fromChildren} field as the shim reads it. */
+export interface AuthoredChildField {
+    field: string;
+    childType: string;
+    /** Field leftover text children fill. */
+    textField?: string;
+    /** Replaces the default prop copy. */
+    toItem?: (props: object, context: AuthorChildContext) => unknown;
+    /** The array element schema, or the field schema itself when it is not an array. */
+    itemSchema: ZodType;
+    /** Input props for a custom `toItem`, excluding JSX children. */
+    propsSchema?: ZodType;
+    /** Whether the field holds an array of items rather than one item. */
+    array: boolean;
+    /** Whether the field accepts `undefined`, so children may be omitted. */
+    optional: boolean;
+    /** Structural input-schema fingerprint shared by fields branding one child type. */
+    signature: string;
+}
+/** One {@link fromTextChildren} field as the shim reads it. */
+export interface AuthoredTextField {
+    field: string;
+    /** `true` unless the brand was given `collapseWhitespace: false`. */
+    collapseWhitespace: boolean;
+    /** Whether the field accepts `undefined`, so text children may be omitted. */
+    optional: boolean;
+}
+/** The branded fields found on one object schema. */
+export interface AuthoredSpec {
+    children: AuthoredChildField[];
+    text: AuthoredTextField[];
+}
+/**
+ * The branded fields on an object schema, top level only: read a child's own
+ * brands from its {@link AuthoredChildField.itemSchema}.
+ */
+export declare const readAuthoredSpec: (schema: ZodType) => AuthoredSpec;
+export {};
+//# sourceMappingURL=authored_fields.d.ts.map

package/dist/author/authored_fields.d.ts.map

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

package/dist/author/authored_fields.js

@@ -0,0 +1,227 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { z } from 'zod';
+import { ISOMER_ERROR_CODES, IsomerError } from '../composition/error.js';
+import { prepareAuthoringInput } from './authoring_input.js';
+/**
+ * Child-element type a schema field is filled from.
+ *
+ * `Symbol.for`: ESM and CJS builds must agree, same as `authorType`.
+ */
+export const authoredChild = Symbol.for('elastic.isomer.authored_child');
+/** Phantom props type for the child component. Not set at runtime. */
+export const authoredProps = Symbol.for('elastic.isomer.authored_props');
+/** Set when a field is filled from text children. */
+export const authoredText = Symbol.for('elastic.isomer.authored_text');
+/** Holds a {@link fromChildren} brand's `toItem`. */
+export const authoredToItem = Symbol.for('elastic.isomer.authored_to_item');
+const authoredTextField = Symbol.for('elastic.isomer.authored_text_field');
+const authoredCollapse = Symbol.for('elastic.isomer.authored_collapse');
+const authoredPropsSchema = Symbol.for('elastic.isomer.authored_props_schema');
+const BRANDS = [
+    authoredChild,
+    authoredTextField,
+    authoredToItem,
+    authoredText,
+    authoredCollapse,
+    authoredPropsSchema,
+];
+// Applies a complete branding. Branding an instance again is allowed only with
+// the same configuration, absent options included, since both fields share it.
+const brand = (caller, schema, config) => {
+    const record = schema;
+    if (BRANDS.some((key) => Object.hasOwn(schema, key))) {
+        if (BRANDS.every((key) => record[key] === config[key]))
+            return;
+        throw new IsomerError(ISOMER_ERROR_CODES.AUTHORED_SCHEMA_REUSED, `${caller}: this schema instance is already branded another way; pass each field its own schema.`);
+    }
+    for (const key of BRANDS) {
+        if (config[key] !== undefined) {
+            Object.defineProperty(schema, key, {
+                value: config[key],
+                enumerable: false,
+            });
+        }
+    }
+};
+export function fromChildren(childType, schema, options) {
+    brand('fromChildren', schema, {
+        [authoredChild]: childType,
+        [authoredTextField]: options?.text,
+        [authoredToItem]: options?.toItem,
+        [authoredPropsSchema]: options?.propsSchema,
+    });
+    return schema;
+}
+/**
+ * Brands `schema` as text children.
+ *
+ * Whitespace collapses unless `collapseWhitespace` is `false`.
+ */
+export const fromTextChildren = (schema, options) => {
+    brand('fromTextChildren', schema, {
+        [authoredText]: true,
+        [authoredCollapse]: options?.collapseWhitespace === false ? false : undefined,
+    });
+    return schema;
+};
+const zodDefType = (schema) => schema._zod?.def?.type;
+const WRAPPER_TYPES = new Set(['optional', 'nullable', 'default', 'readonly']);
+const innerSchema = (schema) => {
+    const def = schema._zod?.def;
+    return def?.type && WRAPPER_TYPES.has(def.type) ? def.innerType : undefined;
+};
+// The schema holding `brand`: `schema` or one it wraps.
+const brandHolder = (schema, key) => {
+    let current = schema;
+    while (current && !Object.hasOwn(current, key)) {
+        current = innerSchema(current);
+    }
+    return current;
+};
+// Whether any wrapper layer of `schema` accepts `undefined`.
+const optionalThrough = (schema) => {
+    for (let current = schema; current; current = innerSchema(current)) {
+        if (isOptionalSchema(current))
+            return true;
+    }
+    return false;
+};
+const unwrapAll = (schema) => {
+    let current = schema;
+    for (let inner = innerSchema(current); inner; inner = innerSchema(current)) {
+        current = inner;
+    }
+    return current;
+};
+/** `undefined` is a valid value, so children may be omitted. */
+const isOptionalSchema = (schema) => {
+    const type = zodDefType(schema);
+    return type === 'optional' || type === 'default';
+};
+const UNORDERED_SCHEMA_ARRAYS = new Set([
+    'allOf',
+    'anyOf',
+    'enum',
+    'oneOf',
+    'required',
+    'type',
+]);
+const schemaSignature = (schema) => {
+    const { schema: input } = prepareAuthoringInput(schema);
+    const projected = z.toJSONSchema(input, {
+        io: 'input',
+        target: 'draft-2020-12',
+        cycles: 'ref',
+        reused: 'inline',
+        unrepresentable: 'any',
+        metadata: z.registry(),
+    });
+    const active = new Map();
+    const canonical = (value, key = '') => {
+        if (Array.isArray(value)) {
+            const members = value.map((member) => canonical(member));
+            if (UNORDERED_SCHEMA_ARRAYS.has(key))
+                members.sort();
+            return `[${members.join(',')}]`;
+        }
+        if (typeof value !== 'object' || value === null) {
+            return JSON.stringify(value) ?? 'undefined';
+        }
+        const cycle = active.get(value);
+        if (cycle !== undefined)
+            return `cycle:${cycle}`;
+        const object = value;
+        const ref = object.$ref;
+        const target = ref === '#'
+            ? projected
+            : typeof ref === 'string' && ref.startsWith('#/$defs/')
+                ? projected.$defs?.[ref.slice('#/$defs/'.length)]
+                : undefined;
+        if (target && Object.keys(object).length === 1)
+            return canonical(target);
+        active.set(value, active.size);
+        const result = `{${Object.entries(object)
+            .filter(([key]) => value !== projected || key !== '$defs')
+            .sort(([first], [second]) => first.localeCompare(second))
+            .map(([key, member]) => `${JSON.stringify(key)}:${canonical(key === '$ref' && target ? target : member, key)}`)
+            .join(',')}}`;
+        active.delete(value);
+        return result;
+    };
+    return canonical(projected);
+};
+const arrayElement = (schema) => {
+    const inner = unwrapAll(schema);
+    return zodDefType(inner) === 'array' && 'element' in inner
+        ? inner.element
+        : undefined;
+};
+const readChild = (field, schema) => {
+    const holder = brandHolder(schema, authoredChild);
+    const childType = holder?.[authoredChild];
+    if (!holder || typeof childType !== 'string') {
+        return undefined;
+    }
+    const textField = holder[authoredTextField];
+    const toItem = holder[authoredToItem];
+    const propsSchema = holder[authoredPropsSchema];
+    const element = arrayElement(holder);
+    const itemSchema = element ?? unwrapAll(holder);
+    const child = {
+        field,
+        childType,
+        itemSchema,
+        array: element !== undefined,
+        optional: optionalThrough(schema),
+        signature: `${schemaSignature(itemSchema)}|${typeof textField === 'string' ? textField : ''}|${propsSchema ? schemaSignature(propsSchema) : ''}`,
+    };
+    if (propsSchema)
+        child.propsSchema = propsSchema;
+    if (typeof textField === 'string') {
+        child.textField = textField;
+    }
+    if (typeof toItem === 'function') {
+        child.toItem = toItem;
+    }
+    return child;
+};
+const readText = (field, schema) => {
+    const holder = brandHolder(schema, authoredText);
+    if (!holder) {
+        return undefined;
+    }
+    return {
+        field,
+        collapseWhitespace: holder[authoredCollapse] !== false,
+        optional: optionalThrough(schema),
+    };
+};
+/**
+ * The branded fields on an object schema, top level only: read a child's own
+ * brands from its {@link AuthoredChildField.itemSchema}.
+ */
+export const readAuthoredSpec = (schema) => {
+    if (zodDefType(schema) !== 'object' || !('shape' in schema)) {
+        return { children: [], text: [] };
+    }
+    const children = [];
+    const text = [];
+    for (const [field, fieldSchema] of Object.entries(schema.shape)) {
+        const child = readChild(field, fieldSchema);
+        if (child) {
+            children.push(child);
+            continue;
+        }
+        const textField = readText(field, fieldSchema);
+        if (textField) {
+            text.push(textField);
+        }
+    }
+    return { children, text };
+};
+//# sourceMappingURL=authored_fields.js.map

package/dist/author/authored_fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authored_fields.js","sourceRoot":"","sources":["../../src/author/authored_fields.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { ReactNode } from 'react';\nimport { z, type ZodType } from 'zod';\n\nimport { ISOMER_ERROR_CODES, IsomerError } from '../composition/error';\nimport type { PrimitiveNode } from '../define/primitive_module';\n\nimport { prepareAuthoringInput } from './authoring_input';\n\n/**\n * Child-element type a schema field is filled from.\n *\n * `Symbol.for`: ESM and CJS builds must agree, same as `authorType`.\n */\nexport const authoredChild = Symbol.for('elastic.isomer.authored_child');\n\n/** Phantom props type for the child component. Not set at runtime. */\nexport const authoredProps = Symbol.for('elastic.isomer.authored_props');\n\n/** Set when a field is filled from text children. */\nexport const authoredText = Symbol.for('elastic.isomer.authored_text');\n\n/** Holds a {@link fromChildren} brand's `toItem`. */\nexport const authoredToItem = Symbol.for('elastic.isomer.authored_to_item');\nconst authoredTextField = Symbol.for('elastic.isomer.authored_text_field');\nconst authoredCollapse = Symbol.for('elastic.isomer.authored_collapse');\nconst authoredPropsSchema = Symbol.for('elastic.isomer.authored_props_schema');\n\n/**\n * A field filled from child elements of `TName`.\n *\n * Phantom: `z.infer` still reads the underlying schema. The shim reads `TName`\n * and `TProps` off the field type, and the symbols off the schema value.\n */\nexport interface AuthoredChildBrand<TName extends string, TProps> {\n  readonly [authoredChild]: TName;\n  readonly [authoredProps]: TProps;\n}\n\n/** A child field whose `toItem` builds each item, so the shim fills none of the item's own brands. */\nexport interface AuthoredToItemBrand {\n  readonly [authoredToItem]: (\n    props: never,\n    context: AuthorChildContext\n  ) => unknown;\n}\n\n/** A field filled from text children. */\nexport interface AuthoredTextBrand {\n  readonly [authoredText]: true;\n}\n\n/** What {@link fromChildren}'s `toItem` receives. */\nexport interface AuthorChildContext {\n  /** Nested elements, parsed as body nodes. */\n  parseChildren: (children: ReactNode) => PrimitiveNode[];\n}\n\ntype ArrayItem<TSchema extends ZodType> =\n  NonNullable<zOutput<TSchema>> extends readonly (infer Item)[]\n    ? Item\n    : NonNullable<zOutput<TSchema>>;\n\ntype zInput<TSchema> = TSchema extends { _zod: { input: infer Input } }\n  ? Input\n  : never;\n\ntype zOutput<TSchema> = TSchema extends { _zod: { output: infer Output } }\n  ? Output\n  : never;\n\ntype WrapperOf<TInner> = {\n  _zod: {\n    def: {\n      type: 'optional' | 'nullable' | 'default' | 'readonly';\n      innerType: TInner;\n    };\n  };\n};\n\ntype Unwrapped<TSchema> =\n  TSchema extends WrapperOf<infer Inner> ? Unwrapped<Inner> : TSchema;\n\n/** Whether `F`, or a wrapper layer of it, carries a {@link fromChildren} brand. */\ntype IsChildBranded<F> =\n  F extends AuthoredChildBrand<string, unknown>\n    ? true\n    : F extends WrapperOf<infer Inner>\n      ? IsChildBranded<Inner>\n      : false;\n\n/** A branded field's item schema: the array element through any wrapper, or the unwrapped schema. */\nexport type ItemSchema<TSchema> =\n  Unwrapped<TSchema> extends { element: infer Element }\n    ? Element\n    : Unwrapped<TSchema>;\n\n/** Item fields a nested {@link fromChildren} brand fills from child elements. */\ntype ChildBrandedKeys<TItemSchema> = TItemSchema extends {\n  shape: infer Shape;\n}\n  ? string extends keyof Shape\n    ? never\n    : {\n        [K in keyof Shape]: IsChildBranded<Shape[K]> extends true ? K : never;\n      }[keyof Shape]\n  : never;\n\n/** `TOptional` is optional on the child props because text or child elements fill it. */\ntype ChildProps<TItem, TOptional extends PropertyKey> = [TOptional] extends [\n  never,\n]\n  ? TItem & { children?: ReactNode }\n  : Omit<TItem, TOptional> &\n      Partial<Pick<TItem, Extract<TOptional, keyof TItem>>> & {\n        children?: ReactNode;\n      };\n\nconst BRANDS = [\n  authoredChild,\n  authoredTextField,\n  authoredToItem,\n  authoredText,\n  authoredCollapse,\n  authoredPropsSchema,\n] as const;\n\n// Applies a complete branding. Branding an instance again is allowed only with\n// the same configuration, absent options included, since both fields share it.\nconst brand = (\n  caller: 'fromChildren' | 'fromTextChildren',\n  schema: object,\n  config: Partial<Record<(typeof BRANDS)[number], unknown>>\n): void => {\n  const record = schema as Record<symbol, unknown>;\n  if (BRANDS.some((key) => Object.hasOwn(schema, key))) {\n    if (BRANDS.every((key) => record[key] === config[key])) return;\n    throw new IsomerError(\n      ISOMER_ERROR_CODES.AUTHORED_SCHEMA_REUSED,\n      `${caller}: this schema instance is already branded another way; pass each field its own schema.`\n    );\n  }\n  for (const key of BRANDS) {\n    if (config[key] !== undefined) {\n      Object.defineProperty(schema, key, {\n        value: config[key],\n        enumerable: false,\n      });\n    }\n  }\n};\n\n/**\n * Brands `schema` as JSX children of `childType`.\n *\n * `options.text` copies leftover text onto that field. `options.toItem` replaces\n * the default prop copy; its props annotation is the child component's props.\n * The brand is read through `.optional()`, `.nullable()`, `.default()`, and\n * `.readonly()`; any other method clones without it, so call it on `schema`\n * before passing it in.\n */\nexport function fromChildren<\n  const TName extends string,\n  TSchema extends ZodType,\n>(\n  childType: TName,\n  schema: TSchema\n): TSchema &\n  AuthoredChildBrand<\n    TName,\n    ChildProps<ArrayItem<TSchema>, ChildBrandedKeys<ItemSchema<TSchema>>>\n  >;\nexport function fromChildren<\n  const TName extends string,\n  TSchema extends ZodType,\n  const TText extends string,\n>(\n  childType: TName,\n  schema: TSchema,\n  options: { text: TText; toItem?: never }\n): TSchema &\n  AuthoredChildBrand<\n    TName,\n    ChildProps<\n      ArrayItem<TSchema>,\n      TText | ChildBrandedKeys<ItemSchema<TSchema>>\n    >\n  >;\nexport function fromChildren<\n  const TName extends string,\n  TSchema extends ZodType,\n  TPropsSchema extends ZodType,\n>(\n  childType: TName,\n  schema: TSchema,\n  options: {\n    text?: string;\n    propsSchema: TPropsSchema;\n    toItem(\n      props: zInput<TPropsSchema> & { children?: ReactNode },\n      context: AuthorChildContext\n    ): unknown;\n  }\n): TSchema &\n  AuthoredChildBrand<TName, zInput<TPropsSchema> & { children?: ReactNode }> &\n  AuthoredToItemBrand;\nexport function fromChildren<\n  const TName extends string,\n  TSchema extends ZodType,\n  TProps,\n>(\n  childType: TName,\n  schema: TSchema,\n  options: {\n    text?: string;\n    toItem(props: TProps, context: AuthorChildContext): unknown;\n    propsSchema?: never;\n  }\n): TSchema & AuthoredChildBrand<TName, TProps> & AuthoredToItemBrand;\nexport function fromChildren(\n  childType: string,\n  schema: ZodType,\n  options?: {\n    text?: string;\n    toItem?: (this: void, props: never, context: AuthorChildContext) => unknown;\n    propsSchema?: ZodType;\n  }\n): ZodType {\n  brand('fromChildren', schema, {\n    [authoredChild]: childType,\n    [authoredTextField]: options?.text,\n    [authoredToItem]: options?.toItem,\n    [authoredPropsSchema]: options?.propsSchema,\n  });\n  return schema;\n}\n\n/**\n * Brands `schema` as text children.\n *\n * Whitespace collapses unless `collapseWhitespace` is `false`.\n */\nexport const fromTextChildren = <TSchema extends ZodType>(\n  schema: TSchema,\n  options?: { collapseWhitespace?: boolean }\n): TSchema & AuthoredTextBrand => {\n  brand('fromTextChildren', schema, {\n    [authoredText]: true,\n    [authoredCollapse]:\n      options?.collapseWhitespace === false ? false : undefined,\n  });\n  return schema as TSchema & AuthoredTextBrand;\n};\n\n/** One {@link fromChildren} field as the shim reads it. */\nexport interface AuthoredChildField {\n  field: string;\n  childType: string;\n  /** Field leftover text children fill. */\n  textField?: string;\n  /** Replaces the default prop copy. */\n  toItem?: (props: object, context: AuthorChildContext) => unknown;\n  /** The array element schema, or the field schema itself when it is not an array. */\n  itemSchema: ZodType;\n  /** Input props for a custom `toItem`, excluding JSX children. */\n  propsSchema?: ZodType;\n  /** Whether the field holds an array of items rather than one item. */\n  array: boolean;\n  /** Whether the field accepts `undefined`, so children may be omitted. */\n  optional: boolean;\n  /** Structural input-schema fingerprint shared by fields branding one child type. */\n  signature: string;\n}\n\n/** One {@link fromTextChildren} field as the shim reads it. */\nexport interface AuthoredTextField {\n  field: string;\n  /** `true` unless the brand was given `collapseWhitespace: false`. */\n  collapseWhitespace: boolean;\n  /** Whether the field accepts `undefined`, so text children may be omitted. */\n  optional: boolean;\n}\n\n/** The branded fields found on one object schema. */\nexport interface AuthoredSpec {\n  children: AuthoredChildField[];\n  text: AuthoredTextField[];\n}\n\nconst zodDefType = (schema: object): string | undefined =>\n  (schema as { _zod?: { def?: { type?: string } } })._zod?.def?.type;\n\nconst WRAPPER_TYPES = new Set(['optional', 'nullable', 'default', 'readonly']);\n\ninterface WrapperDef {\n  type?: string;\n  innerType?: ZodType;\n}\n\nconst innerSchema = (schema: ZodType): ZodType | undefined => {\n  const def: WrapperDef | undefined = (\n    schema as { _zod?: { def?: WrapperDef } }\n  )._zod?.def;\n  return def?.type && WRAPPER_TYPES.has(def.type) ? def.innerType : undefined;\n};\n\n// The schema holding `brand`: `schema` or one it wraps.\nconst brandHolder = (schema: ZodType, key: symbol): ZodType | undefined => {\n  let current: ZodType | undefined = schema;\n  while (current && !Object.hasOwn(current, key)) {\n    current = innerSchema(current);\n  }\n  return current;\n};\n\n// Whether any wrapper layer of `schema` accepts `undefined`.\nconst optionalThrough = (schema: ZodType): boolean => {\n  for (\n    let current: ZodType | undefined = schema;\n    current;\n    current = innerSchema(current)\n  ) {\n    if (isOptionalSchema(current)) return true;\n  }\n  return false;\n};\n\nconst unwrapAll = (schema: ZodType): ZodType => {\n  let current = schema;\n  for (let inner = innerSchema(current); inner; inner = innerSchema(current)) {\n    current = inner;\n  }\n  return current;\n};\n\n/** `undefined` is a valid value, so children may be omitted. */\nconst isOptionalSchema = (schema: ZodType): boolean => {\n  const type = zodDefType(schema);\n  return type === 'optional' || type === 'default';\n};\n\nconst UNORDERED_SCHEMA_ARRAYS = new Set([\n  'allOf',\n  'anyOf',\n  'enum',\n  'oneOf',\n  'required',\n  'type',\n]);\n\nconst schemaSignature = (schema: ZodType): string => {\n  const { schema: input } = prepareAuthoringInput(schema);\n  const projected = z.toJSONSchema(input, {\n    io: 'input',\n    target: 'draft-2020-12',\n    cycles: 'ref',\n    reused: 'inline',\n    unrepresentable: 'any',\n    metadata: z.registry(),\n  });\n  const active = new Map<object, number>();\n  const canonical = (value: unknown, key = ''): string => {\n    if (Array.isArray(value)) {\n      const members = value.map((member) => canonical(member));\n      if (UNORDERED_SCHEMA_ARRAYS.has(key)) members.sort();\n      return `[${members.join(',')}]`;\n    }\n    if (typeof value !== 'object' || value === null) {\n      return JSON.stringify(value) ?? 'undefined';\n    }\n    const cycle = active.get(value);\n    if (cycle !== undefined) return `cycle:${cycle}`;\n    const object = value as Record<string, unknown>;\n    const ref = object.$ref;\n    const target =\n      ref === '#'\n        ? projected\n        : typeof ref === 'string' && ref.startsWith('#/$defs/')\n          ? projected.$defs?.[ref.slice('#/$defs/'.length)]\n          : undefined;\n    if (target && Object.keys(object).length === 1) return canonical(target);\n    active.set(value, active.size);\n    const result = `{${Object.entries(object)\n      .filter(([key]) => value !== projected || key !== '$defs')\n      .sort(([first], [second]) => first.localeCompare(second))\n      .map(\n        ([key, member]) =>\n          `${JSON.stringify(key)}:${canonical(key === '$ref' && target ? target : member, key)}`\n      )\n      .join(',')}}`;\n    active.delete(value);\n    return result;\n  };\n  return canonical(projected);\n};\n\nconst arrayElement = (schema: ZodType): ZodType | undefined => {\n  const inner = unwrapAll(schema);\n  return zodDefType(inner) === 'array' && 'element' in inner\n    ? (inner as { element: ZodType }).element\n    : undefined;\n};\n\nconst readChild = (\n  field: string,\n  schema: ZodType\n): AuthoredChildField | undefined => {\n  const holder = brandHolder(schema, authoredChild);\n  const childType = (holder as { [authoredChild]?: unknown } | undefined)?.[\n    authoredChild\n  ];\n  if (!holder || typeof childType !== 'string') {\n    return undefined;\n  }\n  const textField = (holder as { [authoredTextField]?: unknown })[\n    authoredTextField\n  ];\n  const toItem = (holder as { [authoredToItem]?: unknown })[authoredToItem];\n  const propsSchema = (holder as { [authoredPropsSchema]?: ZodType })[\n    authoredPropsSchema\n  ];\n  const element = arrayElement(holder);\n  const itemSchema = element ?? unwrapAll(holder);\n  const child: AuthoredChildField = {\n    field,\n    childType,\n    itemSchema,\n    array: element !== undefined,\n    optional: optionalThrough(schema),\n    signature: `${schemaSignature(itemSchema)}|${typeof textField === 'string' ? textField : ''}|${propsSchema ? schemaSignature(propsSchema) : ''}`,\n  };\n  if (propsSchema) child.propsSchema = propsSchema;\n  if (typeof textField === 'string') {\n    child.textField = textField;\n  }\n  if (typeof toItem === 'function') {\n    child.toItem = toItem as (\n      props: object,\n      context: AuthorChildContext\n    ) => unknown;\n  }\n  return child;\n};\n\nconst readText = (\n  field: string,\n  schema: ZodType\n): AuthoredTextField | undefined => {\n  const holder = brandHolder(schema, authoredText);\n  if (!holder) {\n    return undefined;\n  }\n  return {\n    field,\n    collapseWhitespace:\n      (holder as { [authoredCollapse]?: unknown })[authoredCollapse] !== false,\n    optional: optionalThrough(schema),\n  };\n};\n\n/**\n * The branded fields on an object schema, top level only: read a child's own\n * brands from its {@link AuthoredChildField.itemSchema}.\n */\nexport const readAuthoredSpec = (schema: ZodType): AuthoredSpec => {\n  if (zodDefType(schema) !== 'object' || !('shape' in schema)) {\n    return { children: [], text: [] };\n  }\n  const children: AuthoredChildField[] = [];\n  const text: AuthoredTextField[] = [];\n  for (const [field, fieldSchema] of Object.entries(\n    schema.shape as Record<string, ZodType>\n  )) {\n    const child = readChild(field, fieldSchema);\n    if (child) {\n      children.push(child);\n      continue;\n    }\n    const textField = readText(field, fieldSchema);\n    if (textField) {\n      text.push(textField);\n    }\n  }\n  return { children, text };\n};\n"]}

package/dist/author/authoring_input.d.ts

@@ -0,0 +1,7 @@
+import { z, type ZodType } from 'zod';
+/** Input-schema copy without executable defaults or catch values. */
+export declare const prepareAuthoringInput: (schema: ZodType) => {
+    schema: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+    metadata: z.core.$ZodRegistry<z.core.GlobalMeta, z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>>;
+};
+//# sourceMappingURL=authoring_input.d.ts.map

package/dist/author/authoring_input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_input.d.ts","sourceRoot":"","sources":["../../src/author/authoring_input.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,CAAC,EAAE,KAAK,OAAO,EAAE,MAAM,KAAK,CAAC;AAQtC,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,GAAI,QAAQ,OAAO;;;CA6CpD,CAAC"}

package/dist/author/authoring_input.js

@@ -0,0 +1,60 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { z } from 'zod';
+const isSchema = (value) => typeof value === 'object' &&
+    value !== null &&
+    '_zod' in value &&
+    typeof value._zod?.def?.type === 'string';
+/** Input-schema copy without executable defaults or catch values. */
+export const prepareAuthoringInput = (schema) => {
+    const copies = new Map();
+    const metadata = z.registry();
+    const copyValue = (value) => {
+        if (isSchema(value))
+            return copySchema(value);
+        if (Array.isArray(value))
+            return value.map(copyValue);
+        if (typeof value !== 'object' || value === null)
+            return value;
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null)
+            return value;
+        return Object.fromEntries(Object.entries(value).map(([key, member]) => [key, copyValue(member)]));
+    };
+    const copySchema = (source) => {
+        const cached = copies.get(source);
+        if (cached)
+            return cached;
+        let result;
+        copies.set(source, z.lazy(() => result));
+        const { def } = source._zod;
+        if (def.type === 'default' ||
+            def.type === 'prefault' ||
+            def.type === 'catch') {
+            const { innerType } = def;
+            const inner = copySchema(innerType);
+            result =
+                def.type === 'catch'
+                    ? z.clone(inner, inner._zod.def)
+                    : z.optional(inner);
+        }
+        else if (def.type === 'lazy') {
+            const { getter } = def;
+            result = z.lazy(() => copySchema(getter()));
+        }
+        else {
+            result = z.clone(source, copyValue(def));
+        }
+        copies.set(source, result);
+        const meta = z.globalRegistry.get(source);
+        if (meta)
+            metadata.add(result, meta);
+        return result;
+    };
+    return { schema: copySchema(schema), metadata };
+};
+//# sourceMappingURL=authoring_input.js.map

package/dist/author/authoring_input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_input.js","sourceRoot":"","sources":["../../src/author/authoring_input.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport { z, type ZodType } from 'zod';\n\nconst isSchema = (value: unknown): value is ZodType =>\n  typeof value === 'object' &&\n  value !== null &&\n  '_zod' in value &&\n  typeof (value as ZodType)._zod?.def?.type === 'string';\n\n/** Input-schema copy without executable defaults or catch values. */\nexport const prepareAuthoringInput = (schema: ZodType) => {\n  const copies = new Map<ZodType, ZodType>();\n  const metadata = z.registry<z.GlobalMeta>();\n  const copyValue = (value: unknown): unknown => {\n    if (isSchema(value)) return copySchema(value);\n    if (Array.isArray(value)) return value.map(copyValue);\n    if (typeof value !== 'object' || value === null) return value;\n    const prototype: unknown = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) return value;\n    return Object.fromEntries(\n      Object.entries(value).map(([key, member]) => [key, copyValue(member)])\n    );\n  };\n  const copySchema = (source: ZodType): ZodType => {\n    const cached = copies.get(source);\n    if (cached) return cached;\n    let result: ZodType;\n    copies.set(\n      source,\n      z.lazy(() => result)\n    );\n    const { def } = source._zod;\n    if (\n      def.type === 'default' ||\n      def.type === 'prefault' ||\n      def.type === 'catch'\n    ) {\n      const { innerType } = def as { type: string; innerType: ZodType };\n      const inner = copySchema(innerType);\n      result =\n        def.type === 'catch'\n          ? z.clone(inner, inner._zod.def)\n          : z.optional(inner);\n    } else if (def.type === 'lazy') {\n      const { getter } = def as { type: string; getter: () => ZodType };\n      result = z.lazy(() => copySchema(getter()));\n    } else {\n      result = z.clone(source, copyValue(def) as typeof def);\n    }\n    copies.set(source, result);\n    const meta = z.globalRegistry.get(source);\n    if (meta) metadata.add(result, meta);\n    return result;\n  };\n  return { schema: copySchema(schema), metadata };\n};\n"]}

package/dist/author/authoring_model.d.ts

@@ -0,0 +1,27 @@
+import { type AuthoredChildField, type AuthoredSpec } from './authored_fields.js';
+export interface ChildSlot {
+    array: boolean;
+    field: string;
+}
+export interface AuthoringChild {
+    field: AuthoredChildField;
+    primitiveType: string;
+    path: readonly AuthoredChildField[];
+}
+export declare const createAuthoringModel: (primitives: readonly {
+    type: string;
+    schema?: unknown;
+    children?: unknown;
+}[]) => {
+    authoredByType: Map<string, AuthoredSpec>;
+    children: Map<string, AuthoringChild>;
+    childSlotsByType: Map<string, readonly ChildSlot[]>;
+};
+/**
+ * Reads {@link PrimitiveDefinition.children} against a probe node so JSX can
+ * fill the same fields a tree walk would visit. Paths like `body[0]` are array
+ * slots; a bare `header` is a single nested node.
+ */
+export declare const inferChildSlots: (children: unknown) => readonly ChildSlot[];
+export declare const capitalize: (value: string) => string;
+//# sourceMappingURL=authoring_model.d.ts.map

package/dist/author/authoring_model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_model.d.ts","sourceRoot":"","sources":["../../src/author/authoring_model.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,YAAY,EAElB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,oBAAoB,GAC/B,YAAY,SAAS;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAAE;;;;CAwD9E,CAAC;AAKF;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,OAAO,KAAG,SAAS,SAAS,EAuCrE,CAAC;AAQF,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MACY,CAAC"}

package/dist/author/authoring_model.js

@@ -0,0 +1,98 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { IsomerError } from '../composition/error.js';
+import { readAuthoredSpec, } from './authored_fields.js';
+export const createAuthoringModel = (primitives) => {
+    const authoredByType = new Map();
+    const children = new Map();
+    const visited = new Set();
+    const collectChildren = (fields, primitiveType, path) => {
+        for (const field of fields) {
+            const prior = children.get(field.childType);
+            if (prior && prior.field.signature !== field.signature) {
+                throw new IsomerError('DUPLICATE_AUTHORED_CHILD', `Child type "${field.childType}" is branded with incompatible item or props input schemas.`);
+            }
+            const nextPath = [...path, field];
+            if (!prior)
+                children.set(field.childType, { field, primitiveType, path: nextPath });
+            if (field.toItem || visited.has(field.itemSchema))
+                continue;
+            visited.add(field.itemSchema);
+            collectChildren(readAuthoredSpec(field.itemSchema).children, primitiveType, nextPath);
+        }
+    };
+    for (const { type, schema } of primitives) {
+        if (!isZodType(schema))
+            continue;
+        const spec = readAuthoredSpec(schema);
+        if (spec.children.length === 0 && spec.text.length === 0)
+            continue;
+        authoredByType.set(type, spec);
+        collectChildren(spec.children, type, []);
+    }
+    const typeByName = new Map([['Composition', 'view']]);
+    for (const type of [
+        ...primitives.map(({ type }) => type),
+        ...children.keys(),
+    ]) {
+        const name = capitalize(type);
+        const earlier = typeByName.get(name);
+        if (earlier !== undefined && earlier !== type) {
+            throw new IsomerError('DUPLICATE_PRIMITIVE_TYPE', `buildJsxShim: "${earlier}" and "${type}" both become the component ${name}`);
+        }
+        typeByName.set(name, type);
+    }
+    const childSlotsByType = new Map(primitives.map(({ type, children }) => [type, inferChildSlots(children)]));
+    return { authoredByType, children, childSlotsByType };
+};
+const isZodType = (schema) => typeof schema === 'object' && schema !== null && '_zod' in schema;
+/**
+ * Reads {@link PrimitiveDefinition.children} against a probe node so JSX can
+ * fill the same fields a tree walk would visit. Paths like `body[0]` are array
+ * slots; a bare `header` is a single nested node.
+ */
+export const inferChildSlots = (children) => {
+    if (typeof children !== 'function') {
+        return [];
+    }
+    const probeNode = { type: '__probe__' };
+    const node = new Proxy({}, {
+        get(_target, prop) {
+            if (prop === 'type') {
+                return probeNode.type;
+            }
+            return [probeNode];
+        },
+    });
+    try {
+        const refs = children(node);
+        if (!Array.isArray(refs)) {
+            return [];
+        }
+        const byField = new Map();
+        for (const ref of refs) {
+            if (!isChildRef(ref)) {
+                continue;
+            }
+            const field = /^[A-Za-z_]\w*/.exec(ref.path)?.[0];
+            if (!field) {
+                continue;
+            }
+            byField.set(field, byField.get(field) === true || /\[\d+\]/.test(ref.path));
+        }
+        return [...byField.entries()].map(([field, array]) => ({ array, field }));
+    }
+    catch {
+        return [];
+    }
+};
+const isChildRef = (value) => typeof value === 'object' &&
+    value !== null &&
+    'path' in value &&
+    typeof value.path === 'string';
+export const capitalize = (value) => `${value.slice(0, 1).toUpperCase()}${value.slice(1)}`;
+//# sourceMappingURL=authoring_model.js.map