@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/render/format_display_value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format_display_value.js","sourceRoot":"","sources":["../../src/render/format_display_value.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type {\n  DisplayValue,\n  StructuredValue,\n} from '../composition/structured_value';\n\nimport { formatCompactNumber } from './format_number';\n\n/** Options for {@link formatDisplayValue}. */\nexport interface FormatDisplayValueOptions {\n  /** Reference instant for `relativeTime`; defaults to the render time. */\n  now?: Date;\n}\n\n/** Narrows a {@link DisplayValue} to the object form. */\nexport const isStructuredValue = (\n  value: DisplayValue\n): value is StructuredValue =>\n  typeof value === 'object' && value !== null && 'raw' in value;\n\n/** The unformatted value behind a {@link DisplayValue}. */\nexport const rawDisplayValue = (value: DisplayValue): number | string =>\n  isStructuredValue(value) ? value.raw : value;\n\n/**\n * Renders a {@link DisplayValue} for display. A bare string passes through; a\n * {@link StructuredValue} is formatted per its `format`.\n *\n * Numeric formats fall back to `String(raw)` for a string `raw` rather than\n * erroring. Locale is fixed to `en-US` and dates render in UTC so the same\n * composition formats identically on every host.\n */\nexport const formatDisplayValue = (\n  value: DisplayValue,\n  options: FormatDisplayValueOptions = {}\n): string => {\n  if (!isStructuredValue(value)) {\n    return value;\n  }\n  const { raw, format, precision, currency } = value;\n  switch (format) {\n    case 'compact':\n      return typeof raw === 'number'\n        ? formatCompactNumber(raw, '', precision)\n        : String(raw);\n    case 'percent':\n      return typeof raw === 'number'\n        ? intlNumber(raw, precision, { style: 'percent' })\n        : String(raw);\n    case 'currency':\n      return typeof raw === 'number'\n        ? intlNumber(raw, precision ?? 2, {\n            style: 'currency',\n            currency: currency ?? 'USD',\n          })\n        : String(raw);\n    case 'bytes':\n      return typeof raw === 'number'\n        ? formatBytes(raw, precision)\n        : String(raw);\n    case 'duration':\n      return typeof raw === 'number' ? formatDuration(raw) : String(raw);\n    case 'date':\n      return formatDate(raw);\n    case 'relativeTime':\n      return formatRelativeTime(raw, options.now ?? new Date());\n    case 'number':\n    default:\n      return typeof raw === 'number'\n        ? intlNumber(raw, precision, {})\n        : String(raw);\n  }\n};\n\nconst intlNumber = (\n  value: number,\n  precision: number | undefined,\n  options: Intl.NumberFormatOptions\n): string =>\n  new Intl.NumberFormat('en-US', {\n    ...options,\n    ...(precision === undefined\n      ? { maximumFractionDigits: 2 }\n      : {\n          minimumFractionDigits: precision,\n          maximumFractionDigits: precision,\n        }),\n  }).format(value);\n\nconst BYTE_UNITS = ['B', 'KB', 'MB', 'GB', 'TB', 'PB'] as const;\n\nconst formatBytes = (bytes: number, precision?: number): string => {\n  let scaled = Math.abs(bytes);\n  let unit = 0;\n  while (scaled >= 1024 && unit < BYTE_UNITS.length - 1) {\n    scaled /= 1024;\n    unit += 1;\n  }\n  const sign = bytes < 0 ? '-' : '';\n  const digits = unit === 0 ? 0 : (precision ?? 1);\n  return `${sign}${trimFixed(scaled, digits)} ${BYTE_UNITS[unit]}`;\n};\n\nconst formatDuration = (seconds: number): string => {\n  const abs = Math.abs(seconds);\n  const sign = seconds < 0 ? '-' : '';\n  if (abs < 1) {\n    return `${sign}${trimFixed(abs * 1000, 1)}ms`;\n  }\n  if (abs < 60) {\n    return `${sign}${trimFixed(abs, 1)}s`;\n  }\n  const pairs: Array<[number, string, number, string]> = [\n    [86400, 'd', 3600, 'h'],\n    [3600, 'h', 60, 'm'],\n    [60, 'm', 1, 's'],\n  ];\n  for (const [major, majorUnit, minor, minorUnit] of pairs) {\n    if (abs >= major) {\n      const majorCount = Math.floor(abs / major);\n      const minorCount = Math.floor((abs % major) / minor);\n      return minorCount > 0\n        ? `${sign}${majorCount}${majorUnit} ${minorCount}${minorUnit}`\n        : `${sign}${majorCount}${majorUnit}`;\n    }\n  }\n  return `${sign}${trimFixed(abs, 1)}s`;\n};\n\nconst formatDate = (raw: number | string): string => {\n  const date = new Date(raw);\n  if (Number.isNaN(date.getTime())) {\n    return String(raw);\n  }\n  return new Intl.DateTimeFormat('en-US', {\n    dateStyle: 'medium',\n    timeStyle: 'short',\n    timeZone: 'UTC',\n  }).format(date);\n};\n\nconst formatRelativeTime = (raw: number | string, now: Date): string => {\n  const date = new Date(raw);\n  if (Number.isNaN(date.getTime())) {\n    return String(raw);\n  }\n  const deltaSeconds = Math.round((date.getTime() - now.getTime()) / 1000);\n  const abs = Math.abs(deltaSeconds);\n  if (abs < 45) {\n    return 'just now';\n  }\n  const unit =\n    abs < 60 * 45\n      ? ([Math.max(1, Math.round(abs / 60)), 'm'] as const)\n      : abs < 3600 * 22\n        ? ([Math.max(1, Math.round(abs / 3600)), 'h'] as const)\n        : ([Math.max(1, Math.round(abs / 86400)), 'd'] as const);\n  const phrase = `${unit[0]}${unit[1]}`;\n  return deltaSeconds < 0 ? `${phrase} ago` : `in ${phrase}`;\n};\n\nconst trimFixed = (value: number, digits: number): string => {\n  const fixed = value.toFixed(digits);\n  return fixed.includes('.') ? fixed.replace(/\\.?0+$/, '') : fixed;\n};\n"]}

package/dist/render/format_number.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `1_284` to `1.3k`, `18_200_000` to `18.2m`, through `b` and `t`, with an
+ * optional unit appended. `precision` is the decimals kept, `1` by default.
+ *
+ * `%` joins without a space because "99.2 %" reads wrong; every other unit gets
+ * one.
+ */
+export declare const formatCompactNumber: (value: number, unit?: string, precision?: number) => string;
+//# sourceMappingURL=format_number.d.ts.map

package/dist/render/format_number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format_number.d.ts","sourceRoot":"","sources":["../../src/render/format_number.ts"],"names":[],"mappings":"AAyBA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,OAAO,MAAM,EACb,aAAS,EACT,kBAAa,KACZ,MAeF,CAAC"}

package/dist/render/format_number.js

