@elastic/isomer-sdk 0.0.0 → 0.1.0

package/dist/author/authored_fields.d.ts

@@ -0,0 +1,103 @@
+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;
+/**
+ * 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 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 zOutput<TSchema> = TSchema extends {
+    _zod: {
+        output: infer Output;
+    };
+} ? Output : never;
+/** `TText` is optional on the child props because leftover text fills it. */
+type ChildProps<TItem, TText extends string | undefined> = [TText] extends [
+    string
+] ? Omit<TItem, TText> & Partial<Pick<TItem, Extract<TText, keyof TItem>>> & {
+    children?: ReactNode;
+} : 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>, undefined>>;
+export declare function fromChildren<const TName extends string, TSchema extends ZodType, const TText extends string>(childType: TName, schema: TSchema, options: {
+    text: TText;
+}): TSchema & AuthoredChildBrand<TName, ChildProps<ArrayItem<TSchema>, TText>>;
+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;
+}): TSchema & AuthoredChildBrand<TName, TProps>;
+/**
+ * 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;
+    /** Whether the field accepts `undefined`, so children may be omitted. */
+    optional: boolean;
+    /** Structural fingerprint of `itemSchema`; every field branding one child type must share it. */
+    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[];
+}
+/** Top-level branded fields on an object schema. Nested brands stay on the item schema. */
+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,183 @@
+/*
+ * 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 { ISOMER_ERROR_CODES, IsomerError } from '../composition/error.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');
+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 BRANDS = [
+    authoredChild,
+    authoredTextField,
+    authoredToItem,
+    authoredText,
+    authoredCollapse,
+];
+// 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,
+    });
+    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 schemaSignature = (schema, seen = new Set()) => {
+    if (seen.has(schema)) {
+        return 'cycle';
+    }
+    seen.add(schema);
+    const type = zodDefType(schema) ?? '?';
+    if (type === 'object' && 'shape' in schema) {
+        const shape = schema.shape;
+        const fields = Object.keys(shape)
+            .sort()
+            .map((key) => `${key}:${schemaSignature(shape[key], seen)}`);
+        return `{${fields.join(',')}}`;
+    }
+    if (type === 'array' && 'element' in schema) {
+        return `[${schemaSignature(schema.element, seen)}]`;
+    }
+    const inner = innerSchema(schema);
+    if (inner) {
+        return `${type}(${schemaSignature(inner, seen)})`;
+    }
+    return type;
+};
+const arrayElement = (schema) => {
+    const inner = unwrapAll(schema);
+    if (zodDefType(inner) === 'array' && 'element' in inner) {
+        return inner.element;
+    }
+    return inner;
+};
+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 child = {
+        field,
+        childType,
+        itemSchema: arrayElement(holder),
+        optional: optionalThrough(schema),
+        signature: schemaSignature(arrayElement(holder)),
+    };
+    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),
+    };
+};
+/** Top-level branded fields on an object schema. Nested brands stay on the item schema. */
+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 type { ZodType } from 'zod';\n\nimport { ISOMER_ERROR_CODES, IsomerError } from '../composition/error';\nimport type { PrimitiveNode } from '../define/primitive_module';\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\nconst 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');\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 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 zOutput<TSchema> = TSchema extends { _zod: { output: infer Output } }\n  ? Output\n  : never;\n\n/** `TText` is optional on the child props because leftover text fills it. */\ntype ChildProps<TItem, TText extends string | undefined> = [TText] extends [\n  string,\n]\n  ? Omit<TItem, TText> &\n      Partial<Pick<TItem, Extract<TText, keyof TItem>>> & {\n        children?: ReactNode;\n      }\n  : TItem & { children?: ReactNode };\n\nconst BRANDS = [\n  authoredChild,\n  authoredTextField,\n  authoredToItem,\n  authoredText,\n  authoredCollapse,\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<TName, ChildProps<ArrayItem<TSchema>, undefined>>;\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 }\n): TSchema & AuthoredChildBrand<TName, ChildProps<ArrayItem<TSchema>, TText>>;\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  }\n): TSchema & AuthoredChildBrand<TName, TProps>;\nexport function fromChildren(\n  childType: string,\n  schema: ZodType,\n  options?: {\n    text?: string;\n    toItem?: (this: void, props: never, context: AuthorChildContext) => unknown;\n  }\n): ZodType {\n  brand('fromChildren', schema, {\n    [authoredChild]: childType,\n    [authoredTextField]: options?.text,\n    [authoredToItem]: options?.toItem,\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  /** Whether the field accepts `undefined`, so children may be omitted. */\n  optional: boolean;\n  /** Structural fingerprint of `itemSchema`; every field branding one child type must share it. */\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 schemaSignature = (\n  schema: ZodType,\n  seen: Set<object> = new Set()\n): string => {\n  if (seen.has(schema)) {\n    return 'cycle';\n  }\n  seen.add(schema);\n  const type = zodDefType(schema) ?? '?';\n  if (type === 'object' && 'shape' in schema) {\n    const shape = schema.shape as Record<string, ZodType>;\n    const fields = Object.keys(shape)\n      .sort()\n      .map((key) => `${key}:${schemaSignature(shape[key] as ZodType, seen)}`);\n    return `{${fields.join(',')}}`;\n  }\n  if (type === 'array' && 'element' in schema) {\n    return `[${schemaSignature((schema as { element: ZodType }).element, seen)}]`;\n  }\n  const inner = innerSchema(schema);\n  if (inner) {\n    return `${type}(${schemaSignature(inner, seen)})`;\n  }\n  return type;\n};\n\nconst arrayElement = (schema: ZodType): ZodType => {\n  const inner = unwrapAll(schema);\n  if (zodDefType(inner) === 'array' && 'element' in inner) {\n    return (inner as { element: ZodType }).element;\n  }\n  return inner;\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 child: AuthoredChildField = {\n    field,\n    childType,\n    itemSchema: arrayElement(holder),\n    optional: optionalThrough(schema),\n    signature: schemaSignature(arrayElement(holder)),\n  };\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/** Top-level branded fields on an object schema. Nested brands stay on the item schema. */\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/index.d.ts

