@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/cjs/pack/compose.js

@@ -0,0 +1,59 @@
+"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.composePacks = void 0;
+const error_1 = require("../composition/error");
+const primitive_pack_1 = require("./primitive_pack");
+/**
+ * Flattens `packs` into one inventory, rejecting cross-pack duplicate node
+ * types and duplicate enhancement ids. Every offender is named in one error,
+ * so a bad three-pack composition reports all three at once.
+ */
+const composePacks = (packs) => {
+    const typeOwners = new Map();
+    const enhancementOwners = new Map();
+    for (const pack of packs) {
+        for (const { type } of pack.primitives) {
+            typeOwners.set(type, [...(typeOwners.get(type) ?? []), pack.id]);
+        }
+        for (const { id } of pack.enhancements) {
+            enhancementOwners.set(id, [
+                ...(enhancementOwners.get(id) ?? []),
+                pack.id,
+            ]);
+        }
+    }
+    const repeated = [
+        ...new Set(packs
+            .map(({ id }) => id)
+            .filter((id, index, ids) => ids.indexOf(id) !== index)),
+    ];
+    if (repeated.length > 0) {
+        throw new error_1.IsomerError('DUPLICATE_PACK_ID', `composePacks: ${repeated.map((id) => `"${id}"`).join(', ')} names more than one pack; pack ids must be unique`);
+    }
+    assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);
+    assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);
+    const definitions = packs.flatMap((pack) => [...pack.primitives]);
+    return Object.freeze({
+        definitions: Object.freeze(definitions),
+        enhancements: Object.freeze(packs.flatMap((pack) => [...pack.enhancements])),
+        icons: (0, primitive_pack_1.iconsByType)(definitions),
+        slackAssetTypes: new Set(packs.flatMap((pack) => [...pack.slackAssetTypes])),
+    });
+};
+exports.composePacks = composePacks;
+const assertUnique = (code, noun, owners) => {
+    const duplicates = [...owners].filter(([, packs]) => packs.length > 1);
+    if (duplicates.length === 0) {
+        return;
+    }
+    throw new error_1.IsomerError(code, duplicates
+        .map(([key, packs]) => `${noun} "${key}" registered by ${packs.map((id) => `"${id}"`).join(' and ')}`)
+        .join('; '));
+};
+//# sourceMappingURL=compose.js.map