@@ -0,0 +1,42 @@
+/*
+ * 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.
+ */
+// Compact numeric formatting, shared by anything that has to fit a number into
+// a small space — chart axis labels, a `compact` structured display value, a
+// text-surface trend line.
+const TIERS = [
+    { size: 1_000_000_000_000, suffix: 't' },
+    { size: 1_000_000_000, suffix: 'b' },
+    { size: 1_000_000, suffix: 'm' },
+    { size: 1_000, suffix: 'k' },
+    { size: 1, suffix: '' },
+];
+// Rounded to `precision` decimals, trailing zeros dropped.
+const trimDecimal = (value, precision) => Number.isInteger(value)
+    ? String(value)
+    : String(Number(value.toFixed(precision)));
+/**
+ * `1_284` to `1.3k`, `18_200_000` to `18.2m`, through `b` and `t`, with an
+ * optional unit appended. `precision` is the decimals kept, `1` by default.
+ *
+ * `%` joins without a space because "99.2 %" reads wrong; every other unit gets
+ * one.
+ */
+export const formatCompactNumber = (value, unit = '', precision = 1) => {
+    const abs = Math.abs(value);
+    let index = TIERS.findIndex(({ size }) => abs >= size);
+    if (index === -1)
+        index = TIERS.length - 1;
+    // A value that rounds up to the tier's next power, `999.96k`, reads as `1m`.
+    if (index > 0 &&
+        Math.abs(Number((value / TIERS[index].size).toFixed(precision))) >= 1_000) {
+        index -= 1;
+    }
+    const { size, suffix } = TIERS[index];
+    const scaled = `${trimDecimal(value / size, precision)}${suffix}`;
+    return unit === '' ? scaled : `${scaled}${unit === '%' ? '' : ' '}${unit}`;
+};
+//# sourceMappingURL=format_number.js.map

package/dist/render/format_number.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format_number.js","sourceRoot":"","sources":["../../src/render/format_number.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;AAE3B,MAAM,KAAK,GAAG;IACZ,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,GAAG,EAAE;IACxC,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE;IACpC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE;IAChC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE;IAC5B,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;CACf,CAAC;AAEX,2DAA2D;AAC3D,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,SAAiB,EAAU,EAAE,CAC/D,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;IACrB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IACf,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,KAAa,EACb,IAAI,GAAG,EAAE,EACT,SAAS,GAAG,CAAC,EACL,EAAE;IACV,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3C,6EAA6E;IAC7E,IACE,KAAK,GAAG,CAAC;QACT,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,EAC1E,CAAC;QACD,KAAK,IAAI,CAAC,CAAC;IACb,CAAC;IACD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;IACvC,MAAM,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,GAAG,IAAI,EAAE,SAAS,CAAC,GAAG,MAAM,EAAE,CAAC;IAElE,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,EAAE,CAAC;AAC7E,CAAC,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// Compact numeric formatting, shared by anything that has to fit a number into\n// a small space — chart axis labels, a `compact` structured display value, a\n// text-surface trend line.\n\nconst TIERS = [\n  { size: 1_000_000_000_000, suffix: 't' },\n  { size: 1_000_000_000, suffix: 'b' },\n  { size: 1_000_000, suffix: 'm' },\n  { size: 1_000, suffix: 'k' },\n  { size: 1, suffix: '' },\n] as const;\n\n// Rounded to `precision` decimals, trailing zeros dropped.\nconst trimDecimal = (value: number, precision: number): string =>\n  Number.isInteger(value)\n    ? String(value)\n    : String(Number(value.toFixed(precision)));\n\n/**\n * `1_284` to `1.3k`, `18_200_000` to `18.2m`, through `b` and `t`, with an\n * optional unit appended. `precision` is the decimals kept, `1` by default.\n *\n * `%` joins without a space because \"99.2 %\" reads wrong; every other unit gets\n * one.\n */\nexport const formatCompactNumber = (\n  value: number,\n  unit = '',\n  precision = 1\n): string => {\n  const abs = Math.abs(value);\n  let index = TIERS.findIndex(({ size }) => abs >= size);\n  if (index === -1) index = TIERS.length - 1;\n  // A value that rounds up to the tier's next power, `999.96k`, reads as `1m`.\n  if (\n    index > 0 &&\n    Math.abs(Number((value / TIERS[index]!.size).toFixed(precision))) >= 1_000\n  ) {\n    index -= 1;\n  }\n  const { size, suffix } = TIERS[index]!;\n  const scaled = `${trimDecimal(value / size, precision)}${suffix}`;\n\n  return unit === '' ? scaled : `${scaled}${unit === '%' ? '' : ' '}${unit}`;\n};\n"]}

package/dist/render/html/enhancements.d.ts

@@ -0,0 +1,10 @@
+import { type EnhancementDefinition } from '../../pack/enhancements.js';
+export type { EnhancementDefinition };
+/** The scripts of `applied`, in order, each in its own function scope. */
+export declare const enhancementScript: (applied: readonly EnhancementDefinition[]) => string;
+/**
+ * Binds `root` to the section that contains the emitted `<script>`. Inside a
+ * shadow root `document.currentScript` is `null`, so there it warns instead.
+ */
+export declare const embedScript: (body: string) => string;
+//# sourceMappingURL=enhancements.d.ts.map

package/dist/render/html/enhancements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancements.d.ts","sourceRoot":"","sources":["../../../src/render/html/enhancements.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,GAC5B,SAAS,SAAS,qBAAqB,EAAE,KACxC,MAGY,CAAC;AAEhB;;;GAGG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,KAAG,MAS7B,CAAC"}

package/dist/render/html/enhancements.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { scopeScript, } from '../../pack/enhancements.js';
+/** The scripts of `applied`, in order, each in its own function scope. */
+export const enhancementScript = (applied) => applied
+    .flatMap(({ script }) => (script ? [scopeScript(script)] : []))
+    .join('\n');
+/**
+ * Binds `root` to the section that contains the emitted `<script>`. Inside a
+ * shadow root `document.currentScript` is `null`, so there it warns instead.
+ */
+export const embedScript = (body) => [
+    '(function (root) {',
+    'if (!root) {',
+    `console.warn("isomer: enhancement script has no root; render with scripts: 'host' and call runEnhancementScript");`,
+    'return;',
+    '}',
+    body,
+    '})(document.currentScript && document.currentScript.parentElement);',
+].join('\n');
+//# sourceMappingURL=enhancements.js.map

package/dist/render/html/enhancements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhancements.js","sourceRoot":"","sources":["../../../src/render/html/enhancements.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,WAAW,GACZ,MAAM,yBAAyB,CAAC;AAIjC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAAyC,EACjC,EAAE,CACV,OAAO;KACJ,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;AAEhB;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE,CAClD;IACE,oBAAoB;IACpB,cAAc;IACd,oHAAoH;IACpH,SAAS;IACT,GAAG;IACH,IAAI;IACJ,qEAAqE;CACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  type EnhancementDefinition,\n  scopeScript,\n} from '../../pack/enhancements';\n\nexport type { EnhancementDefinition };\n\n/** The scripts of `applied`, in order, each in its own function scope. */\nexport const enhancementScript = (\n  applied: readonly EnhancementDefinition[]\n): string =>\n  applied\n    .flatMap(({ script }) => (script ? [scopeScript(script)] : []))\n    .join('\\n');\n\n/**\n * Binds `root` to the section that contains the emitted `<script>`. Inside a\n * shadow root `document.currentScript` is `null`, so there it warns instead.\n */\nexport const embedScript = (body: string): string =>\n  [\n    '(function (root) {',\n    'if (!root) {',\n    `console.warn(\"isomer: enhancement script has no root; render with scripts: 'host' and call runEnhancementScript\");`,\n    'return;',\n    '}',\n    body,\n    '})(document.currentScript && document.currentScript.parentElement);',\n  ].join('\\n');\n"]}