@@ -0,0 +1,5 @@
+export { type AuthorChildContext, type AuthoredChildBrand, type AuthoredTextBrand, fromChildren, fromTextChildren, } from './authored_fields.js';
+export { type AuthorComponent } from './jsx.js';
+export { type AuthorComposition, type CompositionAuthorProps, type JsxShim, type PrimitiveComponentMap, buildJsxShim, textFromChildren, } from './jsx_shim.js';
+export { type AuthoringProfileId, type AuthoringPromptContext, type AuthoringViewSummary, AUTHORING_PROFILE_IDS, buildAuthoringPrompt, formatPrimitiveEntry, } from './prompt.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/author/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,YAAY,EACZ,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,OAAO,EACZ,KAAK,qBAAqB,EAC1B,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,UAAU,CAAC"}

package/dist/author/index.js

@@ -0,0 +1,10 @@
+/*
+ * 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.
+ */
+export { fromChildren, fromTextChildren, } from './authored_fields.js';
+export { buildJsxShim, textFromChildren, } from './jsx_shim.js';
+export { AUTHORING_PROFILE_IDS, buildAuthoringPrompt, formatPrimitiveEntry, } from './prompt.js';
+//# sourceMappingURL=index.js.map

package/dist/author/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/author/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAIL,YAAY,EACZ,gBAAgB,GACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAKL,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAIL,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,UAAU,CAAC","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\nexport {\n  type AuthorChildContext,\n  type AuthoredChildBrand,\n  type AuthoredTextBrand,\n  fromChildren,\n  fromTextChildren,\n} from './authored_fields';\nexport { type AuthorComponent } from './jsx';\nexport {\n  type AuthorComposition,\n  type CompositionAuthorProps,\n  type JsxShim,\n  type PrimitiveComponentMap,\n  buildJsxShim,\n  textFromChildren,\n} from './jsx_shim';\nexport {\n  type AuthoringProfileId,\n  type AuthoringPromptContext,\n  type AuthoringViewSummary,\n  AUTHORING_PROFILE_IDS,\n  buildAuthoringPrompt,\n  formatPrimitiveEntry,\n} from './prompt';\n"]}

package/dist/author/jsx.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Brand carrying the primitive type an authoring component stands for.
+ *
+ * `Symbol.for` rather than `Symbol()`: the SDK ships both ESM and CJS builds,
+ * so a host can hold two copies of this module and a unique symbol would make
+ * one build's components unreadable to the other's shim.
+ */
+export declare const authorType: unique symbol;
+/**
+ * A JSX component that renders `null` and exists only to carry `TType` through
+ * the tree until the shim converts it to a composition.
+ */
+export interface AuthorComponent<TProps, TType extends string> {
+    (props: TProps): null;
+    readonly [authorType]: TType;
+    /** Set to `type` by the shim. */
+    displayName?: string;
+}
+/** The {@link AuthorComponent} for one primitive `type`. */
+export declare const defineAuthorComponent: <TProps, TType extends string>(type: TType) => AuthorComponent<TProps, TType>;
+//# sourceMappingURL=jsx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../../src/author/jsx.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,eAA2C,CAAC;AAEnE;;;GAGG;AACH,MAAM,WAAW,eAAe,CAAC,MAAM,EAAE,KAAK,SAAS,MAAM;IAC3D,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;IAC7B,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,GAAI,MAAM,EAAE,KAAK,SAAS,MAAM,EAChE,MAAM,KAAK,KACV,eAAe,CAAC,MAAM,EAAE,KAAK,CAI5B,CAAC"}

