@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/cjs/author/jsx_shim.js

@@ -0,0 +1,276 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.textFromChildren = exports.flattenChildren = exports.buildJsxShim = void 0;
+const react_1 = require("react");
+const error_1 = require("../composition/error");
+const authored_fields_1 = require("./authored_fields");
+const authoring_model_1 = require("./authoring_model");
+const jsx_1 = require("./jsx");
+/**
+ * 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}.
+ */
+const buildJsxShim = (primitives = []) => {
+    const primitiveTypes = new Set(primitives.map((primitive) => primitive.type));
+    const { authoredByType, children, childSlotsByType } = (0, authoring_model_1.createAuthoringModel)(primitives);
+    const childComponents = new Map([...children.keys()].map((type) => [type, (0, jsx_1.defineAuthorComponent)(type)]));
+    const view = (0, jsx_1.defineAuthorComponent)('view');
+    const env = {
+        authoredByType,
+        childSlotsByType,
+        primitiveTypes,
+    };
+    return {
+        Composition: view,
+        toComposition: (element) => toAuthorComposition(element, env),
+        ...Object.fromEntries(primitives.map((primitive) => [
+            (0, authoring_model_1.capitalize)(primitive.type),
+            (0, jsx_1.defineAuthorComponent)(primitive.type),
+        ])),
+        ...Object.fromEntries([...childComponents].map(([type, component]) => [
+            (0, authoring_model_1.capitalize)(type),
+            component,
+        ])),
+    };
+};
+exports.buildJsxShim = buildJsxShim;
+const toAuthorComposition = (element, env) => {
+    requireAuthorElement(element, 'view');
+    const props = element.props;
+    const resolvedBody = props.body ??
+        (0, exports.flattenChildren)(props.children).map((child) => bodyNodeFromElement(child, env));
+    const spec = {
+        type: 'view',
+        body: resolvedBody,
+    };
+    if (props.version !== undefined) {
+        spec.version = props.version;
+    }
+    if (props.title !== undefined) {
+        spec.title = props.title;
+    }
+    if (props.subtitle !== undefined) {
+        spec.subtitle = props.subtitle;
+    }
+    if (props.theme !== undefined) {
+        spec.theme = props.theme;
+    }
+    if (props.meta !== undefined) {
+        spec.meta = props.meta;
+    }
+    return spec;
+};
+const bodyNodeFromElement = (node, env) => {
+    const element = requireAuthorElement(node);
+    const type = getAuthorType(element);
+    if (!env.primitiveTypes.has(type)) {
+        throw new error_1.IsomerError('INVALID_BODY_NODE', `"${type}" cannot be used as a composition body node.`);
+    }
+    const parseChild = (child) => bodyNodeFromElement(child, env);
+    const slots = env.childSlotsByType.get(type) ?? [];
+    const authored = env.authoredByType.get(type);
+    const converted = {};
+    for (const [key, value] of Object.entries(withoutChildren(element))) {
+        const childField = authored?.children.find((field) => field.field === key);
+        converted[key] = childField
+            ? valueFromChildField(value, childField, env)
+            : convertPropValue(value, key, slots, parseChild);
+    }
+    const rawChildren = element.props.children;
+    if (authored && (authored.children.length > 0 || authored.text.length > 0)) {
+        fillAuthoredFields(converted, authored, rawChildren, env);
+    }
+    else {
+        const unique = slots.length === 1 ? slots[0] : undefined;
+        if (unique &&
+            converted[unique.field] === undefined &&
+            rawChildren !== undefined) {
+            const nested = (0, exports.flattenChildren)(rawChildren).map(parseChild);
+            converted[unique.field] = unique.array ? nested : nested[0];
+        }
+        else if (slots.length === 0 && (0, exports.flattenChildren)(rawChildren).length > 0) {
+            throw new error_1.IsomerError('UNEXPECTED_CHILDREN', `<${(0, authoring_model_1.capitalize)(type)}> takes no JSX children; set its fields through props.`);
+        }
+    }
+    return omitUndefined({ ...converted, type });
+};
+const fillAuthoredFields = (converted, authored, rawChildren, env) => {
+    for (const field of authored.children) {
+        if (converted[field.field] !== undefined || rawChildren === undefined) {
+            continue;
+        }
+        converted[field.field] = valueFromBrand((0, exports.flattenChildren)(rawChildren), field, env);
+    }
+    for (const field of authored.text) {
+        if (converted[field.field] !== undefined) {
+            continue;
+        }
+        if (rawChildren === undefined) {
+            if (!field.optional) {
+                throw new error_1.IsomerError('MISSING_AUTHORED_TEXT', `Expected text children for "${field.field}".`);
+            }
+            continue;
+        }
+        converted[field.field] = (0, exports.textFromChildren)(rawChildren, {
+            collapseWhitespace: field.collapseWhitespace,
+        });
+    }
+};
+const valueFromChildField = (value, field, env) => {
+    if (isJsxNodes(value)) {
+        return valueFromBrand((0, exports.flattenChildren)(value), field, env);
+    }
+    return value;
+};
+const isJsxNodes = (value) => {
+    if (isAuthorElement(value)) {
+        return true;
+    }
+    if ((0, react_1.isValidElement)(value) && value.type === react_1.Fragment) {
+        return true;
+    }
+    return (Array.isArray(value) &&
+        value.some((item) => isAuthorElement(item) || (0, react_1.isValidElement)(item)));
+};
+/** The field's array of items, or its one item; throws on a second element for a single-item field. */
+const valueFromBrand = (elements, field, env) => {
+    const items = elements.map((child) => itemFromElement(child, field, env));
+    if (field.array) {
+        return items;
+    }
+    if (items.length > 1) {
+        throw new error_1.IsomerError('UNEXPECTED_CHILDREN', `"${field.field}" takes one <${(0, authoring_model_1.capitalize)(field.childType)}>, not ${items.length}.`);
+    }
+    return items[0];
+};
+const itemFromElement = (child, field, env) => {
+    const element = requireAuthorElement(child, field.childType);
+    if (field.toItem) {
+        return field.toItem(element.props, {
+            parseChildren: (nested) => (0, exports.flattenChildren)(nested).map((node) => bodyNodeFromElement(node, env)),
+        });
+    }
+    const props = withoutChildren(element);
+    const nested = (0, exports.flattenChildren)(element.props.children);
+    const elements = nested.filter(isAuthorElement);
+    const text = nested.filter((child) => !isAuthorElement(child));
+    if (field.textField !== undefined &&
+        props[field.textField] === undefined &&
+        text.length > 0) {
+        props[field.textField] = (0, exports.textFromChildren)(text);
+    }
+    fillNestedBrands(field.itemSchema, props, elements, env);
+    return props;
+};
+const fillNestedBrands = (itemSchema, props, elements, env) => {
+    if (elements.length === 0) {
+        return;
+    }
+    for (const field of (0, authored_fields_1.readAuthoredSpec)(itemSchema).children) {
+        if (props[field.field] !== undefined) {
+            continue;
+        }
+        const matching = elements.filter((child) => getAuthorType(child) === field.childType);
+        if (matching.length > 0) {
+            props[field.field] = valueFromBrand(matching, field, env);
+        }
+    }
+};
+const convertPropValue = (value, field, slots, parseChild) => {
+    const asArray = slots.some((slot) => slot.field === field && slot.array);
+    const fromJsx = nodesFromJsx(value, parseChild);
+    if (fromJsx) {
+        return asArray ? fromJsx : fromJsx[0];
+    }
+    if (Array.isArray(value)) {
+        return value.flatMap((item) => {
+            const nodes = nodesFromJsx(item, parseChild);
+            return nodes ?? [item];
+        });
+    }
+    return value;
+};
+const nodesFromJsx = (value, parseChild) => {
+    if (isAuthorElement(value)) {
+        return [parseChild(value)];
+    }
+    if ((0, react_1.isValidElement)(value) && value.type === react_1.Fragment) {
+        return (0, exports.flattenChildren)(value).map(parseChild);
+    }
+    return undefined;
+};
+const isAuthorElement = (value) => {
+    if (!(0, react_1.isValidElement)(value)) {
+        return false;
+    }
+    const component = value.type;
+    return typeof component[jsx_1.authorType] === 'string';
+};
+/** React children as a flat array, with fragments inlined. */
+const flattenChildren = (children) => react_1.Children.toArray(children).flatMap((child) => {
+    if ((0, react_1.isValidElement)(child) && child.type === react_1.Fragment) {
+        const props = child.props;
+        return (0, exports.flattenChildren)(props.children);
+    }
+    return child;
+});
+exports.flattenChildren = flattenChildren;
+/**
+ * Children joined into one string. Throws on an element child, so a prop typed as text stays text. Collapses whitespace unless `{ collapseWhitespace: false }`.
+ */
+const textFromChildren = (children, options) => {
+    const text = (0, exports.flattenChildren)(children)
+        .map((child) => {
+        if (typeof child === 'string' || typeof child === 'number') {
+            return String(child);
+        }
+        throw new error_1.IsomerError('EXPECTED_TEXT_CHILDREN', 'Expected text children.');
+    })
+        .join('');
+    if (options?.collapseWhitespace === false) {
+        return text.trim();
+    }
+    return text.replace(/\s+/g, ' ').trim();
+};
+exports.textFromChildren = textFromChildren;
+/** An element's props without `children` and without `undefined` entries. */
+const withoutChildren = (element) => {
+    const props = { ...element.props };
+    delete props.children;
+    return omitUndefined(props);
+};
+/** Narrows `element` to an authoring element, asserting `type` when given. */
+const requireAuthorElement = (element, type) => {
+    assertValidElement(element);
+    const actual = getAuthorType(element);
+    if (type !== undefined && actual !== type) {
+        throw new error_1.IsomerError('AUTHOR_TYPE_MISMATCH', `Expected <${type}> but received <${actual}>.`);
+    }
+    return element;
+};
+/** The primitive type {@link authorType} brands onto `element`'s component. */
+const getAuthorType = (element) => {
+    const component = element.type;
+    const type = component[jsx_1.authorType];
+    if (!type) {
+        throw new error_1.IsomerError('EXPECTED_AUTHOR_COMPONENT', 'Expected an Isomer authoring component.');
+    }
+    return type;
+};
+const assertValidElement = (element) => {
+    if (!(0, react_1.isValidElement)(element)) {
+        throw new error_1.IsomerError('EXPECTED_JSX_ELEMENT', 'Expected an Isomer JSX element.');
+    }
+};
+const omitUndefined = (value) => Object.fromEntries(Object.entries(value).filter((entry) => entry[1] !== undefined));
+//# sourceMappingURL=jsx_shim.js.map