package/dist/render/html/envelope.d.ts

@@ -0,0 +1,182 @@
+import { type ChildNodeWalker } from '../../composition/body_node_base.js';
+import type { Composition } from '../../composition/composition.js';
+import type { RenderTheme } from '../../composition/named_color.js';
+import type { ValidationError } from '../../composition/validation_error.js';
+import type { AnyPrimitiveDefinition, PrimitiveNode, PrimitiveStyleCollectionContext, PrimitiveStyleCollector, StyledRenderContext, StyleHandle } from '../../define/primitive_module.js';
+import { type CheckedValidationResult, type ValidationErrorMode } from '../../validate/validation.js';
+import { type PayloadMeasurement } from '../payload.js';
+import { type ReactContentDispatcher } from '../react/content.js';
+import { type EnhancementDefinition } from './enhancements.js';
+/** Knobs for the HTML surface. Every field defaults, so `{}` is valid. */
+export interface HTMLRenderOptions {
+    /** Overrides {@link Composition.theme}; `auto` when neither is set. */
+    theme?: RenderTheme;
+    /** Drops whitespace between tags that spans a line break, leaving `<pre>`, `<script>`, `<style>`, and `<textarea>` content intact. Defaults to `true`. */
+    minify?: boolean;
+    /** Adds the `fluid` wrapper class and reaches the pack as {@link PrimitiveStyleCollectionContext.fluid}; the adapter decides what it changes. */
+    fluid?: boolean;
+    /** Adds the `framed` wrapper class the adapter styles as a frame. Defaults to `true`. */
+    framed?: boolean;
+    /**
+     * Renders the composition's title and subtitle. Defaults to `true`. Set
+     * `false` when the embedding host already shows the title itself — the title
+     * still backs the wrapper's `aria-label`.
+     */
+    heading?: boolean;
+    /** Whether the collected CSS is inlined as a `<style>` element. Defaults to `'inline'`. */
+    css?: 'inline' | 'separate';
+    /**
+     * Who runs the enhancement script. Defaults to `'embedded'`: `html` carries
+     * a `<script>` that finds its own `.isomer` section when the page parses it.
+     *
+     * `'embedded'` never runs inside a shadow root, or anywhere the host inserts
+     * `html` itself (`innerHTML`, a React tree). Use `'host'` there: `html`
+     * carries no `<script>`, and the host calls `runEnhancementScript(js,
+     * section)` after inserting it.
+     */
+    scripts?: 'embedded' | 'host';
+    /** Defaults to collecting into {@link HTMLRenderResult.validationErrors}; `'throw'` raises instead. Input the budget refused raises in either mode. */
+    onValidationError?: ValidationErrorMode;
+    /** Opt-in by {@link EnhancementDefinition.id}. One whose content gate does not match the body is dropped. */
+    enhancements?: readonly string[];
+    /** `true` renders node anchors whether or not an enhancement asks for them, e.g. for tests. `false` cannot turn off anchors an enhancement needs. */
+    anchors?: boolean;
+    /**
+     * Resolves `light-dark(…)` in the stylesheet to one scheme's value. A browser
+     * resolves it itself; an image is one static frame, so the `snapshot` surface sets
+     * it.
+     */
+    scheme?: 'light' | 'dark';
+}
+/**
+ * One rendered HTML payload.
+ *
+ * `body` is the primitive markup alone; `html` adds the wrapper element, on
+ * the default `css: 'inline'` a `<style>`, and on the default
+ * `scripts: 'embedded'` a `<script>`. `css` and `js` are populated either way.
+ * `validationErrors` are the messages that survived
+ * {@link HTMLRenderOptions.onValidationError}.
+ */
+export interface HTMLRenderResult {
+    html: string;
+    css: string;
+    /**
+     * The enhancement script as a function body over `root`, or `''`. Under
+     * `scripts: 'embedded'` the `<script>` in `html` wraps the same body; under
+     * `'host'` the host runs it with `runEnhancementScript`. It is never a
+     * complete script on its own.
+     */
+    js: string;
+    body: string;
+    measurement: PayloadMeasurement;
+    validationErrors: ValidationError[];
+}
+/**
+ * A pack's HTML entry point: the React renderer plus the style pass that runs
+ * ahead of it.
+ */
+export interface HTMLRenderDispatcher<TNode extends PrimitiveNode, TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector, TContext = StyledRenderContext> extends ReactContentDispatcher<TNode, TContext> {
+    /** The whole composition's inventory: a child walker built from one pack's definitions cannot descend into another pack's container. */
+    readonly definitions: readonly AnyPrimitiveDefinition[];
+    /** One node's style pass, driven by {@link HTMLStyleAdapter.collectViewStyles} rather than called by the sdk. */
+    collectStyles(node: TNode, collector: TCollector, context: PrimitiveStyleCollectionContext): void;
+}
+/**
+ * The composition's child walker and the enhancements every loaded pack
+ * declared. Threaded into the style adapter so content-gating can see a
+ * table nested inside a container from another package.
+ */
+export interface HTMLEnhancementScope {
+    walk: ChildNodeWalker;
+    definitions: readonly EnhancementDefinition[];
+}
+/**
+ * How a pack turns its nodes into CSS. Optional overall — without an adapter
+ * the render still produces markup, just with no class names and an empty
+ * `TContext`.
+ */
+export interface HTMLStyleAdapter<TNode extends PrimitiveNode = PrimitiveNode, TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector, TContext = StyledRenderContext> {
+    /**
+     * Names the collector shape {@link HTMLStyleAdapter.createCollector} returns, so a runtime can
+     * reject a pack whose `collectStyles` hooks were written against a different one.
+     */
+    styleCollector?: string;
+    /** One collector per render, shared by every other hook here and by both render passes. */
+    createCollector(options: HTMLRenderOptions): TCollector;
+    /**
+     * Settles options that depend on the composition, before anything reads them.
+     *
+     * Needed by an adapter whose look is chosen per render: deciding `framed`
+     * from the body has to happen before the wrapper class is written, not while
+     * CSS is collected.
+     */
+    resolveOptions?(composition: Composition<TNode>, options: HTMLRenderOptions): HTMLRenderOptions;
+    /**
+     * The `.isomer` / `.isomer.framed` / `.isomer.fluid` rules around a rendered composition.
+     * Named for the wrapper rather than the frame, which the sdk reserves for the
+     * document a snapshot is drawn inside.
+     */
+    collectWrapperStyles?(collector: TCollector, options: HTMLRenderOptions): void;
+    /** Walks the body into the collector, usually through {@link HTMLRenderDispatcher.collectStyles}. Runs before any markup exists. */
+    collectViewStyles?(composition: Composition<TNode>, dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>, collector: TCollector, context: PrimitiveStyleCollectionContext, options: HTMLRenderOptions, scope: HTMLEnhancementScope): void;
+    /** Runs once the collection pass has rendered the body, for styles only a renderer can discover. That markup is discarded. */
+    collectAfterRender?(composition: Composition<TNode>, collector: TCollector, options: HTMLRenderOptions): void;
+    /**
+     * Builds the render context handed to every `react` renderer. Called once
+     * per pass, so an adapter that behaves differently while collecting returns
+     * a different context then. Must be complete, because `TContext` is the
+     * pack's own type. The sdk never writes to it: whether renderers anchor
+     * is the surface's decision, whatever the context's `anchors` says.
+     */
+    createRenderContext(collector: TCollector, options: HTMLRenderOptions): TContext;
+    /** The collected CSS as text, with no `<style>` wrapper; the sdk adds one when `css` is `'inline'`. */
+    renderStyles(collector: TCollector, options: HTMLRenderOptions): string;
+    /**
+     * Whether `handle` belongs to this adapter's stylesheet.
+     *
+     * Unused on a lone adapter. A runtime composing several packs' adapters
+     * routes each handle to its owner, so CSS is neither duplicated nor
+     * rendered against the wrong theme. An adapter that cannot answer this
+     * cannot be combined with another.
+     */
+    ownsHandle?(handle: StyleHandle): boolean;
+    /**
+     * Appended after {@link HTMLDispatcherRenderOptions.scriptText} into the
+     * render's one script. A function body with `root` in scope, under the same
+     * rules as {@link EnhancementDefinition.script}.
+     */
+    getScriptText?(composition: Composition<TNode>, options: HTMLRenderOptions, scope: HTMLEnhancementScope): string;
+}
+/** What {@link renderHTMLWithDispatcher} needs beyond the composition. */
+export interface HTMLDispatcherRenderOptions<TNode extends PrimitiveNode, TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector, TContext = StyledRenderContext> {
+    dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>;
+    /** Runs once before rendering, which draws the composition it returns; {@link HTMLRenderOptions.onValidationError} decides what becomes of its errors. Defaults to `createCompositionValidator(dispatcher.definitions)`. */
+    validate?: (composition: Composition<TNode>) => CheckedValidationResult<TNode>;
+    options?: HTMLRenderOptions;
+    /** Used only when the composition has neither `meta.ariaLabel` nor a `title`. Defaults to `'View'`. */
+    defaultAriaLabel?: string;
+    styleAdapter?: HTMLStyleAdapter<TNode, TCollector, TContext>;
+    /**
+     * Emitted unescaped ahead of {@link HTMLStyleAdapter.getScriptText}. A
+     * function body with `root` in scope, under the same rules as
+     * {@link EnhancementDefinition.script}.
+     */
+    scriptText?: string;
+    /**
+     * Progressive enhancements declared by the packs this render was composed
+     * from. The render resolves {@link HTMLRenderOptions.enhancements} against
+     * them once, hands every renderer the set as `context.enhancements`, and
+     * emits each resolved one's script.
+     */
+    enhancementDefinitions?: readonly EnhancementDefinition[];
+}
+/**
+ * Renders a composition to standalone HTML: the wrapper element, the pack's
+ * markup, and its CSS either inlined or returned separately.
+ *
+ * Runs the pack twice when a style adapter is present — once to collect
+ * styles, once with the render context those styles produced — so a
+ * `renderReact` implementation must be free of side effects.
+ */
+export declare const renderHTMLWithDispatcher: <TNode extends PrimitiveNode, TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector, TContext = StyledRenderContext>(input: Composition<TNode>, { dispatcher, validate, options: rawOptions, defaultAriaLabel, styleAdapter, scriptText, enhancementDefinitions, }: HTMLDispatcherRenderOptions<TNode, TCollector, TContext>) => HTMLRenderResult;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/render/html/envelope.d.ts.map

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