package/dist/cjs/pack/compose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.js","sourceRoot":"","sources":["../../../src/pack/compose.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 { IsomerError } from '../composition/error';\nimport type { PrimitiveIcon } from '../define/primitive_icon';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\nimport { type AnyPrimitivePack, iconsByType } from './primitive_pack';\n\n/**\n * One flattened inventory owned by {@link composePacks}.\n *\n * `definitions` is a stable array identity, which is what the composition\n * schema cache keys on — pass it through rather than flattening packs per call.\n */\nexport interface ComposedPacks {\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  readonly enhancements: readonly EnhancementDefinition[];\n  /** Every definition's `icon` by type, in one frozen null-prototype dictionary. */\n  readonly icons: Readonly<Record<string, PrimitiveIcon>>;\n  readonly slackAssetTypes: ReadonlySet<string>;\n}\n\n/**\n * Flattens `packs` into one inventory, rejecting cross-pack duplicate node\n * types and duplicate enhancement ids. Every offender is named in one error,\n * so a bad three-pack composition reports all three at once.\n */\nexport const composePacks = (\n  packs: readonly AnyPrimitivePack[]\n): ComposedPacks => {\n  const typeOwners = new Map<string, string[]>();\n  const enhancementOwners = new Map<string, string[]>();\n  for (const pack of packs) {\n    for (const { type } of pack.primitives) {\n      typeOwners.set(type, [...(typeOwners.get(type) ?? []), pack.id]);\n    }\n    for (const { id } of pack.enhancements) {\n      enhancementOwners.set(id, [\n        ...(enhancementOwners.get(id) ?? []),\n        pack.id,\n      ]);\n    }\n  }\n  const repeated = [\n    ...new Set(\n      packs\n        .map(({ id }) => id)\n        .filter((id, index, ids) => ids.indexOf(id) !== index)\n    ),\n  ];\n  if (repeated.length > 0) {\n    throw new IsomerError(\n      'DUPLICATE_PACK_ID',\n      `composePacks: ${repeated.map((id) => `\"${id}\"`).join(', ')} names more than one pack; pack ids must be unique`\n    );\n  }\n  assertUnique('DUPLICATE_PRIMITIVE_TYPE', 'primitive type', typeOwners);\n  assertUnique('DUPLICATE_ENHANCEMENT', 'enhancement', enhancementOwners);\n\n  const definitions = packs.flatMap((pack) => [...pack.primitives]);\n  return Object.freeze({\n    definitions: Object.freeze(definitions),\n    enhancements: Object.freeze(\n      packs.flatMap((pack) => [...pack.enhancements])\n    ),\n    icons: iconsByType(definitions),\n    slackAssetTypes: new Set(\n      packs.flatMap((pack) => [...pack.slackAssetTypes])\n    ),\n  });\n};\n\nconst assertUnique = (\n  code: 'DUPLICATE_ENHANCEMENT' | 'DUPLICATE_PRIMITIVE_TYPE',\n  noun: string,\n  owners: ReadonlyMap<string, readonly string[]>\n): void => {\n  const duplicates = [...owners].filter(([, packs]) => packs.length > 1);\n  if (duplicates.length === 0) {\n    return;\n  }\n  throw new IsomerError(\n    code,\n    duplicates\n      .map(\n        ([key, packs]) =>\n          `${noun} \"${key}\" registered by ${packs.map((id) => `\"${id}\"`).join(' and ')}`\n      )\n      .join('; ')\n  );\n};\n"]}

package/dist/cjs/pack/enhancements.js

@@ -0,0 +1,65 @@
+"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.runEnhancementScript = exports.EMBEDDED_SCRIPT_ATTRIBUTE = exports.scopeScript = exports.resolveEnhancements = void 0;
+const error_1 = require("../composition/error");
+/**
+ * The `definitions` that apply to `body`, the first of each id, limited to
+ * `requested` ids when given. The HTML and React surfaces both resolve through
+ * it, so the two cannot disagree on which enhancements a render carries.
+ */
+const resolveEnhancements = (body, walk, definitions, requested) => {
+    const wanted = requested && new Set(requested);
+    const ids = new Set();
+    return definitions.filter((definition) => {
+        if (ids.has(definition.id) ||
+            (wanted && !wanted.has(definition.id)) ||
+            !definition.appliesTo(body, walk)) {
+            return false;
+        }
+        ids.add(definition.id);
+        return true;
+    });
+};
+exports.resolveEnhancements = resolveEnhancements;
+/**
+ * Wraps one script body in its own function, so its `const`s and a top-level
+ * `return` stay its own. Anything that joins script bodies scopes each first.
+ */
+const scopeScript = (body) => `(() => {\n${body}\n})();`;
+exports.scopeScript = scopeScript;
+/** Marks the `<script>` a `scripts: 'embedded'` render emits. */
+exports.EMBEDDED_SCRIPT_ATTRIBUTE = 'data-isomer-script';
+/**
+ * Runs a `scripts: 'host'` render's `js` against the
+ * `.isomer` section the host inserted.
+ *
+ * Needed wherever the HTML is inserted by the host rather than parsed with the
+ * page, including every shadow root: such a `<script>` never runs, and one
+ * that did would find no `document.currentScript`.
+ *
+ * Compiles with `new Function`, so a strict Content-Security-Policy must allow
+ * `'unsafe-eval'`. A host that cannot should render with `scripts: 'embedded'`
+ * into light DOM.
+ */
+const runEnhancementScript = (js, root) => {
+    // Guards untyped callers; typed ones already handled `querySelector`'s null.
+    if (!root) {
+        throw new error_1.IsomerError('ENHANCEMENT_ROOT_MISSING', 'runEnhancementScript: no root element; pass the `.isomer` section the render produced');
+    }
+    if (root.querySelector(`script[${exports.EMBEDDED_SCRIPT_ATTRIBUTE}]`)) {
+        console.warn("isomer: this HTML was rendered with scripts: 'embedded'; render with scripts: 'host' so its enhancements run once");
+    }
+    if (js) {
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval -- compiling the render's script is the point.
+        const run = new Function('root', js);
+        run(root);
+    }
+};
+exports.runEnhancementScript = runEnhancementScript;
+//# sourceMappingURL=enhancements.js.map

package/dist/cjs/pack/enhancements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancements.js","sourceRoot":"","sources":["../../../src/pack/enhancements.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAGH,gDAAmD;AAwCnD;;;;GAIG;AACI,MAAM,mBAAmB,GAAG,CACjC,IAA8B,EAC9B,IAAqB,EACrB,WAA6C,EAC7C,SAA6B,EACJ,EAAE;IAC3B,MAAM,MAAM,GAAG,SAAS,IAAI,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE;QACvC,IACE,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACtB,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,EACjC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAnBW,QAAA,mBAAmB,uBAmB9B;AAEF;;;GAGG;AACI,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,aAAa,IAAI,SAAS,CAAC;AAAnE,QAAA,WAAW,eAAwD;AAEhF,iEAAiE;AACpD,QAAA,yBAAyB,GAAG,oBAAoB,CAAC;AAE9D;;;;;;;;;;;GAWG;AACI,MAAM,oBAAoB,GAAG,CAAC,EAAU,EAAE,IAAa,EAAQ,EAAE;IACtE,6EAA6E;IAC7E,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,mBAAW,CACnB,0BAA0B,EAC1B,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,aAAa,CAAC,UAAU,iCAAyB,GAAG,CAAC,EAAE,CAAC;QAC/D,OAAO,CAAC,IAAI,CACV,mHAAmH,CACpH,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,EAAE,CAAC;QACP,6GAA6G;QAC7G,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAA4B,CAAC;QAChE,GAAG,CAAC,IAAI,CAAC,CAAC;IACZ,CAAC;AACH,CAAC,CAAC;AAlBW,QAAA,oBAAoB,wBAkB/B","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 { ChildNodeWalker } from '../composition/body_node_base';\nimport { IsomerError } from '../composition/error';\nimport type { PrimitiveNode } from '../composition/node';\n\n/**\n * A progressive enhancement any vocabulary pack may declare.\n *\n * Ids are open strings rather than a closed union so a second pack can\n * register one without editing a shared type. Duplicate ids across packs in\n * one runtime are rejected at construction.\n */\nexport interface EnhancementDefinition {\n  /** What a renderer tests for via `context.enhancements`. Unique across a runtime's packs. */\n  id: string;\n  /**\n   * Whether this composition has anything for the enhancement to act on.\n   * Gating on content rather than the opt-in alone is what keeps a composition\n   * with no matching node from shipping the script.\n   *\n   * `walk` is the composition's child walker, so a match nested inside a\n   * container from another pack is still found.\n   */\n  appliesTo: (body: readonly PrimitiveNode[], walk: ChildNodeWalker) => boolean;\n  /**\n   * A function body with `root: Element`, the render's `.isomer` section, in\n   * scope. It runs in its own function, so a top-level `const` or `return`\n   * cannot reach another enhancement. Absent when the host drives the\n   * enhancement itself.\n   *\n   * It must not look for its root through `document.currentScript`, which is\n   * `null` inside a shadow root. It must address markup through `data-*`\n   * attributes rather than class names: class names are minified per render,\n   * and a selector written against one is a contract nothing checks. An event\n   * meant for the host sets `composed: true` as well as `bubbles: true`, or it\n   * stops at a shadow boundary.\n   */\n  script?: string;\n  /** Renders node anchors when resolved, for an enhancement that finds nodes with `findNodeElementPairs`. */\n  anchors?: true;\n}\n\n/**\n * The `definitions` that apply to `body`, the first of each id, limited to\n * `requested` ids when given. The HTML and React surfaces both resolve through\n * it, so the two cannot disagree on which enhancements a render carries.\n */\nexport const resolveEnhancements = (\n  body: readonly PrimitiveNode[],\n  walk: ChildNodeWalker,\n  definitions: readonly EnhancementDefinition[],\n  requested?: readonly string[]\n): EnhancementDefinition[] => {\n  const wanted = requested && new Set(requested);\n  const ids = new Set<string>();\n  return definitions.filter((definition) => {\n    if (\n      ids.has(definition.id) ||\n      (wanted && !wanted.has(definition.id)) ||\n      !definition.appliesTo(body, walk)\n    ) {\n      return false;\n    }\n    ids.add(definition.id);\n    return true;\n  });\n};\n\n/**\n * Wraps one script body in its own function, so its `const`s and a top-level\n * `return` stay its own. Anything that joins script bodies scopes each first.\n */\nexport const scopeScript = (body: string): string => `(() => {\\n${body}\\n})();`;\n\n/** Marks the `<script>` a `scripts: 'embedded'` render emits. */\nexport const EMBEDDED_SCRIPT_ATTRIBUTE = 'data-isomer-script';\n\n/**\n * Runs a `scripts: 'host'` render's `js` against the\n * `.isomer` section the host inserted.\n *\n * Needed wherever the HTML is inserted by the host rather than parsed with the\n * page, including every shadow root: such a `<script>` never runs, and one\n * that did would find no `document.currentScript`.\n *\n * Compiles with `new Function`, so a strict Content-Security-Policy must allow\n * `'unsafe-eval'`. A host that cannot should render with `scripts: 'embedded'`\n * into light DOM.\n */\nexport const runEnhancementScript = (js: string, root: Element): void => {\n  // Guards untyped callers; typed ones already handled `querySelector`'s null.\n  if (!root) {\n    throw new IsomerError(\n      'ENHANCEMENT_ROOT_MISSING',\n      'runEnhancementScript: no root element; pass the `.isomer` section the render produced'\n    );\n  }\n  if (root.querySelector(`script[${EMBEDDED_SCRIPT_ATTRIBUTE}]`)) {\n    console.warn(\n      \"isomer: this HTML was rendered with scripts: 'embedded'; render with scripts: 'host' so its enhancements run once\"\n    );\n  }\n  if (js) {\n    // eslint-disable-next-line @typescript-eslint/no-implied-eval -- compiling the render's script is the point.\n    const run = new Function('root', js) as (root: Element) => void;\n    run(root);\n  }\n};\n"]}

package/dist/cjs/pack/index.js

@@ -0,0 +1,18 @@
+"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.definePrimitivePack = exports.scopeScript = exports.composePacks = exports.describeCapabilities = void 0;
+var capabilities_1 = require("./capabilities");
+Object.defineProperty(exports, "describeCapabilities", { enumerable: true, get: function () { return capabilities_1.describeCapabilities; } });
+var compose_1 = require("./compose");
+Object.defineProperty(exports, "composePacks", { enumerable: true, get: function () { return compose_1.composePacks; } });
+var enhancements_1 = require("./enhancements");
+Object.defineProperty(exports, "scopeScript", { enumerable: true, get: function () { return enhancements_1.scopeScript; } });
+var primitive_pack_1 = require("./primitive_pack");
+Object.defineProperty(exports, "definePrimitivePack", { enumerable: true, get: function () { return primitive_pack_1.definePrimitivePack; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/pack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pack/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,+CAKwB;AADtB,oHAAA,oBAAoB,OAAA;AAEtB,qCAA6D;AAAhC,uGAAA,YAAY,OAAA;AACzC,+CAAyE;AAApC,2GAAA,WAAW,OAAA;AAChD,mDAQ0B;AADxB,qHAAA,mBAAmB,OAAA","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 CapabilitySources,\n  type HostCapabilities,\n  type SurfaceSupport,\n  describeCapabilities,\n} from './capabilities';\nexport { type ComposedPacks, composePacks } from './compose';\nexport { type EnhancementDefinition, scopeScript } from './enhancements';\nexport {\n  type AnyPrimitivePack,\n  type PackAuthoringOptions,\n  type PackStyleAdapter,\n  type PrimitiveGroup,\n  type PrimitivePack,\n  type PrimitivePackInput,\n  definePrimitivePack,\n} from './primitive_pack';\n"]}

package/dist/cjs/pack/primitive_pack.js

@@ -0,0 +1,97 @@
+"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.iconsByType = exports.definePrimitivePack = void 0;
+// A primitive pack as a value: a vocabulary, and the optional surfaces every
+// primitive in it implements. Additive: a runtime composes any number of packs,
+// and nothing about a pack decides how a composition is framed.
+const error_1 = require("../composition/error");
+/**
+ * Builds a {@link PrimitivePack}.
+ *
+ * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn
+ * on the `snapshot` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is
+ * `unknown`, which requires nothing.
+ */
+const definePrimitivePack = (input) => {
+    if (input.primitives.length === 0) {
+        throw new error_1.IsomerError('EMPTY_PACK', `primitive pack "${input.id}": at least one primitive is required`);
+    }
+    assertUniquePrimitiveTypes(input.id, input.primitives);
+    assertUniqueEnhancementIds(input.id, input.enhancements ?? []);
+    const types = new Set(input.primitives.map((definition) => definition.type));
+    assertGroupedOnce(input.id, input.authoring?.groups ?? [], types);
+    for (const type of input.slackAssetTypes ?? []) {
+        if (!types.has(type)) {
+            throw new error_1.IsomerError('UNKNOWN_PRIMITIVE_TYPE', `primitive pack "${input.id}": slackAssetTypes names primitive type "${type}", which the pack does not register`);
+        }
+    }
+    const styleCollector = input.styleCollector ?? input.styleAdapter?.styleCollector;
+    return {
+        id: input.id,
+        surfaces: input.surfaces ?? [],
+        primitives: input.primitives,
+        types,
+        icons: (0, exports.iconsByType)(input.primitives),
+        enhancements: input.enhancements ?? [],
+        slackAssetTypes: new Set(input.slackAssetTypes ?? []),
+        ...(input.styleAdapter !== undefined
+            ? { styleAdapter: input.styleAdapter }
+            : {}),
+        ...(styleCollector !== undefined ? { styleCollector } : {}),
+        ...(input.authoring !== undefined ? { authoring: input.authoring } : {}),
+    };
+};
+exports.definePrimitivePack = definePrimitivePack;
+/** Each definition's `icon` by type, null-prototype so a type such as `__proto__` is an ordinary key. */
+const iconsByType = (primitives) => {
+    const icons = Object.create(null);
+    for (const { type, icon } of primitives) {
+        if (icon !== undefined) {
+            icons[type] = icon;
+        }
+    }
+    return Object.freeze(icons);
+};
+exports.iconsByType = iconsByType;
+/** Throws if `primitives` repeats a type. */
+const assertUniquePrimitiveTypes = (id, primitives) => {
+    const seen = new Set();
+    for (const { type } of primitives) {
+        if (seen.has(type)) {
+            throw new error_1.IsomerError('DUPLICATE_PRIMITIVE_TYPE', `primitive pack "${id}": primitive type "${type}" registered twice`);
+        }
+        seen.add(type);
+    }
+};
+/** Throws if a group names a type outside `types`, or two groups share a type. */
+const assertGroupedOnce = (id, groups, types) => {
+    const grouped = new Set();
+    for (const { title, types: members } of groups) {
+        for (const type of members) {
+            if (!types.has(type)) {
+                throw new error_1.IsomerError('UNKNOWN_PRIMITIVE_TYPE', `primitive pack "${id}": group "${title}" names primitive type "${type}", which the pack does not register`);
+            }
+            if (grouped.has(type)) {
+                throw new error_1.IsomerError('DUPLICATE_PRIMITIVE_TYPE', `primitive pack "${id}": primitive type "${type}" is in two groups`);
+            }
+            grouped.add(type);
+        }
+    }
+};
+/** Throws if this pack registers the same enhancement id twice. */
+const assertUniqueEnhancementIds = (id, enhancements) => {
+    const seen = new Set();
+    for (const definition of enhancements) {
+        if (seen.has(definition.id)) {
+            throw new error_1.IsomerError('DUPLICATE_ENHANCEMENT', `primitive pack "${id}": enhancement "${definition.id}" registered twice`);
+        }
+        seen.add(definition.id);
+    }
+};
+//# sourceMappingURL=primitive_pack.js.map

package/dist/cjs/pack/primitive_pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive_pack.js","sourceRoot":"","sources":["../../../src/pack/primitive_pack.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\n// A primitive pack as a value: a vocabulary, and the optional surfaces every\n// primitive in it implements. Additive: a runtime composes any number of packs,\n// and nothing about a pack decides how a composition is framed.\n\nimport { IsomerError } from '../composition/error';\nimport type { PrimitiveIcon } from '../define/primitive_icon';\nimport type {\n  AnyPrimitiveDefinition,\n  OptionalSurface,\n  StyleHandle,\n} from '../define/primitive_module';\n\nimport type { EnhancementDefinition } from './enhancements';\n\n/**\n * The authoring-schema material a pack contributes for its own primitives.\n *\n * A subset of `AuthoringJsonSchemaOptions`: `$id`, `title`, `description`, and\n * `composition` describe the whole authoring schema a runtime builds, which is\n * a host decision, not a pack one. `pack/` does not import `validate/` for\n * this, so the shape is declared here rather than reused by reference.\n */\nexport interface PackAuthoringOptions {\n  /** `$def` id to `description`, for this pack's own primitives. */\n  describe?: Readonly<Record<string, string>>;\n  /** `$defId.property` paths to drop, from this pack's own primitives. */\n  omitProperties?: readonly string[];\n  /** Headings an index catalog sorts this pack's primitives under, in order. */\n  groups?: readonly PrimitiveGroup[];\n}\n\n/** A titled set of primitive types, listed together in an index catalog. */\nexport interface PrimitiveGroup {\n  title: string;\n  types: readonly string[];\n}\n\n/**\n * The HTML style-adapter hooks a pack may declare. Typed loosely here so `pack/` does not import `render/`.\n */\nexport type PackStyleAdapter = {\n  /** See {@link PrimitivePackInput.styleCollector}. */\n  styleCollector?: string;\n  /** The hooks of `HTMLStyleAdapter` from `./html`, erased: a fresh collector per render, the context renderers receive, and the stylesheet the collector produced. */\n  createCollector: (...args: never[]) => object;\n  createRenderContext: (...args: never[]) => unknown;\n  renderStyles: (...args: never[]) => string;\n  /**\n   * Whether `handle` belongs to this adapter's stylesheet. Required for a runtime to combine several packs' CSS: without it their handles cannot be routed and the host must pick one adapter.\n   */\n  ownsHandle?: (handle: StyleHandle) => boolean;\n};\n\n/** What a pack author passes to {@link definePrimitivePack}. */\nexport interface PrimitivePackInput {\n  /** Stable identifier, used in capability reports and error messages. */\n  id: string;\n  /**\n   * The optional surfaces this pack's primitives implement.\n   *\n   * Only `slack`, and it stays optional per primitive: the dispatcher converts\n   * the mandatory markdown to Block Kit, so declaring it reports an intent\n   * rather than imposing a requirement. Omit it entirely for a pack that\n   * renders Slack through that fallback.\n   */\n  surfaces?: readonly OptionalSurface[];\n  /** This pack's vocabulary. Node types must be unique within it, or construction throws. */\n  primitives: readonly AnyPrimitiveDefinition[];\n  /**\n   * Progressive enhancements this pack's primitives can apply, by id.\n   *\n   * Declared by the pack because an enhancement is a fact about its\n   * vocabulary — a sortable table, a copyable code block — and a host\n   * composing packs it did not write cannot be expected to know the ids.\n   * The runtime flattens these across packs; duplicate ids are rejected.\n   */\n  enhancements?: readonly EnhancementDefinition[];\n  /**\n   * Types that render as a self-contained picture rather than as text.\n   *\n   * A channel that cannot draw them inline uploads an image instead: the Slack\n   * dispatcher swaps such a node for an `image` block and an upload request, so\n   * a chart arrives as a PNG rather than as a markdown approximation of one.\n   *\n   * Declared by the pack because it is a fact about the vocabulary, and a host\n   * composing packs it did not write cannot be expected to know it.\n   */\n  slackAssetTypes?: readonly string[];\n  /**\n   * Default HTML style adapter for this pack. A runtime that omits\n   * `styleAdapter` runs the packs' own adapters, combined when more than one\n   * pack declares one and each answers `ownsHandle`. Pass `styleAdapter` on\n   * the runtime to replace them all.\n   */\n  styleAdapter?: PackStyleAdapter;\n  /**\n   * Names the collector shape this pack's `collectStyles` hooks mutate, so a\n   * runtime can reject a pack paired with an adapter of a different tag.\n   * Defaults to `styleAdapter.styleCollector`; a pack with neither opts out of\n   * the check.\n   */\n  styleCollector?: string;\n  /**\n   * This pack's own contribution to the runtime's authoring JSON Schema.\n   *\n   * Merged across every composed pack, so a host does not hand-merge each\n   * pack's `describe`/`omitProperties` into one options object itself. The\n   * runtime-level `authoring` option is merged in last and wins on conflict.\n   */\n  authoring?: PackAuthoringOptions;\n}\n\n/**\n * A pack as the runtime sees it.\n *\n * `TTheme` is the palette this pack's `react` renderers read as `env.theme`\n * when drawn through the `snapshot` surface — a *lower bound* on whatever theme\n * the runtime holding it supplies. It is carried by\n * {@link PrimitivePack.__theme} rather than by any real field, because\n * `primitives` is erased to `AnyPrimitiveDefinition[]` and a heterogeneous\n * inventory has no single node type to be generic over.\n *\n * The bound is declared, not derived: nothing checks it against what the\n * renderers actually read. State it at the definition as\n * `definePrimitivePack<T>(input)`.\n * Bare `PrimitivePack` requires nothing and fits any runtime; a slot that must\n * hold packs of every palette is typed {@link AnyPrimitivePack}.\n */\nexport interface PrimitivePack<TTheme = unknown> {\n  /** Unique among the packs a runtime composes, and used in error messages. */\n  readonly id: string;\n  /** See {@link PrimitivePackInput.surfaces}. */\n  readonly surfaces: readonly OptionalSurface[];\n  /** See {@link PrimitivePackInput.primitives}. */\n  readonly primitives: readonly AnyPrimitiveDefinition[];\n  /** Node types this pack owns, for duplicate detection across packs. */\n  readonly types: ReadonlySet<string>;\n  /**\n   * Each primitive's `icon` by type, for the primitives that declare one, so a host listing them need not walk `primitives`.\n   *\n   * A frozen null-prototype dictionary: an absent type reads `undefined`, even `constructor`. Absent on a pack built by an SDK that predates icons; {@link iconsByType} derives it from `primitives`.\n   */\n  readonly icons?: Readonly<Record<string, PrimitiveIcon>>;\n  /** See {@link PrimitivePackInput.enhancements}. */\n  readonly enhancements: readonly EnhancementDefinition[];\n  /** See {@link PrimitivePackInput.slackAssetTypes}. */\n  readonly slackAssetTypes: ReadonlySet<string>;\n  /** See {@link PrimitivePackInput.styleAdapter}. */\n  readonly styleAdapter?: PackStyleAdapter;\n  /** See {@link PrimitivePackInput.styleCollector}. */\n  readonly styleCollector?: string;\n  /** See {@link PrimitivePackInput.authoring}. */\n  readonly authoring?: PackAuthoringOptions;\n  /**\n   * Phantom: never present at runtime, never read.\n   *\n   * A property rather than a method so `strictFunctionTypes` checks it\n   * contravariantly. A method signature is bivariant, which would let a pack\n   * needing richer tokens sit in a slot supplying fewer and then read a field\n   * nothing supplies — the exact failure this marker exists to prevent.\n   */\n  readonly __theme?: (theme: TTheme) => void;\n}\n\n/**\n * A pack of any palette, for storage positions: `never` is assignable to every\n * requirement, so a slot typed this way holds every pack.\n */\nexport type AnyPrimitivePack = PrimitivePack<never>;\n\n/**\n * Builds a {@link PrimitivePack}.\n *\n * `TTheme` is the palette a frame must supply for this pack's nodes to be drawn\n * on the `snapshot` surface: `definePrimitivePack<CoreTokens>(input)`. Omitted, it is\n * `unknown`, which requires nothing.\n */\nexport const definePrimitivePack = <TTheme = unknown>(\n  input: PrimitivePackInput\n): PrimitivePack<TTheme> => {\n  if (input.primitives.length === 0) {\n    throw new IsomerError(\n      'EMPTY_PACK',\n      `primitive pack \"${input.id}\": at least one primitive is required`\n    );\n  }\n  assertUniquePrimitiveTypes(input.id, input.primitives);\n  assertUniqueEnhancementIds(input.id, input.enhancements ?? []);\n  const types = new Set(input.primitives.map((definition) => definition.type));\n  assertGroupedOnce(input.id, input.authoring?.groups ?? [], types);\n  for (const type of input.slackAssetTypes ?? []) {\n    if (!types.has(type)) {\n      throw new IsomerError(\n        'UNKNOWN_PRIMITIVE_TYPE',\n        `primitive pack \"${input.id}\": slackAssetTypes names primitive type \"${type}\", which the pack does not register`\n      );\n    }\n  }\n  const styleCollector =\n    input.styleCollector ?? input.styleAdapter?.styleCollector;\n\n  return {\n    id: input.id,\n    surfaces: input.surfaces ?? [],\n    primitives: input.primitives,\n    types,\n    icons: iconsByType(input.primitives),\n    enhancements: input.enhancements ?? [],\n    slackAssetTypes: new Set(input.slackAssetTypes ?? []),\n    ...(input.styleAdapter !== undefined\n      ? { styleAdapter: input.styleAdapter }\n      : {}),\n    ...(styleCollector !== undefined ? { styleCollector } : {}),\n    ...(input.authoring !== undefined ? { authoring: input.authoring } : {}),\n  };\n};\n\n/** Each definition's `icon` by type, null-prototype so a type such as `__proto__` is an ordinary key. */\nexport const iconsByType = (\n  primitives: readonly AnyPrimitiveDefinition[]\n): Readonly<Record<string, PrimitiveIcon>> => {\n  const icons = Object.create(null) as Record<string, PrimitiveIcon>;\n  for (const { type, icon } of primitives) {\n    if (icon !== undefined) {\n      icons[type] = icon;\n    }\n  }\n  return Object.freeze(icons);\n};\n\n/** Throws if `primitives` repeats a type. */\nconst assertUniquePrimitiveTypes = (\n  id: string,\n  primitives: readonly AnyPrimitiveDefinition[]\n): void => {\n  const seen = new Set<string>();\n  for (const { type } of primitives) {\n    if (seen.has(type)) {\n      throw new IsomerError(\n        'DUPLICATE_PRIMITIVE_TYPE',\n        `primitive pack \"${id}\": primitive type \"${type}\" registered twice`\n      );\n    }\n    seen.add(type);\n  }\n};\n\n/** Throws if a group names a type outside `types`, or two groups share a type. */\nconst assertGroupedOnce = (\n  id: string,\n  groups: readonly PrimitiveGroup[],\n  types: ReadonlySet<string>\n): void => {\n  const grouped = new Set<string>();\n  for (const { title, types: members } of groups) {\n    for (const type of members) {\n      if (!types.has(type)) {\n        throw new IsomerError(\n          'UNKNOWN_PRIMITIVE_TYPE',\n          `primitive pack \"${id}\": group \"${title}\" names primitive type \"${type}\", which the pack does not register`\n        );\n      }\n      if (grouped.has(type)) {\n        throw new IsomerError(\n          'DUPLICATE_PRIMITIVE_TYPE',\n          `primitive pack \"${id}\": primitive type \"${type}\" is in two groups`\n        );\n      }\n      grouped.add(type);\n    }\n  }\n};\n\n/** Throws if this pack registers the same enhancement id twice. */\nconst assertUniqueEnhancementIds = (\n  id: string,\n  enhancements: readonly EnhancementDefinition[]\n): void => {\n  const seen = new Set<string>();\n  for (const definition of enhancements) {\n    if (seen.has(definition.id)) {\n      throw new IsomerError(\n        'DUPLICATE_ENHANCEMENT',\n        `primitive pack \"${id}\": enhancement \"${definition.id}\" registered twice`\n      );\n    }\n    seen.add(definition.id);\n  }\n};\n"]}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/render/anchors.js

@@ -0,0 +1,167 @@
+"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.findNodeElementPairs = exports.pairAnchors = exports.nodeType = exports.anchoredNodes = exports.anchoredNodePaths = exports.layoutRoom = exports.LAYOUT_ROOM_ATTRIBUTE = exports.nodeAnchor = exports.withNodeAnchors = exports.withoutAnchors = exports.withAnchors = exports.anchorValue = exports.NODE_ANCHOR_ATTRIBUTE = void 0;
+const body_node_base_1 = require("../composition/body_node_base");
+const context_view_1 = require("./context_view");
+/** The attribute {@link nodeAnchor} sets to a node's type, escaped so HTML parsing leaves it unchanged. */
+exports.NODE_ANCHOR_ATTRIBUTE = 'data-isomer-node';
+/**
+ * A node type as its anchor carries it. Every character outside `[A-Za-z0-9_-]`
+ * becomes `%<hex code point>;`, so the value survives HTML serialization and
+ * parsing unchanged and never throws. A plain identifier stays as it is.
+ */
+const anchorValue = (type) => type.replace(/[^\w-]/gu, (char) => `%${char.codePointAt(0).toString(16)};`);
+exports.anchorValue = anchorValue;
+/** Marks a context whose subtree renders no anchors; see {@link withoutAnchors}. */
+const NO_ANCHORS = Symbol.for('elastic.isomer.anchors_off');
+/**
+ * Where an HTML render keeps its anchor decision while it runs. On `globalThis`
+ * under a `Symbol.for` key, so an ESM and a CommonJS copy of the SDK share it.
+ */
+const ACTIVE = Symbol.for('elastic.isomer.anchors_active');
+const activeAnchors = () => globalThis[ACTIVE];
+/**
+ * Runs `render` with anchors on or off for every {@link nodeAnchor} it reaches,
+ * whatever each render context says. The render must be synchronous; the
+ * previous state comes back afterwards, even if it throws.
+ */
+const withAnchors = (on, render) => {
+    const scope = globalThis;
+    const outer = scope[ACTIVE];
+    scope[ACTIVE] = on;
+    try {
+        return render();
+    }
+    finally {
+        if (outer === undefined) {
+            delete scope[ACTIVE];
+        }
+        else {
+            scope[ACTIVE] = outer;
+        }
+    }
+};
+exports.withAnchors = withAnchors;
+/**
+ * `context` for content a renderer draws that is not one of its `children`,
+ * such as an embedded composition: nothing under it renders an anchor.
+ *
+ * The result is a view of `context`, not a copy: reads go to `context` itself,
+ * with methods bound to it, so getters, methods, private state, and
+ * `instanceof` behave as before. The mark survives a context derived from it
+ * by spreading. A context that is neither an object nor a function is
+ * returned as it is.
+ */
+const withoutAnchors = (context) => (0, context_view_1.contextWith)(context, NO_ANCHORS, true);
+exports.withoutAnchors = withoutAnchors;
+/**
+ * `context` with node anchors on, as an enhancement declaring `anchors: true`
+ * turns them on. A view like {@link withoutAnchors}, which still wins.
+ */
+const withNodeAnchors = (context) => (0, context_view_1.contextWith)(context, 'anchors', true);
+exports.withNodeAnchors = withNodeAnchors;
+const anchorsOn = (context) => {
+    const carries = (0, context_view_1.isObjectLike)(context);
+    if (carries && Reflect.get(context, NO_ANCHORS) === true) {
+        return false;
+    }
+    return (activeAnchors() ??
+        (carries && context.anchors === true));
+};
+/**
+ * Props a `react` renderer spreads on its root element so runtime code can find
+ * the node with {@link findNodeElementPairs}. Inside an HTML surface render the
+ * surface decides; elsewhere, on the React and `snapshot` surfaces, `context.anchors`
+ * does. Always empty under {@link withoutAnchors}.
+ */
+const nodeAnchor = (context, { type }) => anchorsOn(context) ? { [exports.NODE_ANCHOR_ATTRIBUTE]: (0, exports.anchorValue)(type) } : {};
+exports.nodeAnchor = nodeAnchor;
+/** The attribute {@link layoutRoom} sets. */
+exports.LAYOUT_ROOM_ATTRIBUTE = 'data-isomer-room';
+/**
+ * Props a renderer spreads on an element inside its node that bounds the nodes
+ * nested in it, such as a frame's body, so `checkLayout` measures them against
+ * it. Rendered when {@link nodeAnchor} would be.
+ */
+const layoutRoom = (context) => anchorsOn(context) ? { [exports.LAYOUT_ROOM_ATTRIBUTE]: '' } : {};
+exports.layoutRoom = layoutRoom;
+/**
+ * The nodes of `body` a render on `surface` draws, pre-order, each with its
+ * path in validation's `body[0].items[1]` form. Nested nodes follow `react`,
+ * as a container renders them through `renderReact` on either surface.
+ */
+const anchoredNodePaths = (body, walk, surface = 'react') => {
+    const visit = (node, path) => [
+        { node, path },
+        ...walk(node).flatMap((child) => (0, body_node_base_1.isVisibleOnSurface)(child.node, 'react')
+            ? visit(child.node, (0, body_node_base_1.childNodePath)(path, child.path))
+            : []),
+    ];
+    return body.flatMap((node, index) => (0, body_node_base_1.isVisibleOnSurface)(node, surface) ? visit(node, `body[${index}]`) : []);
+};
+exports.anchoredNodePaths = anchoredNodePaths;
+/** The `react`-visible nodes of `body`, pre-order: the order their anchors render in. */
+const anchoredNodes = (body, walk) => (0, exports.anchoredNodePaths)(body, walk).map(({ node }) => node);
+exports.anchoredNodes = anchoredNodes;
+/** A node's `type`, when it has one. */
+const nodeType = (node) => {
+    const { type } = node;
+    return typeof type === 'string' ? type : undefined;
+};
+exports.nodeType = nodeType;
+/**
+ * The item each of `nodes` pairs with, from `anchored` in document order: the
+ * k-th node of a type pairs with the k-th item whose anchor value is that
+ * type's. A type whose node and item counts disagree pairs with nothing.
+ */
+const pairAnchors = (anchored, nodes) => {
+    const itemsByValue = new Map();
+    for (const [value, item] of anchored) {
+        const items = itemsByValue.get(value) ?? [];
+        items.push(item);
+        itemsByValue.set(value, items);
+    }
+    const counts = new Map();
+    for (const node of nodes) {
+        const type = (0, exports.nodeType)(node);
+        if (type !== undefined) {
+            counts.set(type, (counts.get(type) ?? 0) + 1);
+        }
+    }
+    const seen = new Map();
+    return nodes.map((node) => {
+        const type = (0, exports.nodeType)(node);
+        if (type === undefined) {
+            return undefined;
+        }
+        const index = seen.get(type) ?? 0;
+        seen.set(type, index + 1);
+        const items = itemsByValue.get((0, exports.anchorValue)(type)) ?? [];
+        return items.length === counts.get(type) ? items[index] : undefined;
+    });
+};
+exports.pairAnchors = pairAnchors;
+/**
+ * Every `react`-visible node of `body`, walked pre-order, with the element
+ * its anchor marks under `root`, paired by {@link pairAnchors}. `root` holds
+ * one render.
+ *
+ * Pairing holds because every renderer draws its `children` in the order its
+ * definition's `children` returns them. A node that rendered nothing leaves
+ * its type unpaired. A node object that appears twice appears twice here,
+ * each time with its own element.
+ */
+const findNodeElementPairs = (root, body, walk) => {
+    const nodes = (0, exports.anchoredNodes)(body, walk);
+    // Read by attribute value, so a type is never read as selector syntax.
+    const elements = (0, exports.pairAnchors)(Array.from(root.querySelectorAll(`[${exports.NODE_ANCHOR_ATTRIBUTE}]`), (element) => [element.getAttribute(exports.NODE_ANCHOR_ATTRIBUTE) ?? '', element]), nodes);
+    return nodes.map((node, index) => ({ node, element: elements[index] }));
+};
+exports.findNodeElementPairs = findNodeElementPairs;
+//# sourceMappingURL=anchors.js.map

package/dist/cjs/render/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../src/render/anchors.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  childNodePath,\n  type ChildNodeWalker,\n  isVisibleOnSurface,\n} from '../composition/body_node_base';\n\nimport { contextWith, isObjectLike } from './context_view';\n\n/** The attribute {@link nodeAnchor} sets to a node's type, escaped so HTML parsing leaves it unchanged. */\nexport const NODE_ANCHOR_ATTRIBUTE = 'data-isomer-node';\n\n/**\n * A node type as its anchor carries it. Every character outside `[A-Za-z0-9_-]`\n * becomes `%<hex code point>;`, so the value survives HTML serialization and\n * parsing unchanged and never throws. A plain identifier stays as it is.\n */\nexport const anchorValue = (type: string): string =>\n  type.replace(/[^\\w-]/gu, (char) => `%${char.codePointAt(0)!.toString(16)};`);\n\n/** Marks a context whose subtree renders no anchors; see {@link withoutAnchors}. */\nconst NO_ANCHORS = Symbol.for('elastic.isomer.anchors_off');\n\n/**\n * Where an HTML render keeps its anchor decision while it runs. On `globalThis`\n * under a `Symbol.for` key, so an ESM and a CommonJS copy of the SDK share it.\n */\nconst ACTIVE = Symbol.for('elastic.isomer.anchors_active');\n\ntype AnchorScope = { [ACTIVE]?: boolean };\n\nconst activeAnchors = (): boolean | undefined =>\n  (globalThis as AnchorScope)[ACTIVE];\n\n/**\n * Runs `render` with anchors on or off for every {@link nodeAnchor} it reaches,\n * whatever each render context says. The render must be synchronous; the\n * previous state comes back afterwards, even if it throws.\n */\nexport const withAnchors = <TResult>(\n  on: boolean,\n  render: () => TResult\n): TResult => {\n  const scope = globalThis as AnchorScope;\n  const outer = scope[ACTIVE];\n  scope[ACTIVE] = on;\n  try {\n    return render();\n  } finally {\n    if (outer === undefined) {\n      delete scope[ACTIVE];\n    } else {\n      scope[ACTIVE] = outer;\n    }\n  }\n};\n\n/**\n * `context` for content a renderer draws that is not one of its `children`,\n * such as an embedded composition: nothing under it renders an anchor.\n *\n * The result is a view of `context`, not a copy: reads go to `context` itself,\n * with methods bound to it, so getters, methods, private state, and\n * `instanceof` behave as before. The mark survives a context derived from it\n * by spreading. A context that is neither an object nor a function is\n * returned as it is.\n */\nexport const withoutAnchors = <TContext>(context: TContext): TContext =>\n  contextWith(context, NO_ANCHORS, true);\n\n/**\n * `context` with node anchors on, as an enhancement declaring `anchors: true`\n * turns them on. A view like {@link withoutAnchors}, which still wins.\n */\nexport const withNodeAnchors = <TContext>(context: TContext): TContext =>\n  contextWith(context, 'anchors', true);\n\nconst anchorsOn = (context: unknown): boolean => {\n  const carries = isObjectLike(context);\n  if (carries && Reflect.get(context, NO_ANCHORS) === true) {\n    return false;\n  }\n  return (\n    activeAnchors() ??\n    (carries && (context as { anchors?: unknown }).anchors === true)\n  );\n};\n\n/**\n * Props a `react` renderer spreads on its root element so runtime code can find\n * the node with {@link findNodeElementPairs}. Inside an HTML surface render the\n * surface decides; elsewhere, on the React and `snapshot` surfaces, `context.anchors`\n * does. Always empty under {@link withoutAnchors}.\n */\nexport const nodeAnchor = (\n  context: unknown,\n  { type }: { type: string }\n): Readonly<Record<string, string>> =>\n  anchorsOn(context) ? { [NODE_ANCHOR_ATTRIBUTE]: anchorValue(type) } : {};\n\n/** The attribute {@link layoutRoom} sets. */\nexport const LAYOUT_ROOM_ATTRIBUTE = 'data-isomer-room';\n\n/**\n * Props a renderer spreads on an element inside its node that bounds the nodes\n * nested in it, such as a frame's body, so `checkLayout` measures them against\n * it. Rendered when {@link nodeAnchor} would be.\n */\nexport const layoutRoom = (\n  context: unknown\n): Readonly<Record<string, string>> =>\n  anchorsOn(context) ? { [LAYOUT_ROOM_ATTRIBUTE]: '' } : {};\n\n/**\n * The nodes of `body` a render on `surface` draws, pre-order, each with its\n * path in validation's `body[0].items[1]` form. Nested nodes follow `react`,\n * as a container renders them through `renderReact` on either surface.\n */\nexport const anchoredNodePaths = (\n  body: readonly unknown[],\n  walk: ChildNodeWalker,\n  surface: 'react' | 'snapshot' = 'react'\n): { node: unknown; path: string }[] => {\n  const visit = (\n    node: unknown,\n    path: string\n  ): { node: unknown; path: string }[] => [\n    { node, path },\n    ...walk(node).flatMap((child) =>\n      isVisibleOnSurface(child.node, 'react')\n        ? visit(child.node, childNodePath(path, child.path))\n        : []\n    ),\n  ];\n  return body.flatMap((node, index) =>\n    isVisibleOnSurface(node, surface) ? visit(node, `body[${index}]`) : []\n  );\n};\n\n/** The `react`-visible nodes of `body`, pre-order: the order their anchors render in. */\nexport const anchoredNodes = (\n  body: readonly unknown[],\n  walk: ChildNodeWalker\n): unknown[] => anchoredNodePaths(body, walk).map(({ node }) => node);\n\n/** A node's `type`, when it has one. */\nexport const nodeType = (node: unknown): string | undefined => {\n  const { type } = node as { type?: unknown };\n  return typeof type === 'string' ? type : undefined;\n};\n\n/**\n * The item each of `nodes` pairs with, from `anchored` in document order: the\n * k-th node of a type pairs with the k-th item whose anchor value is that\n * type's. A type whose node and item counts disagree pairs with nothing.\n */\nexport const pairAnchors = <TItem>(\n  anchored: Iterable<readonly [value: string, item: TItem]>,\n  nodes: readonly unknown[]\n): (TItem | undefined)[] => {\n  const itemsByValue = new Map<string, TItem[]>();\n  for (const [value, item] of anchored) {\n    const items = itemsByValue.get(value) ?? [];\n    items.push(item);\n    itemsByValue.set(value, items);\n  }\n  const counts = new Map<string, number>();\n  for (const node of nodes) {\n    const type = nodeType(node);\n    if (type !== undefined) {\n      counts.set(type, (counts.get(type) ?? 0) + 1);\n    }\n  }\n  const seen = new Map<string, number>();\n  return nodes.map((node) => {\n    const type = nodeType(node);\n    if (type === undefined) {\n      return undefined;\n    }\n    const index = seen.get(type) ?? 0;\n    seen.set(type, index + 1);\n    const items = itemsByValue.get(anchorValue(type)) ?? [];\n    return items.length === counts.get(type) ? items[index] : undefined;\n  });\n};\n\n/**\n * Every `react`-visible node of `body`, walked pre-order, with the element\n * its anchor marks under `root`, paired by {@link pairAnchors}. `root` holds\n * one render.\n *\n * Pairing holds because every renderer draws its `children` in the order its\n * definition's `children` returns them. A node that rendered nothing leaves\n * its type unpaired. A node object that appears twice appears twice here,\n * each time with its own element.\n */\nexport const findNodeElementPairs = (\n  root: ParentNode,\n  body: readonly unknown[],\n  walk: ChildNodeWalker\n): { node: unknown; element: Element | undefined }[] => {\n  const nodes = anchoredNodes(body, walk);\n  // Read by attribute value, so a type is never read as selector syntax.\n  const elements = pairAnchors(\n    Array.from(\n      root.querySelectorAll(`[${NODE_ANCHOR_ATTRIBUTE}]`),\n      (element) =>\n        [element.getAttribute(NODE_ANCHOR_ATTRIBUTE) ?? '', element] as const\n    ),\n    nodes\n  );\n  return nodes.map((node, index) => ({ node, element: elements[index] }));\n};\n"]}

package/dist/cjs/render/context_view.js

@@ -0,0 +1,54 @@
+"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.contextWith = exports.isObjectLike = void 0;
+/** Whether `value` can carry properties: a non-null object or a function. */
+const isObjectLike = (value) => (typeof value === 'object' && value !== null) || typeof value === 'function';
+exports.isObjectLike = isObjectLike;
+/**
+ * A view of `context` that reads `key` as `value` and everything else from
+ * `context`, with methods bound to it, so getters, private state, and
+ * `instanceof` behave as before, and a callable context stays callable. A
+ * context that is neither an object nor a function is returned as it is.
+ */
+const contextWith = (context, key, value) => {
+    if (!(0, exports.isObjectLike)(context)) {
+        return context;
+    }
+    const original = context;
+    // An extensible stand-in, so a frozen context cannot trip the proxy invariants. An arrow function has no non-configurable own keys.
+    const prototype = Object.getPrototypeOf(original);
+    const standIn = (typeof original === 'function'
+        ? Object.setPrototypeOf(() => undefined, prototype)
+        : Object.create(prototype));
+    return new Proxy(standIn, {
+        apply: (_, self, args) => Reflect.apply(original, self, args),
+        get: (_, read) => {
+            if (read === key) {
+                return value;
+            }
+            const found = Reflect.get(original, read, original);
+            return typeof found === 'function'
+                ? found.bind(original)
+                : found;
+        },
+        set: (_, write, next) => Reflect.set(original, write, next, original),
+        has: (_, read) => read === key || Reflect.has(original, read),
+        ownKeys: () => [...new Set([...Reflect.ownKeys(original), key])],
+        getOwnPropertyDescriptor: (_, read) => {
+            if (read === key) {
+                return { value, enumerable: true, configurable: true, writable: true };
+            }
+            const descriptor = Reflect.getOwnPropertyDescriptor(original, read);
+            return descriptor && { ...descriptor, configurable: true };
+        },
+        getPrototypeOf: () => Object.getPrototypeOf(original),
+    });
+};
+exports.contextWith = contextWith;
+//# sourceMappingURL=context_view.js.map

package/dist/cjs/render/context_view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context_view.js","sourceRoot":"","sources":["../../../src/render/context_view.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,6EAA6E;AACtE,MAAM,YAAY,GAAG,CAAC,KAAc,EAAmB,EAAE,CAC9D,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC;AADlE,QAAA,YAAY,gBACsD;AAE/E;;;;;GAKG;AACI,MAAM,WAAW,GAAG,CACzB,OAAiB,EACjB,GAAoB,EACpB,KAAc,EACJ,EAAE;IACZ,IAAI,CAAC,IAAA,oBAAY,EAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC;IACzB,oIAAoI;IACpI,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAkB,CAAC;IACnE,MAAM,OAAO,GAAG,CACd,OAAO,QAAQ,KAAK,UAAU;QAC5B,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;QACnD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CACnB,CAAC;IACZ,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE;QACxB,KAAK,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAe,EAAE,EAAE,CAClC,OAAO,CAAC,KAAK,CAAC,QAA2C,EAAE,IAAI,EAAE,IAAI,CAAC;QACxE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;YACf,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC7D,OAAO,OAAO,KAAK,KAAK,UAAU;gBAChC,CAAC,CAAE,KAAyC,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC3D,CAAC,CAAC,KAAK,CAAC;QACZ,CAAC;QACD,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC;QACrE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC;QAC7D,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAChE,wBAAwB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE;YACpC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;gBACjB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YACzE,CAAC;YACD,MAAM,UAAU,GAAG,OAAO,CAAC,wBAAwB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACpE,OAAO,UAAU,IAAI,EAAE,GAAG,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC7D,CAAC;QACD,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAkB;KACvE,CAAa,CAAC;AACjB,CAAC,CAAC;AAxCW,QAAA,WAAW,eAwCtB","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/** Whether `value` can carry properties: a non-null object or a function. */\nexport const isObjectLike = (value: unknown): value is object =>\n  (typeof value === 'object' && value !== null) || typeof value === 'function';\n\n/**\n * A view of `context` that reads `key` as `value` and everything else from\n * `context`, with methods bound to it, so getters, private state, and\n * `instanceof` behave as before, and a callable context stays callable. A\n * context that is neither an object nor a function is returned as it is.\n */\nexport const contextWith = <TContext>(\n  context: TContext,\n  key: string | symbol,\n  value: unknown\n): TContext => {\n  if (!isObjectLike(context)) {\n    return context;\n  }\n  const original = context;\n  // An extensible stand-in, so a frozen context cannot trip the proxy invariants. An arrow function has no non-configurable own keys.\n  const prototype = Object.getPrototypeOf(original) as object | null;\n  const standIn = (\n    typeof original === 'function'\n      ? Object.setPrototypeOf(() => undefined, prototype)\n      : Object.create(prototype)\n  ) as object;\n  return new Proxy(standIn, {\n    apply: (_, self, args: unknown[]) =>\n      Reflect.apply(original as (...rest: unknown[]) => unknown, self, args),\n    get: (_, read) => {\n      if (read === key) {\n        return value;\n      }\n      const found: unknown = Reflect.get(original, read, original);\n      return typeof found === 'function'\n        ? (found as (...args: unknown[]) => unknown).bind(original)\n        : found;\n    },\n    set: (_, write, next) => Reflect.set(original, write, next, original),\n    has: (_, read) => read === key || Reflect.has(original, read),\n    ownKeys: () => [...new Set([...Reflect.ownKeys(original), key])],\n    getOwnPropertyDescriptor: (_, read) => {\n      if (read === key) {\n        return { value, enumerable: true, configurable: true, writable: true };\n      }\n      const descriptor = Reflect.getOwnPropertyDescriptor(original, read);\n      return descriptor && { ...descriptor, configurable: true };\n    },\n    getPrototypeOf: () => Object.getPrototypeOf(original) as object | null,\n  }) as TContext;\n};\n"]}