package/dist/cjs/author/jsx_shim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx_shim.js","sourceRoot":"","sources":["../../../src/author/jsx_shim.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 {\n  Children,\n  Fragment,\n  isValidElement,\n  type ReactElement,\n  type ReactNode,\n} from 'react';\nimport type { z, ZodObject, ZodType } from 'zod';\n\nimport type { Composition } from '../composition/composition';\nimport { IsomerError } from '../composition/error';\nimport type { PrimitiveNode } from '../define/primitive_module';\n\nimport {\n  type AuthoredChildBrand,\n  type AuthoredChildField,\n  type AuthoredSpec,\n  type AuthoredTextBrand,\n  type AuthoredToItemBrand,\n  type ItemSchema,\n  readAuthoredSpec,\n} from './authored_fields';\nimport {\n  capitalize,\n  type ChildSlot,\n  createAuthoringModel,\n} from './authoring_model';\nimport { type AuthorComponent, authorType, defineAuthorComponent } from './jsx';\n\n/** A {@link Composition} whose `body` is the pack's own authoring node type. */\nexport type AuthorComposition<TNode extends PrimitiveNode = PrimitiveNode> =\n  Omit<Composition<TNode>, 'body'> & {\n    body: TNode[];\n  };\n\n/**\n * Props of the shim's root element: the composition fields minus `type`, with\n * `body` given either as an array or as JSX children.\n */\nexport interface CompositionAuthorProps<\n  TNode extends PrimitiveNode = PrimitiveNode,\n> extends Omit<AuthorComposition<TNode>, 'type' | 'body'> {\n  /** Wins outright when present: `children` are then ignored, not merged. */\n  body?: TNode[];\n  /** Parsed into `body` only when `body` is absent. Each child must be an authoring element of a registered primitive type. */\n  children?: ReactNode;\n}\n\n/** Literal `type` strings; wide `string` is dropped so a string index cannot collide with `component`. */\ntype LiteralType<T extends string> = string extends T ? never : T;\n\n/** No keys. Intersects away, unlike `Record<string, never>`. */\ntype NoKeys = Record<never, never>;\n\ntype ShapeOf<T> = T extends { shape: infer Shape } ? Shape : NoKeys;\n\n/** A primitive's schema type, or `never` when it declares none. */\ntype SchemaOf<P> = P extends { schema: infer S }\n  ? S extends ZodObject\n    ? S\n    : never\n  : never;\n\n/** A bare `ZodObject` has a string index; a real shape does not. */\ntype LooseSchema<TSchema> = string extends keyof ShapeOf<TSchema>\n  ? true\n  : false;\n\n// The schema a brand is read from: `F`, or one an optional, nullable, default,\n// or readonly wrapper holds.\ntype Branded<F> = F extends\n  AuthoredChildBrand<string, unknown> | AuthoredTextBrand\n  ? F\n  : F extends {\n        _zod: {\n          def: {\n            type: 'optional' | 'nullable' | 'default' | 'readonly';\n            innerType: infer Inner;\n          };\n        };\n      }\n    ? Branded<Inner>\n    : F;\n\ntype AuthoredNames<TSchema> = {\n  [K in keyof ShapeOf<TSchema>]: Branded<ShapeOf<TSchema>[K]> extends\n    AuthoredChildBrand<string, unknown> | AuthoredTextBrand\n    ? K\n    : never;\n}[keyof ShapeOf<TSchema>];\n\ntype AuthorPropsForSchema<TSchema extends ZodObject> =\n  LooseSchema<TSchema> extends true\n    ? Record<string, unknown> & { children?: ReactNode }\n    : Omit<z.infer<TSchema>, 'type' | AuthoredNames<TSchema>> &\n        Partial<\n          Pick<\n            z.infer<TSchema>,\n            Extract<AuthoredNames<TSchema>, keyof z.infer<TSchema>>\n          >\n        > & { children?: ReactNode };\n\ntype AuthorPropsFor<P> = [SchemaOf<P>] extends [never]\n  ? Record<string, unknown> & { children?: ReactNode }\n  : AuthorPropsForSchema<SchemaOf<P>>;\n\ntype ChildEntry<F, TDepth extends unknown[]> = 0 extends 1 & F\n  ? NoKeys\n  : F extends AuthoredChildBrand<infer Name, infer Props>\n    ? [Name] extends [string]\n      ? {\n          [K in Capitalize<Name>]: AuthorComponent<\n            Props & { children?: ReactNode },\n            Name\n          >;\n        } & (F extends AuthoredToItemBrand\n          ? NoKeys\n          : ChildComponentsOf<ItemSchema<F>, [...TDepth, unknown]>)\n      : NoKeys\n    : NoKeys;\n\ntype UnionToIntersection<T> = (\n  T extends unknown ? (value: T) => void : never\n) extends (value: infer R) => void\n  ? R\n  : never;\n\n/** Child components branded on `TSchema`, then on each child's item schema, five levels deep. */\ntype ChildComponentsOf<\n  TSchema,\n  TDepth extends unknown[] = [],\n> = TDepth['length'] extends 5\n  ? NoKeys\n  : LooseSchema<TSchema> extends true\n    ? NoKeys\n    : UnionToIntersection<\n        {\n          [K in keyof ShapeOf<TSchema>]: ChildEntry<\n            Branded<ShapeOf<TSchema>[K]>,\n            TDepth\n          >;\n        }[keyof ShapeOf<TSchema>]\n      >;\n\ntype ChildMapOfTuple<TPrimitives> = TPrimitives extends readonly [\n  infer Head,\n  ...infer Tail,\n]\n  ? ChildComponentsOf<SchemaOf<Head>> &\n      ChildMapOfTuple<Tail extends readonly { type: string }[] ? Tail : []>\n  : NoKeys;\n\ntype ChildComponentMap<TPrimitives extends readonly { type: string }[]> =\n  ChildMapOfTuple<TPrimitives>;\n\n/**\n * PascalCase authoring components keyed from a pack's primitive `type` list.\n * `slideFrame` becomes `SlideFrame`. Props come from the primitive's schema.\n */\nexport type PrimitiveComponentMap<\n  TPrimitives extends readonly { type: string }[],\n> = {\n  [\n    P in TPrimitives[number] as Capitalize<LiteralType<P['type'] & string>>\n  ]: AuthorComponent<AuthorPropsFor<P>, P['type'] & string>;\n};\n\n/**\n * A pack's JSX authoring front: the root `Composition` element, one\n * PascalCase component per primitive and per branded child, and the conversion\n * back to plain data.\n */\nexport type JsxShim<\n  TNode extends PrimitiveNode = PrimitiveNode,\n  TPrimitives extends readonly { type: string }[] = readonly { type: string }[],\n> = {\n  Composition: AuthorComponent<CompositionAuthorProps<TNode>, 'view'>;\n  /** Throws when the root is not the `Composition` element, or when a child is not a registered primitive. */\n  toComposition: (\n    element: ReactElement<CompositionAuthorProps<TNode>>\n  ) => AuthorComposition<TNode>;\n} & PrimitiveComponentMap<TPrimitives> &\n  ChildComponentMap<TPrimitives>;\n\n/**\n * Builds a pack's {@link JsxShim} from its primitive list.\n *\n * Branded schema fields ({@link fromChildren}, {@link fromTextChildren}) fill\n * from JSX children, and each child type becomes a component. A primitive with\n * no brand still fills its one child slot, array or single node, from\n * {@link PrimitiveDefinition.children}.\n */\nexport const buildJsxShim = <\n  const TPrimitives extends readonly { type: string }[] = readonly {\n    type: string;\n  }[],\n  TNode extends PrimitiveNode = PrimitiveNode,\n>(\n  primitives: TPrimitives = [] as unknown as TPrimitives\n): JsxShim<TNode, TPrimitives> => {\n  const primitiveTypes = new Set(primitives.map((primitive) => primitive.type));\n  const { authoredByType, children, childSlotsByType } =\n    createAuthoringModel(primitives);\n  const childComponents = new Map(\n    [...children.keys()].map((type) => [type, defineAuthorComponent(type)])\n  );\n  const view = defineAuthorComponent<CompositionAuthorProps<TNode>, 'view'>(\n    'view'\n  );\n  const env: ParseEnv = {\n    authoredByType,\n    childSlotsByType,\n    primitiveTypes,\n  };\n\n  return {\n    Composition: view,\n    toComposition: (element) => toAuthorComposition<TNode>(element, env),\n    ...Object.fromEntries(\n      primitives.map((primitive) => [\n        capitalize(primitive.type),\n        defineAuthorComponent(primitive.type),\n      ])\n    ),\n    ...Object.fromEntries(\n      [...childComponents].map(([type, component]) => [\n        capitalize(type),\n        component,\n      ])\n    ),\n  } as JsxShim<TNode, TPrimitives>;\n};\n\ninterface ParseEnv {\n  authoredByType: ReadonlyMap<string, AuthoredSpec>;\n  childSlotsByType: ReadonlyMap<string, readonly ChildSlot[]>;\n  primitiveTypes: ReadonlySet<string>;\n}\n\nconst toAuthorComposition = <TNode extends PrimitiveNode>(\n  element: ReactElement<CompositionAuthorProps<TNode>>,\n  env: ParseEnv\n): AuthorComposition<TNode> => {\n  requireAuthorElement<CompositionAuthorProps<TNode>>(element, 'view');\n  const props = element.props;\n  const resolvedBody =\n    props.body ??\n    flattenChildren(props.children).map((child) =>\n      bodyNodeFromElement<TNode>(child, env)\n    );\n  const spec: AuthorComposition<TNode> = {\n    type: 'view',\n    body: resolvedBody,\n  };\n\n  if (props.version !== undefined) {\n    spec.version = props.version;\n  }\n  if (props.title !== undefined) {\n    spec.title = props.title;\n  }\n  if (props.subtitle !== undefined) {\n    spec.subtitle = props.subtitle;\n  }\n  if (props.theme !== undefined) {\n    spec.theme = props.theme;\n  }\n  if (props.meta !== undefined) {\n    spec.meta = props.meta;\n  }\n\n  return spec;\n};\n\nconst bodyNodeFromElement = <TNode extends PrimitiveNode>(\n  node: ReactNode,\n  env: ParseEnv\n): TNode => {\n  const element = requireAuthorElement<{ children?: ReactNode }>(node);\n  const type = getAuthorType(element);\n  if (!env.primitiveTypes.has(type)) {\n    throw new IsomerError(\n      'INVALID_BODY_NODE',\n      `\"${type}\" cannot be used as a composition body node.`\n    );\n  }\n\n  const parseChild = (child: ReactNode): TNode =>\n    bodyNodeFromElement<TNode>(child, env);\n  const slots = env.childSlotsByType.get(type) ?? [];\n  const authored = env.authoredByType.get(type);\n  const converted: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(\n    withoutChildren<Record<string, unknown>>(element)\n  )) {\n    const childField = authored?.children.find((field) => field.field === key);\n    converted[key] = childField\n      ? valueFromChildField(value, childField, env)\n      : convertPropValue(value, key, slots, parseChild);\n  }\n\n  const rawChildren = element.props.children;\n  if (authored && (authored.children.length > 0 || authored.text.length > 0)) {\n    fillAuthoredFields(converted, authored, rawChildren, env);\n  } else {\n    const unique = slots.length === 1 ? slots[0] : undefined;\n    if (\n      unique &&\n      converted[unique.field] === undefined &&\n      rawChildren !== undefined\n    ) {\n      const nested = flattenChildren(rawChildren).map(parseChild);\n      converted[unique.field] = unique.array ? nested : nested[0];\n    } else if (slots.length === 0 && flattenChildren(rawChildren).length > 0) {\n      throw new IsomerError(\n        'UNEXPECTED_CHILDREN',\n        `<${capitalize(type)}> takes no JSX children; set its fields through props.`\n      );\n    }\n  }\n\n  return omitUndefined({ ...converted, type }) as TNode;\n};\n\nconst fillAuthoredFields = (\n  converted: Record<string, unknown>,\n  authored: AuthoredSpec,\n  rawChildren: ReactNode,\n  env: ParseEnv\n): void => {\n  for (const field of authored.children) {\n    if (converted[field.field] !== undefined || rawChildren === undefined) {\n      continue;\n    }\n    converted[field.field] = valueFromBrand(\n      flattenChildren(rawChildren),\n      field,\n      env\n    );\n  }\n  for (const field of authored.text) {\n    if (converted[field.field] !== undefined) {\n      continue;\n    }\n    if (rawChildren === undefined) {\n      if (!field.optional) {\n        throw new IsomerError(\n          'MISSING_AUTHORED_TEXT',\n          `Expected text children for \"${field.field}\".`\n        );\n      }\n      continue;\n    }\n    converted[field.field] = textFromChildren(rawChildren, {\n      collapseWhitespace: field.collapseWhitespace,\n    });\n  }\n};\n\nconst valueFromChildField = (\n  value: unknown,\n  field: AuthoredChildField,\n  env: ParseEnv\n): unknown => {\n  if (isJsxNodes(value)) {\n    return valueFromBrand(flattenChildren(value), field, env);\n  }\n  return value;\n};\n\nconst isJsxNodes = (value: unknown): value is ReactNode => {\n  if (isAuthorElement(value)) {\n    return true;\n  }\n  if (isValidElement(value) && value.type === Fragment) {\n    return true;\n  }\n  return (\n    Array.isArray(value) &&\n    value.some((item: unknown) => isAuthorElement(item) || isValidElement(item))\n  );\n};\n\n/** The field's array of items, or its one item; throws on a second element for a single-item field. */\nconst valueFromBrand = (\n  elements: readonly ReactNode[],\n  field: AuthoredChildField,\n  env: ParseEnv\n): unknown => {\n  const items = elements.map((child) => itemFromElement(child, field, env));\n  if (field.array) {\n    return items;\n  }\n  if (items.length > 1) {\n    throw new IsomerError(\n      'UNEXPECTED_CHILDREN',\n      `\"${field.field}\" takes one <${capitalize(field.childType)}>, not ${items.length}.`\n    );\n  }\n  return items[0];\n};\n\nconst itemFromElement = (\n  child: ReactNode,\n  field: AuthoredChildField,\n  env: ParseEnv\n): unknown => {\n  const element = requireAuthorElement<Record<string, unknown>>(\n    child,\n    field.childType\n  );\n  if (field.toItem) {\n    return field.toItem(element.props, {\n      parseChildren: (nested) =>\n        flattenChildren(nested).map((node) => bodyNodeFromElement(node, env)),\n    });\n  }\n  const props = withoutChildren<Record<string, unknown>>(element);\n  const nested = flattenChildren(element.props.children);\n  const elements = nested.filter(isAuthorElement);\n  const text = nested.filter((child) => !isAuthorElement(child));\n  if (\n    field.textField !== undefined &&\n    props[field.textField] === undefined &&\n    text.length > 0\n  ) {\n    props[field.textField] = textFromChildren(text);\n  }\n  fillNestedBrands(field.itemSchema, props, elements, env);\n  return props;\n};\n\nconst fillNestedBrands = (\n  itemSchema: ZodType,\n  props: Record<string, unknown>,\n  elements: readonly ReactElement[],\n  env: ParseEnv\n): void => {\n  if (elements.length === 0) {\n    return;\n  }\n  for (const field of readAuthoredSpec(itemSchema).children) {\n    if (props[field.field] !== undefined) {\n      continue;\n    }\n    const matching = elements.filter(\n      (child) => getAuthorType(child) === field.childType\n    );\n    if (matching.length > 0) {\n      props[field.field] = valueFromBrand(matching, field, env);\n    }\n  }\n};\n\nconst convertPropValue = <TNode extends PrimitiveNode>(\n  value: unknown,\n  field: string,\n  slots: readonly ChildSlot[],\n  parseChild: (child: ReactNode) => TNode\n): unknown => {\n  const asArray = slots.some((slot) => slot.field === field && slot.array);\n  const fromJsx = nodesFromJsx(value, parseChild);\n  if (fromJsx) {\n    return asArray ? fromJsx : fromJsx[0];\n  }\n  if (Array.isArray(value)) {\n    return value.flatMap((item: unknown) => {\n      const nodes = nodesFromJsx(item, parseChild);\n      return nodes ?? [item];\n    });\n  }\n  return value;\n};\n\nconst nodesFromJsx = <TNode extends PrimitiveNode>(\n  value: unknown,\n  parseChild: (child: ReactNode) => TNode\n): TNode[] | undefined => {\n  if (isAuthorElement(value)) {\n    return [parseChild(value)];\n  }\n  if (isValidElement(value) && value.type === Fragment) {\n    return flattenChildren(value).map(parseChild);\n  }\n  return undefined;\n};\n\nconst isAuthorElement = (value: unknown): value is ReactElement => {\n  if (!isValidElement(value)) {\n    return false;\n  }\n  const component = value.type as Partial<AuthorComponent<unknown, string>>;\n  return typeof component[authorType] === 'string';\n};\n\n/** React children as a flat array, with fragments inlined. */\nexport const flattenChildren = (children: ReactNode): ReactNode[] =>\n  Children.toArray(children).flatMap((child) => {\n    if (isValidElement(child) && child.type === Fragment) {\n      const props = child.props as { children?: ReactNode };\n      return flattenChildren(props.children);\n    }\n    return child;\n  });\n\n/**\n * Children joined into one string. Throws on an element child, so a prop typed as text stays text. Collapses whitespace unless `{ collapseWhitespace: false }`.\n */\nexport const textFromChildren = (\n  children: ReactNode,\n  options?: { collapseWhitespace?: boolean }\n): string => {\n  const text = flattenChildren(children)\n    .map((child) => {\n      if (typeof child === 'string' || typeof child === 'number') {\n        return String(child);\n      }\n      throw new IsomerError(\n        'EXPECTED_TEXT_CHILDREN',\n        'Expected text children.'\n      );\n    })\n    .join('');\n  if (options?.collapseWhitespace === false) {\n    return text.trim();\n  }\n  return text.replace(/\\s+/g, ' ').trim();\n};\n\n/** An element's props without `children` and without `undefined` entries. */\nconst withoutChildren = <TProps>(element: ReactElement<unknown>): TProps => {\n  const props = { ...(element.props as TProps & { children?: ReactNode }) };\n  delete props.children;\n  return omitUndefined(props);\n};\n\n/** Narrows `element` to an authoring element, asserting `type` when given. */\nconst requireAuthorElement = <TProps>(\n  element: ReactNode,\n  type?: string\n): ReactElement<TProps & { children?: ReactNode }> => {\n  assertValidElement(element);\n  const actual = getAuthorType(element);\n  if (type !== undefined && actual !== type) {\n    throw new IsomerError(\n      'AUTHOR_TYPE_MISMATCH',\n      `Expected <${type}> but received <${actual}>.`\n    );\n  }\n  return element as ReactElement<TProps & { children?: ReactNode }>;\n};\n\n/** The primitive type {@link authorType} brands onto `element`'s component. */\nconst getAuthorType = (element: ReactElement<unknown>): string => {\n  const component = element.type as Partial<AuthorComponent<unknown, string>>;\n  const type = component[authorType];\n  if (!type) {\n    throw new IsomerError(\n      'EXPECTED_AUTHOR_COMPONENT',\n      'Expected an Isomer authoring component.'\n    );\n  }\n  return type;\n};\n\nconst assertValidElement: (\n  element: ReactNode\n) => asserts element is ReactElement<unknown> = (element) => {\n  if (!isValidElement(element)) {\n    throw new IsomerError(\n      'EXPECTED_JSX_ELEMENT',\n      'Expected an Isomer JSX element.'\n    );\n  }\n};\n\nconst omitUndefined = <T extends object>(value: T): T =>\n  Object.fromEntries(\n    Object.entries(value).filter((entry) => entry[1] !== undefined)\n  ) as T;\n"]}