package/dist/render/html/envelope.js

@@ -0,0 +1,214 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { createElement, Fragment } from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+import { parse, } from 'acorn';
+import { createChildNodeWalker, } from '../../composition/body_node_base.js';
+import { EMBEDDED_SCRIPT_ATTRIBUTE, resolveEnhancements, scopeScript, } from '../../pack/enhancements.js';
+import { compositionToRender, createCompositionValidator, enforceValidationMode, } from '../../validate/validation.js';
+import { withAnchors } from '../anchors.js';
+import { contextWith } from '../context_view.js';
+import { byteLength } from '../payload.js';
+import { renderCompositionContent, wrapCompositionContent, } from '../react/content.js';
+import { embedScript, enhancementScript, } from './enhancements.js';
+/**
+ * Renders a composition to standalone HTML: the wrapper element, the pack's
+ * markup, and its CSS either inlined or returned separately.
+ *
+ * Runs the pack twice when a style adapter is present — once to collect
+ * styles, once with the render context those styles produced — so a
+ * `renderReact` implementation must be free of side effects.
+ */
+export const renderHTMLWithDispatcher = (input, { dispatcher, validate = createCompositionValidator(dispatcher.definitions), options: rawOptions = {}, defaultAriaLabel = 'View', styleAdapter, scriptText = '', enhancementDefinitions = [], }) => {
+    const validation = validate(input);
+    const composition = compositionToRender(validation);
+    // Resolved before the validation mode is read, so an adapter can derive
+    // `onValidationError`.
+    const options = styleAdapter?.resolveOptions?.(composition, rawOptions) ?? rawOptions;
+    enforceValidationMode(validation, options.onValidationError);
+    const framed = options.framed ?? true;
+    const heading = options.heading ?? true;
+    const theme = options.theme ?? composition.theme ?? 'auto';
+    const cssMode = options.css ?? 'inline';
+    const scriptsMode = options.scripts ?? 'embedded';
+    const styleState = styleAdapter?.createCollector(options);
+    const enhancementScope = {
+        walk: createChildNodeWalker(dispatcher.definitions),
+        definitions: enhancementDefinitions,
+    };
+    const applied = resolveEnhancements(composition.body, enhancementScope.walk, enhancementDefinitions, options.enhancements ?? []);
+    const enhancements = new Set(applied.map(({ id }) => id));
+    const anchors = options.anchors === true || applied.some(({ anchors }) => anchors);
+    const enhanced = (context) => contextWith(context, 'enhancements', enhancements);
+    if (styleState) {
+        styleAdapter?.collectWrapperStyles?.(styleState, options);
+        styleAdapter?.collectViewStyles?.(composition, dispatcher, styleState, { fluid: Boolean(options.fluid) }, options, enhancementScope);
+        const collectionContext = enhanced(styleAdapter?.createRenderContext(styleState, options));
+        withAnchors(anchors, () => renderToStaticMarkup(createElement(() => renderCompositionContent(composition, dispatcher, collectionContext, {
+            heading,
+        }))));
+        styleAdapter?.collectAfterRender?.(composition, styleState, options);
+    }
+    const renderContext = enhanced(styleState && styleAdapter
+        ? styleAdapter.createRenderContext(styleState, options)
+        : // No adapter means no class names and no css vars to resolve.
+            {});
+    const cssText = styleState && styleAdapter
+        ? styleAdapter.renderStyles(styleState, options)
+        : '';
+    const adapterScriptText = styleAdapter?.getScriptText?.(composition, options, enhancementScope) ?? '';
+    const js = [
+        ...[scriptText, adapterScriptText].filter(Boolean).map(scopeScript),
+        enhancementScript(applied),
+    ]
+        .filter(Boolean)
+        .join('\n');
+    const embeddedScript = js && scriptsMode === 'embedded' ? embedScript(js) : '';
+    const body = withAnchors(anchors, () => renderToStaticMarkup(createElement(() => renderCompositionContent(composition, dispatcher, renderContext, {
+        heading,
+    }))));
+    const inlineCss = cssMode === 'inline' ? embedCss(cssText) : '';
+    const inlineJs = embeddedScript ? embedJs(embeddedScript) : '';
+    const raw = renderToStaticMarkup(createElement((RenderedHtmlView), {
+        composition,
+        theme,
+        fluid: Boolean(options.fluid),
+        framed,
+        styleText: inlineCss || undefined,
+        scriptText: inlineJs || undefined,
+        defaultAriaLabel,
+        body,
+    }));
+    const html = options.minify === false ? raw : minifyHtml(raw);
+    // Inline payloads are measured as emitted, escapes included.
+    const inlineCssBytes = byteLength(inlineCss);
+    const inlineJsBytes = byteLength(inlineJs);
+    const separateCssBytes = cssMode === 'inline' ? 0 : byteLength(cssText);
+    const separateJsBytes = embeddedScript ? 0 : byteLength(js);
+    return {
+        html,
+        css: cssText,
+        js,
+        body,
+        measurement: {
+            html: byteLength(html) - inlineCssBytes - inlineJsBytes,
+            css: inlineCssBytes + separateCssBytes,
+            js: inlineJsBytes + separateJsBytes,
+            total: byteLength(html) + separateCssBytes + separateJsBytes,
+        },
+        validationErrors: validation.errors,
+    };
+};
+// Only `</style` ends a `<style>`. `\/` is a CSS escape for `/`, so a string
+// holding it keeps its value.
+const embedCss = (css) => css.replace(/<\/(?=style)/gi, '<\\/');
+// Tagged templates observe raw spelling and reuse the same frozen object per site.
+const embedJs = (js) => {
+    if (!/<\/script|<!--/i.test(js))
+        return js;
+    const comments = [];
+    const tree = parse(js, { ecmaVersion: 'latest', onComment: comments });
+    const sites = [];
+    const identifiers = new Set();
+    const pending = [tree];
+    while (pending.length) {
+        const node = pending.pop();
+        if (node.type === 'Identifier' && node.name)
+            identifiers.add(node.name);
+        if (node.type === 'TaggedTemplateExpression' &&
+            node.quasi.quasis.some(({ value: { raw } }) => /<\/script|<!--/i.test(raw)))
+            sites.push(node);
+        for (const value of Object.values(node)) {
+            for (const child of Array.isArray(value) ? value : [value]) {
+                if (child &&
+                    typeof child === 'object' &&
+                    'type' in child &&
+                    'start' in child) {
+                    pending.push(child);
+                }
+            }
+        }
+    }
+    sites.sort((a, b) => a.start - b.start);
+    let prefix = '__isomerTemplate';
+    while ([...identifiers].some((name) => name.startsWith(prefix)))
+        prefix += '_';
+    const literal = (value) => value === null ? 'void 0' : JSON.stringify(value).replace(/</g, '\\u003c');
+    const rewrite = (start, end) => {
+        let cursor = start;
+        let result = '';
+        const edits = [
+            ...sites.map((site, index) => ({
+                ...site,
+                index,
+                comment: undefined,
+            })),
+            ...comments
+                .filter(({ start }) => /^(?:<!--|-->)/.test(js.slice(start, start + 4)))
+                .map((comment) => ({ ...comment, index: -1, comment: comment.value })),
+        ].sort((a, b) => a.start - b.start);
+        for (const edit of edits) {
+            if (edit.start < cursor || edit.end > end)
+                continue;
+            result += js.slice(cursor, edit.start);
+            if (edit.comment !== undefined) {
+                result += `//${edit.comment}`;
+            }
+            else {
+                const site = sites[edit.index];
+                const { tag, quasi: { quasis, expressions }, } = site;
+                const cooked = quasis
+                    .map(({ value }) => literal(value.cooked))
+                    .join(',');
+                const raw = quasis.map(({ value }) => literal(value.raw)).join(',');
+                const cache = `${prefix}${edit.index}`;
+                const template = `${cache} ??= ${prefix}Freeze(${prefix}Define([${cooked}], 'raw', {value:${prefix}Freeze([${raw}])}))`;
+                const args = expressions.map((expression) => rewrite(expression.start, expression.end));
+                result += `(${rewrite(tag.start, tag.end)})(${template}${args.map((arg) => `,(${arg})`).join('')})`;
+            }
+            cursor = edit.end;
+        }
+        return result + js.slice(cursor, end);
+    };
+    const rewritten = rewrite(0, js.length);
+    const scoped = sites.length
+        ? `(function(){const ${prefix}Freeze=Object.freeze,${prefix}Define=Object.defineProperty;let ${sites.map((_site, index) => `${prefix}${index}`).join(',')};\n${rewritten}\n})();`
+        : rewritten;
+    return scoped
+        .replace(/<\/(?=script)/gi, '<\\/')
+        .replace(/<!--/g, (_match, at, source) => escapedBy(source, at) ? 'x3C!--' : '\\x3C!--');
+};
+const escapedBy = (source, at) => {
+    let slashes = 0;
+    while (source[at - slashes - 1] === '\\')
+        slashes += 1;
+    return slashes % 2 === 1;
+};
+const RenderedHtmlView = ({ composition, theme, fluid, framed, styleText, scriptText, defaultAriaLabel, body, }) => wrapCompositionContent(createElement(Fragment, null, styleText
+    ? createElement('style', {
+        key: 'style',
+        dangerouslySetInnerHTML: { __html: styleText },
+    })
+    : null, createElement('div', {
+    key: 'body',
+    dangerouslySetInnerHTML: { __html: body },
+}), scriptText
+    ? createElement('script', {
+        key: 'script',
+        [EMBEDDED_SCRIPT_ATTRIBUTE]: '',
+        dangerouslySetInnerHTML: { __html: scriptText },
+    })
+    : null), composition, { framed, fluid, theme, defaultAriaLabel });
+// Whitespace inside `pre`, `script`, `style`, and `textarea` is content, so
+// those elements match whole and pass through. Elsewhere only whitespace
+// spanning a line break is collapsed: a single space between inline elements
+// (`<b>a</b> <i>b</i>`) is authored content.
+const MINIFY_RE = /<(pre|script|style|textarea)[\s>][\s\S]*?(?:<\/\1\s*>|$)|(?<=>)\s+(?=<)/gi;
+const minifyHtml = (value) => value
+    .replace(MINIFY_RE, (match, element) => element || !match.includes('\n') ? match : '')
+    .trim();
+//# sourceMappingURL=envelope.js.map