package/dist/author/jsx.js

@@ -0,0 +1,20 @@
+/*
+ * 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.
+ */
+/**
+ * Brand carrying the primitive type an authoring component stands for.
+ *
+ * `Symbol.for` rather than `Symbol()`: the SDK ships both ESM and CJS builds,
+ * so a host can hold two copies of this module and a unique symbol would make
+ * one build's components unreadable to the other's shim.
+ */
+export const authorType = Symbol.for('elastic.isomer.author_type');
+/** The {@link AuthorComponent} for one primitive `type`. */
+export const defineAuthorComponent = (type) => Object.assign(() => null, {
+    [authorType]: type,
+    displayName: type,
+});
+//# sourceMappingURL=jsx.js.map

package/dist/author/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","sourceRoot":"","sources":["../../src/author/jsx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;AAanE,4DAA4D;AAC5D,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,IAAW,EACqB,EAAE,CAClC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE;IACxB,CAAC,UAAU,CAAC,EAAE,IAAI;IAClB,WAAW,EAAE,IAAI;CAClB,CAAC,CAAC","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\n/**\n * Brand carrying the primitive type an authoring component stands for.\n *\n * `Symbol.for` rather than `Symbol()`: the SDK ships both ESM and CJS builds,\n * so a host can hold two copies of this module and a unique symbol would make\n * one build's components unreadable to the other's shim.\n */\nexport const authorType = Symbol.for('elastic.isomer.author_type');\n\n/**\n * A JSX component that renders `null` and exists only to carry `TType` through\n * the tree until the shim converts it to a composition.\n */\nexport interface AuthorComponent<TProps, TType extends string> {\n  (props: TProps): null;\n  readonly [authorType]: TType;\n  /** Set to `type` by the shim. */\n  displayName?: string;\n}\n\n/** The {@link AuthorComponent} for one primitive `type`. */\nexport const defineAuthorComponent = <TProps, TType extends string>(\n  type: TType\n): AuthorComponent<TProps, TType> =>\n  Object.assign(() => null, {\n    [authorType]: type,\n    displayName: type,\n  });\n"]}

package/dist/author/jsx_shim.d.ts