package/dist/cjs/author/prompt.js

@@ -0,0 +1,153 @@
+"use strict";
+/*
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildAuthoringPrompt = exports.formatPrimitiveEntry = exports.AUTHORING_PROFILE_IDS = void 0;
+const one_line_1 = require("../composition/one_line");
+/** Every {@link AuthoringProfileId}. */
+exports.AUTHORING_PROFILE_IDS = [
+    'general',
+    'registered-view-router',
+    'compose-from-primitives',
+];
+const COMPOSE_INTRO_WITHOUT_SCHEMA = 'You compose views from scratch. Build a single JSON object that answers the question using only the primitives in the catalog below.';
+const INDEX_INTRO = 'Each primitive is listed by type and purpose. Before using one, request its catalog entry and JSON Schema by type; compose only from primitives whose details you have.';
+const PROFILE_INTROS = {
+    general: 'You author views: compact, host-portable operational displays expressed as a single JSON object. Route to a registered view when one answers the question; otherwise compose a view from the primitive catalog below.',
+    'registered-view-router': 'You route questions to registered views. Prefer an existing registered view whose answers index matches the question; request it by id with its input. Only fall back to composing a view when no registered view fits, using the catalog below.',
+    'compose-from-primitives': 'You compose views from scratch. Build a single JSON object that answers the question using only the primitives in the catalog below, and validate your output mentally against the JSON Schema before responding.',
+};
+/** Host-supplied composition examples kept after each primitive already shows its shape. */
+const PROFILE_EXAMPLE_LIMITS = {
+    general: 1,
+    'registered-view-router': 0,
+    'compose-from-primitives': 1,
+};
+const PROFILE_INCLUDES_SCHEMA = {
+    general: true,
+    'registered-view-router': false,
+    'compose-from-primitives': true,
+};
+/** Minified JSON with U+2028 and U+2029 escaped, so it always prints on one line. */
+const compactJson = (value) => String(JSON.stringify(value)).replace(/[\u2028\u2029]/g, (separator) => `\\u${separator.charCodeAt(0).toString(16)}`);
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+/** Host examples show composition, not provenance. */
+const withoutMeta = (value) => {
+    if (!isRecord(value) || !('meta' in value)) {
+        return value;
+    }
+    const rest = { ...value };
+    delete rest.meta;
+    return rest;
+};
+/** `text` as a Markdown code span, fenced longer than any backtick run inside it. */
+const codeSpan = (text) => {
+    const longestRun = Math.max(0, ...(text.match(/`+/g) ?? []).map(({ length }) => length));
+    const fence = '`'.repeat(longestRun + 1);
+    const pad = /^`|`$/.test(text) ? ' ' : '';
+    return `${fence}${pad}${text}${pad}${fence}`;
+};
+/** A lookup key as a code span, JSON-quoted when it would not survive printing bare. */
+const keySpan = (key) => codeSpan(key !== '' && key.trim() === key && !/[\p{Cc}\p{Cs}\u2028\u2029]/u.test(key)
+    ? key
+    : compactJson(key));
+/** One primitive's catalog bullet: its purpose, `useWhen`, `avoidWhen`, and example. */
+const formatPrimitiveEntry = (entry) => {
+    const lines = [`- ${keySpan(entry.type)} — ${(0, one_line_1.oneLine)(entry.purpose)}`];
+    if (entry.useWhen.length > 0) {
+        lines.push(`  - Use when: ${(0, one_line_1.oneLine)(entry.useWhen.join(' '))}`);
+    }
+    if (entry.avoidWhen.length > 0) {
+        lines.push(`  - Avoid when: ${(0, one_line_1.oneLine)(entry.avoidWhen.join(' '))}`);
+    }
+    lines.push(`  - Example: ${codeSpan(compactJson(entry.example))}`);
+    return lines.join('\n');
+};
+exports.formatPrimitiveEntry = formatPrimitiveEntry;
+const renderCatalog = (primitives) => primitives.map(exports.formatPrimitiveEntry).join('\n');
+const renderIndex = (primitives, groups = []) => {
+    const byType = new Map(primitives.map((entry) => [entry.type, entry]));
+    const grouped = new Set(groups.flatMap(({ types }) => types));
+    const sections = [
+        ...groups.map(({ title, types }) => ({
+            title,
+            entries: types.flatMap((type) => byType.get(type) ?? []),
+        })),
+        {
+            title: 'Other',
+            entries: primitives.filter(({ type }) => !grouped.has(type)),
+        },
+    ];
+    return [
+        INDEX_INTRO,
+        ...sections
+            .filter(({ entries }) => entries.length > 0)
+            .map(({ title, entries }) => `### ${(0, one_line_1.oneLine)(title)}\n\n${entries
+            .map(({ type, purpose }) => `- ${keySpan(type)} — ${(0, one_line_1.oneLine)(purpose)}`)
+            .join('\n')}`),
+    ].join('\n\n');
+};
+const renderViews = (views) => views
+    .map((view) => {
+    const lines = [`- ${keySpan(view.id)} — ${(0, one_line_1.oneLine)(view.title)}`];
+    if (view.description !== undefined && view.description.length > 0) {
+        lines.push(`  - ${(0, one_line_1.oneLine)(view.description)}`);
+    }
+    if (view.answers.length > 0) {
+        lines.push(`  - Answers: ${(0, one_line_1.oneLine)(view.answers.join('; '))}`);
+    }
+    if (view.inputSchema !== undefined) {
+        lines.push(`  - Input: ${codeSpan(compactJson(view.inputSchema))}`);
+    }
+    return lines.join('\n');
+})
+    .join('\n');
+const renderExamples = (examples) => examples
+    .map((example) => `\`\`\`json\n${compactJson(withoutMeta(example))}\n\`\`\``)
+    .join('\n\n');
+/**
+ * Assembles `context` into the prompt for `profile`, trimming the examples to
+ * that profile's budget.
+ *
+ * The copy says "view" throughout because that is the wire discriminator and
+ * the word models are trained and prompted on; pass `heading` and `intro` to
+ * override it per host.
+ */
+const buildAuthoringPrompt = (profile, context) => {
+    const examples = context.examples
+        .slice(0, PROFILE_EXAMPLE_LIMITS[profile])
+        .map(withoutMeta);
+    const views = context.views ?? [];
+    const schema = PROFILE_INCLUDES_SCHEMA[profile] ? context.schema : undefined;
+    const intro = profile === 'compose-from-primitives' && schema === undefined
+        ? COMPOSE_INTRO_WITHOUT_SCHEMA
+        : PROFILE_INTROS[profile];
+    const sections = [
+        context.heading ?? '# View authoring',
+        context.intro ?? intro,
+        `## Guide\n\n${context.guide}`,
+    ];
+    if (context.rules !== undefined && context.rules.length > 0) {
+        sections.push(`## Rules\n\n${context.rules}`);
+    }
+    if (views.length > 0) {
+        sections.push(`## Registered views\n\n${renderViews(views)}`);
+    }
+    const catalog = context.catalog === 'index'
+        ? renderIndex(context.primitives, context.groups)
+        : renderCatalog(context.primitives);
+    sections.push(`## Primitive catalog\n\n${catalog}`);
+    if (schema !== undefined) {
+        sections.push(`## JSON Schema\n\n\`\`\`json\n${compactJson(schema)}\n\`\`\``);
+    }
+    if (examples.length > 0) {
+        sections.push(`## Examples\n\n${renderExamples(examples)}`);
+    }
+    return sections.join('\n\n');
+};
+exports.buildAuthoringPrompt = buildAuthoringPrompt;
+//# sourceMappingURL=prompt.js.map

package/dist/cjs/author/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/author/prompt.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 { oneLine } from '../composition/one_line';\nimport type { PrimitiveCatalogEntry } from '../define/primitive_module';\nimport type { PrimitiveGroup } from '../pack/primitive_pack';\n\ntype JsonSchema = Record<string, unknown>;\n\n/** Which authoring job the prompt frames for the model. */\nexport type AuthoringProfileId =\n  'general' | 'registered-view-router' | 'compose-from-primitives';\n\n/** Every {@link AuthoringProfileId}. */\nexport const AUTHORING_PROFILE_IDS: readonly AuthoringProfileId[] = [\n  'general',\n  'registered-view-router',\n  'compose-from-primitives',\n];\n\n/**\n * A registered view, declared structurally so this module does not import the\n * runtime. {@link RegisteredViewSummary} must stay assignable to this.\n */\nexport interface AuthoringViewSummary {\n  id: string;\n  title: string;\n  description?: string;\n  /** Natural-language queries the view answers, printed so the model can route by them. */\n  answers: readonly string[];\n  /** JSON Schema for the view's input, printed inline when present. */\n  inputSchema?: JsonSchema;\n}\n\n/** The pack-supplied material {@link buildAuthoringPrompt} assembles. */\nexport interface AuthoringPromptContext {\n  guide: string;\n  /** Absent or empty drops the `## Rules` section. */\n  rules?: string;\n  /** JSON Schema for a whole composition. Absent, or under the router profile, it is not inlined. */\n  schema?: JsonSchema;\n  /** Rendered as a bullet per entry, with its `useWhen`, `avoidWhen`, and `example`. */\n  primitives: readonly PrimitiveCatalogEntry[];\n  /** `'index'` lists each primitive's type and purpose only, for a host that serves the rest on request. */\n  catalog?: 'full' | 'index';\n  /** Headings an index sorts primitives under; a type in none is listed under \"Other\". */\n  groups?: readonly PrimitiveGroup[];\n  /**\n   * Extra host-supplied compositions beyond each primitive's catalog example.\n   * Trimmed to the profile's budget. An empty list drops `## Examples`.\n   */\n  examples: readonly unknown[];\n  /** Registered views the model can request by id. An empty list drops the section. */\n  views?: readonly AuthoringViewSummary[];\n  /** Defaults to `'# View authoring'`. */\n  heading?: string;\n  /** Replaces the profile's own framing sentence. */\n  intro?: string;\n}\n\nconst COMPOSE_INTRO_WITHOUT_SCHEMA =\n  'You compose views from scratch. Build a single JSON object that answers the question using only the primitives in the catalog below.';\n\nconst INDEX_INTRO =\n  'Each primitive is listed by type and purpose. Before using one, request its catalog entry and JSON Schema by type; compose only from primitives whose details you have.';\n\nconst PROFILE_INTROS: Record<AuthoringProfileId, string> = {\n  general:\n    'You author views: compact, host-portable operational displays expressed as a single JSON object. Route to a registered view when one answers the question; otherwise compose a view from the primitive catalog below.',\n  'registered-view-router':\n    'You route questions to registered views. Prefer an existing registered view whose answers index matches the question; request it by id with its input. Only fall back to composing a view when no registered view fits, using the catalog below.',\n  'compose-from-primitives':\n    'You compose views from scratch. Build a single JSON object that answers the question using only the primitives in the catalog below, and validate your output mentally against the JSON Schema before responding.',\n};\n\n/** Host-supplied composition examples kept after each primitive already shows its shape. */\nconst PROFILE_EXAMPLE_LIMITS: Record<AuthoringProfileId, number> = {\n  general: 1,\n  'registered-view-router': 0,\n  'compose-from-primitives': 1,\n};\n\nconst PROFILE_INCLUDES_SCHEMA: Record<AuthoringProfileId, boolean> = {\n  general: true,\n  'registered-view-router': false,\n  'compose-from-primitives': true,\n};\n\n/** Minified JSON with U+2028 and U+2029 escaped, so it always prints on one line. */\nconst compactJson = (value: unknown): string =>\n  String(JSON.stringify(value)).replace(\n    /[\\u2028\\u2029]/g,\n    (separator) => `\\\\u${separator.charCodeAt(0).toString(16)}`\n  );\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value);\n\n/** Host examples show composition, not provenance. */\nconst withoutMeta = (value: unknown): unknown => {\n  if (!isRecord(value) || !('meta' in value)) {\n    return value;\n  }\n  const rest = { ...value };\n  delete rest.meta;\n  return rest;\n};\n\n/** `text` as a Markdown code span, fenced longer than any backtick run inside it. */\nconst codeSpan = (text: string): string => {\n  const longestRun = Math.max(\n    0,\n    ...(text.match(/`+/g) ?? []).map(({ length }) => length)\n  );\n  const fence = '`'.repeat(longestRun + 1);\n  const pad = /^`|`$/.test(text) ? ' ' : '';\n  return `${fence}${pad}${text}${pad}${fence}`;\n};\n\n/** A lookup key as a code span, JSON-quoted when it would not survive printing bare. */\nconst keySpan = (key: string): string =>\n  codeSpan(\n    key !== '' && key.trim() === key && !/[\\p{Cc}\\p{Cs}\\u2028\\u2029]/u.test(key)\n      ? key\n      : compactJson(key)\n  );\n\n/** One primitive's catalog bullet: its purpose, `useWhen`, `avoidWhen`, and example. */\nexport const formatPrimitiveEntry = (entry: PrimitiveCatalogEntry): string => {\n  const lines = [`- ${keySpan(entry.type)} — ${oneLine(entry.purpose)}`];\n  if (entry.useWhen.length > 0) {\n    lines.push(`  - Use when: ${oneLine(entry.useWhen.join(' '))}`);\n  }\n  if (entry.avoidWhen.length > 0) {\n    lines.push(`  - Avoid when: ${oneLine(entry.avoidWhen.join(' '))}`);\n  }\n  lines.push(`  - Example: ${codeSpan(compactJson(entry.example))}`);\n  return lines.join('\\n');\n};\n\nconst renderCatalog = (primitives: readonly PrimitiveCatalogEntry[]): string =>\n  primitives.map(formatPrimitiveEntry).join('\\n');\n\nconst renderIndex = (\n  primitives: readonly PrimitiveCatalogEntry[],\n  groups: readonly PrimitiveGroup[] = []\n): string => {\n  const byType = new Map(primitives.map((entry) => [entry.type, entry]));\n  const grouped = new Set(groups.flatMap(({ types }) => types));\n  const sections = [\n    ...groups.map(({ title, types }) => ({\n      title,\n      entries: types.flatMap((type) => byType.get(type) ?? []),\n    })),\n    {\n      title: 'Other',\n      entries: primitives.filter(({ type }) => !grouped.has(type)),\n    },\n  ];\n  return [\n    INDEX_INTRO,\n    ...sections\n      .filter(({ entries }) => entries.length > 0)\n      .map(\n        ({ title, entries }) =>\n          `### ${oneLine(title)}\\n\\n${entries\n            .map(\n              ({ type, purpose }) => `- ${keySpan(type)} — ${oneLine(purpose)}`\n            )\n            .join('\\n')}`\n      ),\n  ].join('\\n\\n');\n};\n\nconst renderViews = (views: readonly AuthoringViewSummary[]): string =>\n  views\n    .map((view) => {\n      const lines = [`- ${keySpan(view.id)} — ${oneLine(view.title)}`];\n      if (view.description !== undefined && view.description.length > 0) {\n        lines.push(`  - ${oneLine(view.description)}`);\n      }\n      if (view.answers.length > 0) {\n        lines.push(`  - Answers: ${oneLine(view.answers.join('; '))}`);\n      }\n      if (view.inputSchema !== undefined) {\n        lines.push(`  - Input: ${codeSpan(compactJson(view.inputSchema))}`);\n      }\n      return lines.join('\\n');\n    })\n    .join('\\n');\n\nconst renderExamples = (examples: readonly unknown[]): string =>\n  examples\n    .map(\n      (example) => `\\`\\`\\`json\\n${compactJson(withoutMeta(example))}\\n\\`\\`\\``\n    )\n    .join('\\n\\n');\n\n/**\n * Assembles `context` into the prompt for `profile`, trimming the examples to\n * that profile's budget.\n *\n * The copy says \"view\" throughout because that is the wire discriminator and\n * the word models are trained and prompted on; pass `heading` and `intro` to\n * override it per host.\n */\nexport const buildAuthoringPrompt = (\n  profile: AuthoringProfileId,\n  context: AuthoringPromptContext\n): string => {\n  const examples = context.examples\n    .slice(0, PROFILE_EXAMPLE_LIMITS[profile])\n    .map(withoutMeta);\n  const views = context.views ?? [];\n  const schema = PROFILE_INCLUDES_SCHEMA[profile] ? context.schema : undefined;\n  const intro =\n    profile === 'compose-from-primitives' && schema === undefined\n      ? COMPOSE_INTRO_WITHOUT_SCHEMA\n      : PROFILE_INTROS[profile];\n  const sections = [\n    context.heading ?? '# View authoring',\n    context.intro ?? intro,\n    `## Guide\\n\\n${context.guide}`,\n  ];\n  if (context.rules !== undefined && context.rules.length > 0) {\n    sections.push(`## Rules\\n\\n${context.rules}`);\n  }\n  if (views.length > 0) {\n    sections.push(`## Registered views\\n\\n${renderViews(views)}`);\n  }\n  const catalog =\n    context.catalog === 'index'\n      ? renderIndex(context.primitives, context.groups)\n      : renderCatalog(context.primitives);\n  sections.push(`## Primitive catalog\\n\\n${catalog}`);\n  if (schema !== undefined) {\n    sections.push(\n      `## JSON Schema\\n\\n\\`\\`\\`json\\n${compactJson(schema)}\\n\\`\\`\\``\n    );\n  }\n  if (examples.length > 0) {\n    sections.push(`## Examples\\n\\n${renderExamples(examples)}`);\n  }\n  return sections.join('\\n\\n');\n};\n"]}