package/dist/render/html/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/render/html/envelope.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 { createElement, Fragment, type ReactNode } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\nimport {\n  type Comment as JavaScriptComment,\n  type Node as JavaScriptNode,\n  parse,\n} from 'acorn';\n\nimport {\n  type ChildNodeWalker,\n  createChildNodeWalker,\n} from '../../composition/body_node_base';\nimport type { Composition } from '../../composition/composition';\nimport type { RenderTheme } from '../../composition/named_color';\nimport type { ValidationError } from '../../composition/validation_error';\nimport type {\n  AnyPrimitiveDefinition,\n  PrimitiveNode,\n  PrimitiveStyleCollectionContext,\n  PrimitiveStyleCollector,\n  StyledRenderContext,\n  StyleHandle,\n} from '../../define/primitive_module';\nimport {\n  EMBEDDED_SCRIPT_ATTRIBUTE,\n  resolveEnhancements,\n  scopeScript,\n} from '../../pack/enhancements';\nimport {\n  type CheckedValidationResult,\n  compositionToRender,\n  createCompositionValidator,\n  enforceValidationMode,\n  type ValidationErrorMode,\n} from '../../validate/validation';\nimport { withAnchors } from '../anchors';\nimport { contextWith } from '../context_view';\nimport { byteLength, type PayloadMeasurement } from '../payload';\nimport {\n  type ReactContentDispatcher,\n  renderCompositionContent,\n  wrapCompositionContent,\n} from '../react/content';\n\nimport {\n  embedScript,\n  type EnhancementDefinition,\n  enhancementScript,\n} from './enhancements';\n\n/** Knobs for the HTML surface. Every field defaults, so `{}` is valid. */\nexport interface HTMLRenderOptions {\n  /** Overrides {@link Composition.theme}; `auto` when neither is set. */\n  theme?: RenderTheme;\n  /** Drops whitespace between tags that spans a line break, leaving `<pre>`, `<script>`, `<style>`, and `<textarea>` content intact. Defaults to `true`. */\n  minify?: boolean;\n  /** Adds the `fluid` wrapper class and reaches the pack as {@link PrimitiveStyleCollectionContext.fluid}; the adapter decides what it changes. */\n  fluid?: boolean;\n  /** Adds the `framed` wrapper class the adapter styles as a frame. Defaults to `true`. */\n  framed?: boolean;\n  /**\n   * Renders the composition's title and subtitle. Defaults to `true`. Set\n   * `false` when the embedding host already shows the title itself — the title\n   * still backs the wrapper's `aria-label`.\n   */\n  heading?: boolean;\n  /** Whether the collected CSS is inlined as a `<style>` element. Defaults to `'inline'`. */\n  css?: 'inline' | 'separate';\n  /**\n   * Who runs the enhancement script. Defaults to `'embedded'`: `html` carries\n   * a `<script>` that finds its own `.isomer` section when the page parses it.\n   *\n   * `'embedded'` never runs inside a shadow root, or anywhere the host inserts\n   * `html` itself (`innerHTML`, a React tree). Use `'host'` there: `html`\n   * carries no `<script>`, and the host calls `runEnhancementScript(js,\n   * section)` after inserting it.\n   */\n  scripts?: 'embedded' | 'host';\n  /** Defaults to collecting into {@link HTMLRenderResult.validationErrors}; `'throw'` raises instead. Input the budget refused raises in either mode. */\n  onValidationError?: ValidationErrorMode;\n  /** Opt-in by {@link EnhancementDefinition.id}. One whose content gate does not match the body is dropped. */\n  enhancements?: readonly string[];\n  /** `true` renders node anchors whether or not an enhancement asks for them, e.g. for tests. `false` cannot turn off anchors an enhancement needs. */\n  anchors?: boolean;\n  /**\n   * Resolves `light-dark(…)` in the stylesheet to one scheme's value. A browser\n   * resolves it itself; an image is one static frame, so the `snapshot` surface sets\n   * it.\n   */\n  scheme?: 'light' | 'dark';\n}\n\n/**\n * One rendered HTML payload.\n *\n * `body` is the primitive markup alone; `html` adds the wrapper element, on\n * the default `css: 'inline'` a `<style>`, and on the default\n * `scripts: 'embedded'` a `<script>`. `css` and `js` are populated either way.\n * `validationErrors` are the messages that survived\n * {@link HTMLRenderOptions.onValidationError}.\n */\nexport interface HTMLRenderResult {\n  html: string;\n  css: string;\n  /**\n   * The enhancement script as a function body over `root`, or `''`. Under\n   * `scripts: 'embedded'` the `<script>` in `html` wraps the same body; under\n   * `'host'` the host runs it with `runEnhancementScript`. It is never a\n   * complete script on its own.\n   */\n  js: string;\n  body: string;\n  measurement: PayloadMeasurement;\n  validationErrors: ValidationError[];\n}\n\n/**\n * A pack's HTML entry point: the React renderer plus the style pass that runs\n * ahead of it.\n */\nexport interface HTMLRenderDispatcher<\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> extends ReactContentDispatcher<TNode, TContext> {\n  /** The whole composition's inventory: a child walker built from one pack's definitions cannot descend into another pack's container. */\n  readonly definitions: readonly AnyPrimitiveDefinition[];\n  /** One node's style pass, driven by {@link HTMLStyleAdapter.collectViewStyles} rather than called by the sdk. */\n  collectStyles(\n    node: TNode,\n    collector: TCollector,\n    context: PrimitiveStyleCollectionContext\n  ): void;\n}\n\n/**\n * The composition's child walker and the enhancements every loaded pack\n * declared. Threaded into the style adapter so content-gating can see a\n * table nested inside a container from another package.\n */\nexport interface HTMLEnhancementScope {\n  walk: ChildNodeWalker;\n  definitions: readonly EnhancementDefinition[];\n}\n\n/**\n * How a pack turns its nodes into CSS. Optional overall — without an adapter\n * the render still produces markup, just with no class names and an empty\n * `TContext`.\n */\nexport interface HTMLStyleAdapter<\n  TNode extends PrimitiveNode = PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> {\n  /**\n   * Names the collector shape {@link HTMLStyleAdapter.createCollector} returns, so a runtime can\n   * reject a pack whose `collectStyles` hooks were written against a different one.\n   */\n  styleCollector?: string;\n  /** One collector per render, shared by every other hook here and by both render passes. */\n  createCollector(options: HTMLRenderOptions): TCollector;\n  /**\n   * Settles options that depend on the composition, before anything reads them.\n   *\n   * Needed by an adapter whose look is chosen per render: deciding `framed`\n   * from the body has to happen before the wrapper class is written, not while\n   * CSS is collected.\n   */\n  resolveOptions?(\n    composition: Composition<TNode>,\n    options: HTMLRenderOptions\n  ): HTMLRenderOptions;\n  /**\n   * The `.isomer` / `.isomer.framed` / `.isomer.fluid` rules around a rendered composition.\n   * Named for the wrapper rather than the frame, which the sdk reserves for the\n   * document a snapshot is drawn inside.\n   */\n  collectWrapperStyles?(\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): void;\n  /** Walks the body into the collector, usually through {@link HTMLRenderDispatcher.collectStyles}. Runs before any markup exists. */\n  collectViewStyles?(\n    composition: Composition<TNode>,\n    dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>,\n    collector: TCollector,\n    context: PrimitiveStyleCollectionContext,\n    options: HTMLRenderOptions,\n    scope: HTMLEnhancementScope\n  ): void;\n  /** Runs once the collection pass has rendered the body, for styles only a renderer can discover. That markup is discarded. */\n  collectAfterRender?(\n    composition: Composition<TNode>,\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): void;\n  /**\n   * Builds the render context handed to every `react` renderer. Called once\n   * per pass, so an adapter that behaves differently while collecting returns\n   * a different context then. Must be complete, because `TContext` is the\n   * pack's own type. The sdk never writes to it: whether renderers anchor\n   * is the surface's decision, whatever the context's `anchors` says.\n   */\n  createRenderContext(\n    collector: TCollector,\n    options: HTMLRenderOptions\n  ): TContext;\n  /** The collected CSS as text, with no `<style>` wrapper; the sdk adds one when `css` is `'inline'`. */\n  renderStyles(collector: TCollector, options: HTMLRenderOptions): string;\n  /**\n   * Whether `handle` belongs to this adapter's stylesheet.\n   *\n   * Unused on a lone adapter. A runtime composing several packs' adapters\n   * routes each handle to its owner, so CSS is neither duplicated nor\n   * rendered against the wrong theme. An adapter that cannot answer this\n   * cannot be combined with another.\n   */\n  ownsHandle?(handle: StyleHandle): boolean;\n  /**\n   * Appended after {@link HTMLDispatcherRenderOptions.scriptText} into the\n   * render's one script. A function body with `root` in scope, under the same\n   * rules as {@link EnhancementDefinition.script}.\n   */\n  getScriptText?(\n    composition: Composition<TNode>,\n    options: HTMLRenderOptions,\n    scope: HTMLEnhancementScope\n  ): string;\n}\n\n/** What {@link renderHTMLWithDispatcher} needs beyond the composition. */\nexport interface HTMLDispatcherRenderOptions<\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n> {\n  dispatcher: HTMLRenderDispatcher<TNode, TCollector, TContext>;\n  /** Runs once before rendering, which draws the composition it returns; {@link HTMLRenderOptions.onValidationError} decides what becomes of its errors. Defaults to `createCompositionValidator(dispatcher.definitions)`. */\n  validate?: (\n    composition: Composition<TNode>\n  ) => CheckedValidationResult<TNode>;\n  options?: HTMLRenderOptions;\n  /** Used only when the composition has neither `meta.ariaLabel` nor a `title`. Defaults to `'View'`. */\n  defaultAriaLabel?: string;\n  styleAdapter?: HTMLStyleAdapter<TNode, TCollector, TContext>;\n  /**\n   * Emitted unescaped ahead of {@link HTMLStyleAdapter.getScriptText}. A\n   * function body with `root` in scope, under the same rules as\n   * {@link EnhancementDefinition.script}.\n   */\n  scriptText?: string;\n  /**\n   * Progressive enhancements declared by the packs this render was composed\n   * from. The render resolves {@link HTMLRenderOptions.enhancements} against\n   * them once, hands every renderer the set as `context.enhancements`, and\n   * emits each resolved one's script.\n   */\n  enhancementDefinitions?: readonly EnhancementDefinition[];\n}\n\n/**\n * Renders a composition to standalone HTML: the wrapper element, the pack's\n * markup, and its CSS either inlined or returned separately.\n *\n * Runs the pack twice when a style adapter is present — once to collect\n * styles, once with the render context those styles produced — so a\n * `renderReact` implementation must be free of side effects.\n */\nexport const renderHTMLWithDispatcher = <\n  TNode extends PrimitiveNode,\n  TCollector extends PrimitiveStyleCollector = PrimitiveStyleCollector,\n  TContext = StyledRenderContext,\n>(\n  input: Composition<TNode>,\n  {\n    dispatcher,\n    validate = createCompositionValidator<TNode>(dispatcher.definitions),\n    options: rawOptions = {},\n    defaultAriaLabel = 'View',\n    styleAdapter,\n    scriptText = '',\n    enhancementDefinitions = [],\n  }: HTMLDispatcherRenderOptions<TNode, TCollector, TContext>\n): HTMLRenderResult => {\n  const validation = validate(input);\n  const composition = compositionToRender(validation);\n  // Resolved before the validation mode is read, so an adapter can derive\n  // `onValidationError`.\n  const options =\n    styleAdapter?.resolveOptions?.(composition, rawOptions) ?? rawOptions;\n  enforceValidationMode(validation, options.onValidationError);\n  const framed = options.framed ?? true;\n  const heading = options.heading ?? true;\n  const theme = options.theme ?? composition.theme ?? 'auto';\n  const cssMode = options.css ?? 'inline';\n  const scriptsMode = options.scripts ?? 'embedded';\n  const styleState = styleAdapter?.createCollector(options);\n  const enhancementScope: HTMLEnhancementScope = {\n    walk: createChildNodeWalker(dispatcher.definitions),\n    definitions: enhancementDefinitions,\n  };\n  const applied = resolveEnhancements(\n    composition.body,\n    enhancementScope.walk,\n    enhancementDefinitions,\n    options.enhancements ?? []\n  );\n  const enhancements: ReadonlySet<string> = new Set(\n    applied.map(({ id }) => id)\n  );\n  const anchors =\n    options.anchors === true || applied.some(({ anchors }) => anchors);\n  const enhanced = (context: TContext): TContext =>\n    contextWith(context, 'enhancements', enhancements);\n\n  if (styleState) {\n    styleAdapter?.collectWrapperStyles?.(styleState, options);\n    styleAdapter?.collectViewStyles?.(\n      composition,\n      dispatcher,\n      styleState,\n      { fluid: Boolean(options.fluid) },\n      options,\n      enhancementScope\n    );\n    const collectionContext = enhanced(\n      styleAdapter?.createRenderContext(styleState, options) as TContext\n    );\n    withAnchors(anchors, () =>\n      renderToStaticMarkup(\n        createElement(() =>\n          renderCompositionContent(composition, dispatcher, collectionContext, {\n            heading,\n          })\n        )\n      )\n    );\n    styleAdapter?.collectAfterRender?.(composition, styleState, options);\n  }\n\n  const renderContext = enhanced(\n    styleState && styleAdapter\n      ? styleAdapter.createRenderContext(styleState, options)\n      : // No adapter means no class names and no css vars to resolve.\n        ({} as TContext)\n  );\n  const cssText =\n    styleState && styleAdapter\n      ? styleAdapter.renderStyles(styleState, options)\n      : '';\n  const adapterScriptText =\n    styleAdapter?.getScriptText?.(composition, options, enhancementScope) ?? '';\n  const js = [\n    ...[scriptText, adapterScriptText].filter(Boolean).map(scopeScript),\n    enhancementScript(applied),\n  ]\n    .filter(Boolean)\n    .join('\\n');\n  const embeddedScript =\n    js && scriptsMode === 'embedded' ? embedScript(js) : '';\n  const body = withAnchors(anchors, () =>\n    renderToStaticMarkup(\n      createElement(() =>\n        renderCompositionContent(composition, dispatcher, renderContext, {\n          heading,\n        })\n      )\n    )\n  );\n  const inlineCss = cssMode === 'inline' ? embedCss(cssText) : '';\n  const inlineJs = embeddedScript ? embedJs(embeddedScript) : '';\n  const raw = renderToStaticMarkup(\n    createElement(RenderedHtmlView<TNode>, {\n      composition,\n      theme,\n      fluid: Boolean(options.fluid),\n      framed,\n      styleText: inlineCss || undefined,\n      scriptText: inlineJs || undefined,\n      defaultAriaLabel,\n      body,\n    })\n  );\n  const html = options.minify === false ? raw : minifyHtml(raw);\n\n  // Inline payloads are measured as emitted, escapes included.\n  const inlineCssBytes = byteLength(inlineCss);\n  const inlineJsBytes = byteLength(inlineJs);\n  const separateCssBytes = cssMode === 'inline' ? 0 : byteLength(cssText);\n  const separateJsBytes = embeddedScript ? 0 : byteLength(js);\n\n  return {\n    html,\n    css: cssText,\n    js,\n    body,\n    measurement: {\n      html: byteLength(html) - inlineCssBytes - inlineJsBytes,\n      css: inlineCssBytes + separateCssBytes,\n      js: inlineJsBytes + separateJsBytes,\n      total: byteLength(html) + separateCssBytes + separateJsBytes,\n    },\n    validationErrors: validation.errors,\n  };\n};\n\ninterface RenderedHtmlViewProps<TNode extends PrimitiveNode> {\n  composition: Composition<TNode>;\n  theme: RenderTheme;\n  fluid: boolean;\n  framed: boolean;\n  styleText?: string | undefined;\n  scriptText?: string | undefined;\n  defaultAriaLabel: string;\n  body: string;\n}\n\n// Only `</style` ends a `<style>`. `\\/` is a CSS escape for `/`, so a string\n// holding it keeps its value.\nconst embedCss = (css: string): string => css.replace(/<\\/(?=style)/gi, '<\\\\/');\n\ninterface ScriptNode extends JavaScriptNode {\n  tag: ScriptNode;\n  quasi: ScriptNode;\n  quasis: ScriptNode[];\n  expressions: ScriptNode[];\n  value: { raw: string; cooked: string | null };\n  name?: string;\n}\n\n// Tagged templates observe raw spelling and reuse the same frozen object per site.\nconst embedJs = (js: string): string => {\n  if (!/<\\/script|<!--/i.test(js)) return js;\n  const comments: JavaScriptComment[] = [];\n  const tree = parse(js, { ecmaVersion: 'latest', onComment: comments });\n  const sites: ScriptNode[] = [];\n  const identifiers = new Set<string>();\n  const pending: JavaScriptNode[] = [tree];\n  while (pending.length) {\n    const node = pending.pop()! as ScriptNode;\n    if (node.type === 'Identifier' && node.name) identifiers.add(node.name);\n    if (\n      node.type === 'TaggedTemplateExpression' &&\n      node.quasi.quasis.some(({ value: { raw } }) =>\n        /<\\/script|<!--/i.test(raw)\n      )\n    )\n      sites.push(node);\n    for (const value of Object.values(node)) {\n      for (const child of Array.isArray(value) ? value : [value]) {\n        if (\n          child &&\n          typeof child === 'object' &&\n          'type' in child &&\n          'start' in child\n        ) {\n          pending.push(child as JavaScriptNode);\n        }\n      }\n    }\n  }\n  sites.sort((a, b) => a.start - b.start);\n  let prefix = '__isomerTemplate';\n  while ([...identifiers].some((name) => name.startsWith(prefix)))\n    prefix += '_';\n  const literal = (value: string | null): string =>\n    value === null ? 'void 0' : JSON.stringify(value).replace(/</g, '\\\\u003c');\n  const rewrite = (start: number, end: number): string => {\n    let cursor = start;\n    let result = '';\n    const edits = [\n      ...sites.map((site, index) => ({\n        ...site,\n        index,\n        comment: undefined as string | undefined,\n      })),\n      ...comments\n        .filter(({ start }) => /^(?:<!--|-->)/.test(js.slice(start, start + 4)))\n        .map((comment) => ({ ...comment, index: -1, comment: comment.value })),\n    ].sort((a, b) => a.start - b.start);\n    for (const edit of edits) {\n      if (edit.start < cursor || edit.end > end) continue;\n      result += js.slice(cursor, edit.start);\n      if (edit.comment !== undefined) {\n        result += `//${edit.comment}`;\n      } else {\n        const site = sites[edit.index]!;\n        const {\n          tag,\n          quasi: { quasis, expressions },\n        } = site;\n        const cooked = quasis\n          .map(({ value }) => literal(value.cooked))\n          .join(',');\n        const raw = quasis.map(({ value }) => literal(value.raw)).join(',');\n        const cache = `${prefix}${edit.index}`;\n        const template = `${cache} ??= ${prefix}Freeze(${prefix}Define([${cooked}], 'raw', {value:${prefix}Freeze([${raw}])}))`;\n        const args = expressions.map((expression) =>\n          rewrite(expression.start, expression.end)\n        );\n        result += `(${rewrite(tag.start, tag.end)})(${template}${args.map((arg) => `,(${arg})`).join('')})`;\n      }\n      cursor = edit.end;\n    }\n    return result + js.slice(cursor, end);\n  };\n  const rewritten = rewrite(0, js.length);\n  const scoped = sites.length\n    ? `(function(){const ${prefix}Freeze=Object.freeze,${prefix}Define=Object.defineProperty;let ${sites.map((_site, index) => `${prefix}${index}`).join(',')};\\n${rewritten}\\n})();`\n    : rewritten;\n  return scoped\n    .replace(/<\\/(?=script)/gi, '<\\\\/')\n    .replace(/<!--/g, (_match, at: number, source: string) =>\n      escapedBy(source, at) ? 'x3C!--' : '\\\\x3C!--'\n    );\n};\n\nconst escapedBy = (source: string, at: number): boolean => {\n  let slashes = 0;\n  while (source[at - slashes - 1] === '\\\\') slashes += 1;\n  return slashes % 2 === 1;\n};\n\nconst RenderedHtmlView = <TNode extends PrimitiveNode>({\n  composition,\n  theme,\n  fluid,\n  framed,\n  styleText,\n  scriptText,\n  defaultAriaLabel,\n  body,\n}: RenderedHtmlViewProps<TNode>): ReactNode =>\n  wrapCompositionContent(\n    createElement(\n      Fragment,\n      null,\n      styleText\n        ? createElement('style', {\n            key: 'style',\n            dangerouslySetInnerHTML: { __html: styleText },\n          })\n        : null,\n      createElement('div', {\n        key: 'body',\n        dangerouslySetInnerHTML: { __html: body },\n      }),\n      scriptText\n        ? createElement('script', {\n            key: 'script',\n            [EMBEDDED_SCRIPT_ATTRIBUTE]: '',\n            dangerouslySetInnerHTML: { __html: scriptText },\n          })\n        : null\n    ),\n    composition,\n    { framed, fluid, theme, defaultAriaLabel }\n  );\n\n// Whitespace inside `pre`, `script`, `style`, and `textarea` is content, so\n// those elements match whole and pass through. Elsewhere only whitespace\n// spanning a line break is collapsed: a single space between inline elements\n// (`<b>a</b> <i>b</i>`) is authored content.\nconst MINIFY_RE =\n  /<(pre|script|style|textarea)[\\s>][\\s\\S]*?(?:<\\/\\1\\s*>|$)|(?<=>)\\s+(?=<)/gi;\n\nconst minifyHtml = (value: string): string =>\n  value\n    .replace(MINIFY_RE, (match, element: string | undefined) =>\n      element || !match.includes('\\n') ? match : ''\n    )\n    .trim();\n"]}

package/dist/render/html/index.d.ts

@@ -0,0 +1,3 @@
+export { type EnhancementDefinition } from './enhancements.js';
+export { type HTMLDispatcherRenderOptions, type HTMLEnhancementScope, type HTMLRenderDispatcher, type HTMLRenderOptions, type HTMLRenderResult, type HTMLStyleAdapter, renderHTMLWithDispatcher, } from './envelope.js';
+//# sourceMappingURL=index.d.ts.map