@@ -0,0 +1,116 @@
+import { type ReactElement, type ReactNode } from 'react';
+import type { z, ZodObject } from 'zod';
+import type { Composition } from '../composition/composition.js';
+import type { PrimitiveNode } from '../define/primitive_module.js';
+import { type AuthoredChildBrand, type AuthoredTextBrand } from './authored_fields.js';
+import { type AuthorComponent } from './jsx.js';
+/** A {@link Composition} whose `body` is the pack's own authoring node type. */
+export type AuthorComposition<TNode extends PrimitiveNode = PrimitiveNode> = Omit<Composition<TNode>, 'body'> & {
+    body: TNode[];
+};
+/**
+ * Props of the shim's root element: the composition fields minus `type`, with
+ * `body` given either as an array or as JSX children.
+ */
+export interface CompositionAuthorProps<TNode extends PrimitiveNode = PrimitiveNode> extends Omit<AuthorComposition<TNode>, 'type' | 'body'> {
+    /** Wins outright when present: `children` are then ignored, not merged. */
+    body?: TNode[];
+    /** Parsed into `body` only when `body` is absent. Each child must be an authoring element of a registered primitive type. */
+    children?: ReactNode;
+}
+/** Literal `type` strings; wide `string` is dropped so a string index cannot collide with `component`. */
+type LiteralType<T extends string> = string extends T ? never : T;
+/** No keys. Intersects away, unlike `Record<string, never>`. */
+type NoKeys = Record<never, never>;
+type ShapeOf<T> = T extends {
+    shape: infer Shape;
+} ? Shape : NoKeys;
+/** A primitive's schema type, or `never` when it declares none. */
+type SchemaOf<P> = P extends {
+    schema: infer S;
+} ? S extends ZodObject ? S : never : never;
+/** A bare `ZodObject` has a string index; a real shape does not. */
+type LooseSchema<TSchema> = string extends keyof ShapeOf<TSchema> ? true : false;
+type Branded<F> = F extends AuthoredChildBrand<string, unknown> | AuthoredTextBrand ? F : F extends {
+    _zod: {
+        def: {
+            type: 'optional' | 'nullable' | 'default' | 'readonly';
+            innerType: infer Inner;
+        };
+    };
+} ? Branded<Inner> : F;
+type AuthoredNames<TSchema> = {
+    [K in keyof ShapeOf<TSchema>]: Branded<ShapeOf<TSchema>[K]> extends AuthoredChildBrand<string, unknown> | AuthoredTextBrand ? K : never;
+}[keyof ShapeOf<TSchema>];
+type AuthorPropsForSchema<TSchema extends ZodObject> = LooseSchema<TSchema> extends true ? Record<string, unknown> & {
+    children?: ReactNode;
+} : Omit<z.infer<TSchema>, 'type' | AuthoredNames<TSchema>> & Partial<Pick<z.infer<TSchema>, Extract<AuthoredNames<TSchema>, keyof z.infer<TSchema>>>> & {
+    children?: ReactNode;
+};
+type AuthorPropsFor<P> = [SchemaOf<P>] extends [never] ? Record<string, unknown> & {
+    children?: ReactNode;
+} : AuthorPropsForSchema<SchemaOf<P>>;
+type ChildEntry<F> = 0 extends 1 & F ? NoKeys : F extends AuthoredChildBrand<infer Name, infer Props> ? [Name] extends [string] ? {
+    [K in Capitalize<Name>]: AuthorComponent<Props & {
+        children?: ReactNode;
+    }, Name>;
+} : NoKeys : NoKeys;
+type UnionToIntersection<T> = (T extends unknown ? (value: T) => void : never) extends (value: infer R) => void ? R : never;
+type ChildComponentsOf<TSchema> = LooseSchema<TSchema> extends true ? NoKeys : UnionToIntersection<{
+    [K in keyof ShapeOf<TSchema>]: ChildEntry<Branded<ShapeOf<TSchema>[K]>>;
+}[keyof ShapeOf<TSchema>]>;
+type ChildMapOfTuple<TPrimitives> = TPrimitives extends readonly [
+    infer Head,
+    ...infer Tail
+] ? ChildComponentsOf<SchemaOf<Head>> & ChildMapOfTuple<Tail extends readonly {
+    type: string;
+}[] ? Tail : []> : NoKeys;
+type ChildComponentMap<TPrimitives extends readonly {
+    type: string;
+}[]> = ChildMapOfTuple<TPrimitives>;
+/**
+ * PascalCase authoring components keyed from a pack's primitive `type` list.
+ * `slideFrame` becomes `SlideFrame`. Props come from the primitive's schema.
+ */
+export type PrimitiveComponentMap<TPrimitives extends readonly {
+    type: string;
+}[]> = {
+    [P in TPrimitives[number] as Capitalize<LiteralType<P['type'] & string>>]: AuthorComponent<AuthorPropsFor<P>, P['type'] & string>;
+};
+/**
+ * A pack's JSX authoring front: the root `Composition` element, one
+ * PascalCase component per primitive and per branded child, and the conversion
+ * back to plain data.
+ */
+export type JsxShim<TNode extends PrimitiveNode = PrimitiveNode, TPrimitives extends readonly {
+    type: string;
+}[] = readonly {
+    type: string;
+}[]> = {
+    Composition: AuthorComponent<CompositionAuthorProps<TNode>, 'view'>;
+    /** Throws when the root is not the `Composition` element, or when a child is not a registered primitive. */
+    toComposition: (element: ReactElement<CompositionAuthorProps<TNode>>) => AuthorComposition<TNode>;
+} & PrimitiveComponentMap<TPrimitives> & ChildComponentMap<TPrimitives>;
+/**
+ * Builds a pack's {@link JsxShim} from its primitive list.
+ *
+ * Branded schema fields ({@link fromChildren}, {@link fromTextChildren}) fill
+ * from JSX children, and each child type becomes a component. A primitive with
+ * no brand still fills its one child slot, array or single node, from
+ * {@link PrimitiveDefinition.children}.
+ */
+export declare const buildJsxShim: <const TPrimitives extends readonly {
+    type: string;
+}[] = readonly {
+    type: string;
+}[], TNode extends PrimitiveNode = PrimitiveNode>(primitives?: TPrimitives) => JsxShim<TNode, TPrimitives>;
+/** React children as a flat array, with fragments inlined. */
+export declare const flattenChildren: (children: ReactNode) => ReactNode[];
+/**
+ * Children joined into one string. Throws on an element child, so a prop typed as text stays text. Collapses whitespace unless `{ collapseWhitespace: false }`.
+ */
+export declare const textFromChildren: (children: ReactNode, options?: {
+    collapseWhitespace?: boolean;
+}) => string;
+export {};
+//# sourceMappingURL=jsx_shim.d.ts.map

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

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