@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/testing/icon.js

@@ -0,0 +1,244 @@
+/*
+ * 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.
+ */
+// Hosts insert an icon's `svg` as markup, so every rule here is an allowlist.
+import { iconsByType } from '../pack/primitive_pack.js';
+// HTML's markup whitespace, never `\s`: a parser reads NBSP and other Unicode separators as part of a name or as text.
+const NUMBER = /^[-+0-9.eE,\t\n\f\r ]*$/;
+const PATH_DATA = /^[-+0-9.eE,\t\n\f\r MmLlHhVvCcSsQqTtAaZz]*$/;
+const TRANSFORM = /^(?:[\t\n\f\r ]*(?:matrix|translate|scale|rotate|skewX|skewY)[\t\n\f\r ]*\([-+0-9.eE,\t\n\f\r ]*\)[\t\n\f\r ]*,?)*[\t\n\f\r ]*$/;
+const PAINT = /^(?:none|currentColor|var\(--isomer-icon-(?:accent|bg|fg|muted)(?:[\t\n\f\r ]*,[\t\n\f\r ]*(?:currentColor|#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6}))?\))$/;
+const PAINT_RULE = 'is not none, currentColor, or var(--isomer-icon-*)';
+const NAME = /[A-Za-z][\w:.-]*/y;
+const ATTRIBUTE_NAME = /[^\t\n\f\r "'<>/=]+/y;
+const WHITESPACE = /[\t\n\f\r ]*/y;
+const BLANK = /^[\t\n\f\r ]*$/;
+const NAME_END = /[\t\n\f\r />]/;
+const trimMarkup = (text) => text.replace(/^[\t\n\f\r ]+|[\t\n\f\r ]+$/g, '');
+const isNumber = (value) => NUMBER.test(value);
+const keyword = (...words) => (value) => words.includes(value);
+const ATTRIBUTE_RULES = new Map([
+    ['clip-rule', keyword('nonzero', 'evenodd')],
+    ['cx', isNumber],
+    ['cy', isNumber],
+    ['d', (value) => PATH_DATA.test(value)],
+    ['fill', (value) => PAINT.test(value)],
+    ['fill-opacity', isNumber],
+    ['fill-rule', keyword('nonzero', 'evenodd')],
+    ['height', isNumber],
+    ['opacity', isNumber],
+    ['points', isNumber],
+    ['r', isNumber],
+    ['rx', isNumber],
+    ['ry', isNumber],
+    ['stroke', (value) => PAINT.test(value)],
+    ['stroke-linecap', keyword('butt', 'round', 'square')],
+    ['stroke-linejoin', keyword('miter', 'round', 'bevel')],
+    ['stroke-opacity', isNumber],
+    ['stroke-width', isNumber],
+    ['transform', (value) => TRANSFORM.test(value)],
+    ['viewBox', keyword('0 0 16 16')],
+    ['width', isNumber],
+    ['x', isNumber],
+    ['x1', isNumber],
+    ['x2', isNumber],
+    ['xmlns', keyword('http://www.w3.org/2000/svg')],
+    ['y', isNumber],
+    ['y1', isNumber],
+    ['y2', isNumber],
+]);
+const PRESENTATION = [
+    'clip-rule',
+    'fill',
+    'fill-opacity',
+    'fill-rule',
+    'opacity',
+    'stroke',
+    'stroke-linecap',
+    'stroke-linejoin',
+    'stroke-opacity',
+    'stroke-width',
+    'transform',
+];
+const ELEMENT_ATTRIBUTES = new Map([
+    ['svg', new Set(['viewBox', 'xmlns', ...PRESENTATION])],
+    ['g', new Set(PRESENTATION)],
+    ['path', new Set(['d', ...PRESENTATION])],
+    ['rect', new Set(['x', 'y', 'width', 'height', 'rx', 'ry', ...PRESENTATION])],
+    ['circle', new Set(['cx', 'cy', 'r', ...PRESENTATION])],
+    ['ellipse', new Set(['cx', 'cy', 'rx', 'ry', ...PRESENTATION])],
+    ['line', new Set(['x1', 'y1', 'x2', 'y2', ...PRESENTATION])],
+    ['polyline', new Set(['points', ...PRESENTATION])],
+    ['polygon', new Set(['points', ...PRESENTATION])],
+]);
+/** Every way `svg` breaks the icon rules, as one line each; empty when it passes. */
+const iconProblems = (svg) => {
+    const problems = [];
+    const open = [];
+    let roots = 0;
+    let index = 0;
+    const match = (pattern) => {
+        pattern.lastIndex = index;
+        const found = pattern.exec(svg)?.[0] ?? '';
+        index += found.length;
+        return found;
+    };
+    const checkAttributes = (element, attributes) => {
+        const allowed = ELEMENT_ATTRIBUTES.get(element);
+        if (!allowed) {
+            problems.push(`<${element}> is not an allowed element`);
+            return;
+        }
+        for (const [name, value] of attributes) {
+            if (!allowed.has(name)) {
+                problems.push(`${name} is not an allowed attribute on <${element}>`);
+            }
+            else if (value.includes('&')) {
+                problems.push(`${name}="${value}" contains an entity`);
+            }
+            else if (!ATTRIBUTE_RULES.get(name)(value)) {
+                problems.push(name === 'fill' || name === 'stroke'
+                    ? `${name}="${value}" ${PAINT_RULE}`
+                    : `${name}="${value}" is not an allowed value`);
+            }
+        }
+    };
+    while (index < svg.length) {
+        if (svg[index] !== '<') {
+            const end = svg.indexOf('<', index);
+            const text = svg.slice(index, end === -1 ? undefined : end);
+            if (!BLANK.test(text)) {
+                problems.push(open.length > 0
+                    ? `text content "${trimMarkup(text)}" is not allowed`
+                    : `unexpected "${trimMarkup(text)}" outside <svg>`);
+                return problems;
+            }
+            index += text.length;
+            continue;
+        }
+        if (svg.startsWith('<!', index) || svg.startsWith('<?', index)) {
+            problems.push('comments, declarations, and CDATA are not allowed');
+            return problems;
+        }
+        if (svg.startsWith('</', index)) {
+            index += 2;
+            const name = match(NAME);
+            match(WHITESPACE);
+            if (name === '' || svg[index] !== '>') {
+                problems.push('malformed closing tag');
+                return problems;
+            }
+            index += 1;
+            const expected = open.pop();
+            if (expected === undefined) {
+                problems.push(`</${name}> closes nothing`);
+                return problems;
+            }
+            if (expected !== name) {
+                problems.push(`</${name}> does not close <${expected}>`);
+                return problems;
+            }
+            continue;
+        }
+        index += 1;
+        const element = match(NAME);
+        if (element === '' || !NAME_END.test(svg[index] ?? '>')) {
+            problems.push('malformed opening tag');
+            return problems;
+        }
+        if (open.length === 0) {
+            roots += 1;
+            if (roots > 1) {
+                problems.push('more than one root element');
+                return problems;
+            }
+            if (element !== 'svg') {
+                problems.push(`root is <${element}>, not <svg>`);
+                return problems;
+            }
+        }
+        const attributes = new Map();
+        let selfClosing = false;
+        for (;;) {
+            match(WHITESPACE);
+            if (svg.startsWith('/>', index)) {
+                index += 2;
+                selfClosing = true;
+                break;
+            }
+            if (svg[index] === '>') {
+                index += 1;
+                break;
+            }
+            const name = match(ATTRIBUTE_NAME);
+            if (name === '') {
+                problems.push(`<${element}> is not terminated`);
+                return problems;
+            }
+            match(WHITESPACE);
+            if (svg[index] !== '=') {
+                problems.push(`${name} on <${element}> has no value`);
+                return problems;
+            }
+            index += 1;
+            match(WHITESPACE);
+            const quote = svg[index];
+            if (quote !== '"' && quote !== "'") {
+                problems.push(`${name} on <${element}> is unquoted`);
+                return problems;
+            }
+            const close = svg.indexOf(quote, index + 1);
+            if (close === -1) {
+                problems.push(`${name} on <${element}> is unterminated`);
+                return problems;
+            }
+            const value = svg.slice(index + 1, close);
+            index = close + 1;
+            if (value.includes('<')) {
+                problems.push(`${name} on <${element}> contains "<"`);
+                return problems;
+            }
+            if (attributes.has(name)) {
+                problems.push(`<${element}> repeats ${name}`);
+                return problems;
+            }
+            attributes.set(name, value);
+        }
+        checkAttributes(element, attributes);
+        if (open.length === 0 && !attributes.has('viewBox')) {
+            problems.push('<svg> has no viewBox="0 0 16 16"');
+        }
+        if (!selfClosing) {
+            open.push(element);
+        }
+        else if (open.length === 0) {
+            problems.push('<svg> is empty');
+        }
+    }
+    if (roots === 0) {
+        problems.push('has no <svg> root');
+    }
+    for (const element of open.reverse()) {
+        problems.push(`<${element}> is not closed`);
+    }
+    return problems;
+};
+/**
+ * Fails when any icon in `pack` breaks the rules a host relies on to inline it: a single `<svg viewBox="0 0 16 16">` root, allowlisted shape elements and geometry or paint attributes, and paint limited to `none`, `currentColor`, or `var(--isomer-icon-*)` with an optional `currentColor` or hex fallback.
+ *
+ * @example
+ * ```ts
+ * assertPackIconsValid(slidesPack);
+ * ```
+ */
+export const assertPackIconsValid = ({ icons, primitives, }) => {
+    const byType = icons ?? iconsByType(primitives);
+    const problems = Object.keys(byType).flatMap((type) => iconProblems(byType[type].svg).map((problem) => `${type} icon: ${problem}`));
+    if (problems.length > 0) {
+        throw new Error(`Pack icons break the icon rules:\n${problems.map((line) => `- ${line}`).join('\n')}`);
+    }
+};
+//# sourceMappingURL=icon.js.map

package/dist/testing/icon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon.js","sourceRoot":"","sources":["../../src/testing/icon.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// Hosts insert an icon's `svg` as markup, so every rule here is an allowlist.\n\nimport { iconsByType, type PrimitivePack } from '../pack/primitive_pack';\n\n// HTML's markup whitespace, never `\\s`: a parser reads NBSP and other Unicode separators as part of a name or as text.\nconst NUMBER = /^[-+0-9.eE,\\t\\n\\f\\r ]*$/;\nconst PATH_DATA = /^[-+0-9.eE,\\t\\n\\f\\r MmLlHhVvCcSsQqTtAaZz]*$/;\nconst TRANSFORM =\n  /^(?:[\\t\\n\\f\\r ]*(?:matrix|translate|scale|rotate|skewX|skewY)[\\t\\n\\f\\r ]*\\([-+0-9.eE,\\t\\n\\f\\r ]*\\)[\\t\\n\\f\\r ]*,?)*[\\t\\n\\f\\r ]*$/;\nconst PAINT =\n  /^(?:none|currentColor|var\\(--isomer-icon-(?:accent|bg|fg|muted)(?:[\\t\\n\\f\\r ]*,[\\t\\n\\f\\r ]*(?:currentColor|#[0-9a-fA-F]{3}|#[0-9a-fA-F]{6}))?\\))$/;\nconst PAINT_RULE = 'is not none, currentColor, or var(--isomer-icon-*)';\n\nconst NAME = /[A-Za-z][\\w:.-]*/y;\nconst ATTRIBUTE_NAME = /[^\\t\\n\\f\\r \"'<>/=]+/y;\nconst WHITESPACE = /[\\t\\n\\f\\r ]*/y;\nconst BLANK = /^[\\t\\n\\f\\r ]*$/;\nconst NAME_END = /[\\t\\n\\f\\r />]/;\n\nconst trimMarkup = (text: string): string =>\n  text.replace(/^[\\t\\n\\f\\r ]+|[\\t\\n\\f\\r ]+$/g, '');\n\nconst isNumber = (value: string): boolean => NUMBER.test(value);\n\nconst keyword =\n  (...words: string[]) =>\n  (value: string): boolean =>\n    words.includes(value);\n\nconst ATTRIBUTE_RULES: ReadonlyMap<string, (value: string) => boolean> =\n  new Map([\n    ['clip-rule', keyword('nonzero', 'evenodd')],\n    ['cx', isNumber],\n    ['cy', isNumber],\n    ['d', (value) => PATH_DATA.test(value)],\n    ['fill', (value) => PAINT.test(value)],\n    ['fill-opacity', isNumber],\n    ['fill-rule', keyword('nonzero', 'evenodd')],\n    ['height', isNumber],\n    ['opacity', isNumber],\n    ['points', isNumber],\n    ['r', isNumber],\n    ['rx', isNumber],\n    ['ry', isNumber],\n    ['stroke', (value) => PAINT.test(value)],\n    ['stroke-linecap', keyword('butt', 'round', 'square')],\n    ['stroke-linejoin', keyword('miter', 'round', 'bevel')],\n    ['stroke-opacity', isNumber],\n    ['stroke-width', isNumber],\n    ['transform', (value) => TRANSFORM.test(value)],\n    ['viewBox', keyword('0 0 16 16')],\n    ['width', isNumber],\n    ['x', isNumber],\n    ['x1', isNumber],\n    ['x2', isNumber],\n    ['xmlns', keyword('http://www.w3.org/2000/svg')],\n    ['y', isNumber],\n    ['y1', isNumber],\n    ['y2', isNumber],\n  ]);\n\nconst PRESENTATION = [\n  'clip-rule',\n  'fill',\n  'fill-opacity',\n  'fill-rule',\n  'opacity',\n  'stroke',\n  'stroke-linecap',\n  'stroke-linejoin',\n  'stroke-opacity',\n  'stroke-width',\n  'transform',\n];\n\nconst ELEMENT_ATTRIBUTES: ReadonlyMap<string, ReadonlySet<string>> = new Map([\n  ['svg', new Set(['viewBox', 'xmlns', ...PRESENTATION])],\n  ['g', new Set(PRESENTATION)],\n  ['path', new Set(['d', ...PRESENTATION])],\n  ['rect', new Set(['x', 'y', 'width', 'height', 'rx', 'ry', ...PRESENTATION])],\n  ['circle', new Set(['cx', 'cy', 'r', ...PRESENTATION])],\n  ['ellipse', new Set(['cx', 'cy', 'rx', 'ry', ...PRESENTATION])],\n  ['line', new Set(['x1', 'y1', 'x2', 'y2', ...PRESENTATION])],\n  ['polyline', new Set(['points', ...PRESENTATION])],\n  ['polygon', new Set(['points', ...PRESENTATION])],\n]);\n\n/** Every way `svg` breaks the icon rules, as one line each; empty when it passes. */\nconst iconProblems = (svg: string): string[] => {\n  const problems: string[] = [];\n  const open: string[] = [];\n  let roots = 0;\n  let index = 0;\n\n  const match = (pattern: RegExp): string => {\n    pattern.lastIndex = index;\n    const found = pattern.exec(svg)?.[0] ?? '';\n    index += found.length;\n    return found;\n  };\n\n  const checkAttributes = (\n    element: string,\n    attributes: ReadonlyMap<string, string>\n  ): void => {\n    const allowed = ELEMENT_ATTRIBUTES.get(element);\n    if (!allowed) {\n      problems.push(`<${element}> is not an allowed element`);\n      return;\n    }\n    for (const [name, value] of attributes) {\n      if (!allowed.has(name)) {\n        problems.push(`${name} is not an allowed attribute on <${element}>`);\n      } else if (value.includes('&')) {\n        problems.push(`${name}=\"${value}\" contains an entity`);\n      } else if (!ATTRIBUTE_RULES.get(name)!(value)) {\n        problems.push(\n          name === 'fill' || name === 'stroke'\n            ? `${name}=\"${value}\" ${PAINT_RULE}`\n            : `${name}=\"${value}\" is not an allowed value`\n        );\n      }\n    }\n  };\n\n  while (index < svg.length) {\n    if (svg[index] !== '<') {\n      const end = svg.indexOf('<', index);\n      const text = svg.slice(index, end === -1 ? undefined : end);\n      if (!BLANK.test(text)) {\n        problems.push(\n          open.length > 0\n            ? `text content \"${trimMarkup(text)}\" is not allowed`\n            : `unexpected \"${trimMarkup(text)}\" outside <svg>`\n        );\n        return problems;\n      }\n      index += text.length;\n      continue;\n    }\n\n    if (svg.startsWith('<!', index) || svg.startsWith('<?', index)) {\n      problems.push('comments, declarations, and CDATA are not allowed');\n      return problems;\n    }\n\n    if (svg.startsWith('</', index)) {\n      index += 2;\n      const name = match(NAME);\n      match(WHITESPACE);\n      if (name === '' || svg[index] !== '>') {\n        problems.push('malformed closing tag');\n        return problems;\n      }\n      index += 1;\n      const expected = open.pop();\n      if (expected === undefined) {\n        problems.push(`</${name}> closes nothing`);\n        return problems;\n      }\n      if (expected !== name) {\n        problems.push(`</${name}> does not close <${expected}>`);\n        return problems;\n      }\n      continue;\n    }\n\n    index += 1;\n    const element = match(NAME);\n    if (element === '' || !NAME_END.test(svg[index] ?? '>')) {\n      problems.push('malformed opening tag');\n      return problems;\n    }\n    if (open.length === 0) {\n      roots += 1;\n      if (roots > 1) {\n        problems.push('more than one root element');\n        return problems;\n      }\n      if (element !== 'svg') {\n        problems.push(`root is <${element}>, not <svg>`);\n        return problems;\n      }\n    }\n\n    const attributes = new Map<string, string>();\n    let selfClosing = false;\n    for (;;) {\n      match(WHITESPACE);\n      if (svg.startsWith('/>', index)) {\n        index += 2;\n        selfClosing = true;\n        break;\n      }\n      if (svg[index] === '>') {\n        index += 1;\n        break;\n      }\n      const name = match(ATTRIBUTE_NAME);\n      if (name === '') {\n        problems.push(`<${element}> is not terminated`);\n        return problems;\n      }\n      match(WHITESPACE);\n      if (svg[index] !== '=') {\n        problems.push(`${name} on <${element}> has no value`);\n        return problems;\n      }\n      index += 1;\n      match(WHITESPACE);\n      const quote = svg[index];\n      if (quote !== '\"' && quote !== \"'\") {\n        problems.push(`${name} on <${element}> is unquoted`);\n        return problems;\n      }\n      const close = svg.indexOf(quote, index + 1);\n      if (close === -1) {\n        problems.push(`${name} on <${element}> is unterminated`);\n        return problems;\n      }\n      const value = svg.slice(index + 1, close);\n      index = close + 1;\n      if (value.includes('<')) {\n        problems.push(`${name} on <${element}> contains \"<\"`);\n        return problems;\n      }\n      if (attributes.has(name)) {\n        problems.push(`<${element}> repeats ${name}`);\n        return problems;\n      }\n      attributes.set(name, value);\n    }\n\n    checkAttributes(element, attributes);\n    if (open.length === 0 && !attributes.has('viewBox')) {\n      problems.push('<svg> has no viewBox=\"0 0 16 16\"');\n    }\n    if (!selfClosing) {\n      open.push(element);\n    } else if (open.length === 0) {\n      problems.push('<svg> is empty');\n    }\n  }\n\n  if (roots === 0) {\n    problems.push('has no <svg> root');\n  }\n  for (const element of open.reverse()) {\n    problems.push(`<${element}> is not closed`);\n  }\n  return problems;\n};\n\n/**\n * Fails when any icon in `pack` breaks the rules a host relies on to inline it: a single `<svg viewBox=\"0 0 16 16\">` root, allowlisted shape elements and geometry or paint attributes, and paint limited to `none`, `currentColor`, or `var(--isomer-icon-*)` with an optional `currentColor` or hex fallback.\n *\n * @example\n * ```ts\n * assertPackIconsValid(slidesPack);\n * ```\n */\nexport const assertPackIconsValid = ({\n  icons,\n  primitives,\n}: Pick<PrimitivePack, 'icons' | 'primitives'>): void => {\n  const byType = icons ?? iconsByType(primitives);\n  const problems = Object.keys(byType).flatMap((type) =>\n    iconProblems(byType[type]!.svg).map((problem) => `${type} icon: ${problem}`)\n  );\n  if (problems.length > 0) {\n    throw new Error(\n      `Pack icons break the icon rules:\\n${problems.map((line) => `- ${line}`).join('\\n')}`\n    );\n  }\n};\n"]}

package/dist/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { type PrimitiveConformanceCase, type PrimitiveConformanceExample, type PrimitiveConformanceHarness, type PrimitiveConformanceHtmlOptions, type PrimitiveConformanceSlackResult, type PrimitiveConformanceSnapshotResult, CONFORMANCE_FOREIGN_MARKER, primitiveConformanceRows, runPrimitiveInventoryConformance, } from './conformance.js';
+export { assertPackIconsValid } from './icon.js';
+export { type PackRegistrationOptions, assertPackRegistrationComplete, } from './registration.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,+BAA+B,EACpC,KAAK,+BAA+B,EACpC,KAAK,kCAAkC,EACvC,0BAA0B,EAC1B,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,KAAK,uBAAuB,EAC5B,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,10 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export { CONFORMANCE_FOREIGN_MARKER, primitiveConformanceRows, runPrimitiveInventoryConformance, } from './conformance.js';
+export { assertPackIconsValid } from './icon.js';
+export { assertPackRegistrationComplete, } from './registration.js';
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAOL,0BAA0B,EAC1B,wBAAwB,EACxB,gCAAgC,GACjC,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAEL,8BAA8B,GAC/B,MAAM,gBAAgB,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  type PrimitiveConformanceCase,\n  type PrimitiveConformanceExample,\n  type PrimitiveConformanceHarness,\n  type PrimitiveConformanceHtmlOptions,\n  type PrimitiveConformanceSlackResult,\n  type PrimitiveConformanceSnapshotResult,\n  CONFORMANCE_FOREIGN_MARKER,\n  primitiveConformanceRows,\n  runPrimitiveInventoryConformance,\n} from './conformance';\nexport { assertPackIconsValid } from './icon';\nexport {\n  type PackRegistrationOptions,\n  assertPackRegistrationComplete,\n} from './registration';\n"]}

package/dist/testing/registration.d.ts

@@ -0,0 +1,32 @@
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+/** What {@link assertPackRegistrationComplete} needs to compare a pack against its directory. */
+export interface PackRegistrationOptions {
+    /** Directory whose subdirectories are one primitive each. A relative path resolves against the working directory; a `URL` is resolved with `fileURLToPath`. */
+    primitivesDir: URL | string;
+    /** The pack's registry array, as passed to `definePrimitivePack`. */
+    registered: readonly AnyPrimitiveDefinition[];
+    /** Subdirectory names that hold no primitive. */
+    ignore?: readonly string[];
+}
+/**
+ * Fails when the primitives directory and the pack's registry disagree: a
+ * subdirectory with no entry file or no exported definition, a defined type
+ * nothing registers, or a registered type no directory defines. Each problem
+ * line carries its fix.
+ *
+ * A pack keeps two hand-written lists, the registry array and the body-node
+ * union, and nothing in the type system relates either to the directory they
+ * describe. A primitive absent from both lists leaves them agreeing with each
+ * other, so it compiles and every other test passes while the primitive is
+ * unreachable. This is the check that notices.
+ *
+ * @example
+ * ```ts
+ * await assertPackRegistrationComplete({
+ *   primitivesDir: new URL('./primitives/', import.meta.url),
+ *   registered: slideDeckPrimitives,
+ * });
+ * ```
+ */
+export declare const assertPackRegistrationComplete: ({ primitivesDir, registered, ignore, }: PackRegistrationOptions) => Promise<void>;
+//# sourceMappingURL=registration.d.ts.map

package/dist/testing/registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.d.ts","sourceRoot":"","sources":["../../src/testing/registration.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,iGAAiG;AACjG,MAAM,WAAW,uBAAuB;IACtC,+JAA+J;IAC/J,aAAa,EAAE,GAAG,GAAG,MAAM,CAAC;IAC5B,qEAAqE;IACrE,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC9C,iDAAiD;IACjD,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B;AAiDD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,8BAA8B,GAAU,wCAIlD,uBAAuB,KAAG,OAAO,CAAC,IAAI,CAyDxC,CAAC"}

package/dist/testing/registration.js

@@ -0,0 +1,105 @@
+/*
+ * 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.
+ */
+// Node-only, and reached only through the `./testing` entry: this reads the
+// filesystem, which no rendering path may do.
+import { readdirSync, statSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+const ENTRY_FILES = ['index.tsx', 'index.ts'];
+/** Duck-typed so a definition from a different copy of the sdk still matches. */
+const isPrimitiveDefinition = (value) => {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const { type, catalog, schema, renderers } = value;
+    return (typeof type === 'string' &&
+        typeof catalog === 'object' &&
+        catalog !== null &&
+        typeof schema === 'object' &&
+        schema !== null &&
+        typeof renderers === 'object' &&
+        renderers !== null);
+};
+const entryFileIn = (dir) => {
+    for (const name of ENTRY_FILES) {
+        const candidate = join(dir, name);
+        try {
+            if (statSync(candidate).isFile()) {
+                return candidate;
+            }
+        }
+        catch {
+            // Not this name; try the next.
+        }
+    }
+    return undefined;
+};
+// The CommonJS build compiles `import()` to `require()`, which rejects `file:` URLs.
+const loadEntry = async (entry) => (await import(typeof require === 'function' ? entry : pathToFileURL(entry).href));
+const subdirectoriesOf = (root, ignore) => readdirSync(root, { withFileTypes: true })
+    .filter((entry) => entry.isDirectory() && !ignore.includes(entry.name))
+    .map((entry) => entry.name)
+    .sort();
+/**
+ * Fails when the primitives directory and the pack's registry disagree: a
+ * subdirectory with no entry file or no exported definition, a defined type
+ * nothing registers, or a registered type no directory defines. Each problem
+ * line carries its fix.
+ *
+ * A pack keeps two hand-written lists, the registry array and the body-node
+ * union, and nothing in the type system relates either to the directory they
+ * describe. A primitive absent from both lists leaves them agreeing with each
+ * other, so it compiles and every other test passes while the primitive is
+ * unreachable. This is the check that notices.
+ *
+ * @example
+ * ```ts
+ * await assertPackRegistrationComplete({
+ *   primitivesDir: new URL('./primitives/', import.meta.url),
+ *   registered: slideDeckPrimitives,
+ * });
+ * ```
+ */
+export const assertPackRegistrationComplete = async ({ primitivesDir, registered, ignore = [], }) => {
+    const root = resolve(typeof primitivesDir === 'string'
+        ? primitivesDir
+        : fileURLToPath(primitivesDir));
+    const registeredTypes = new Set(registered.map(({ type }) => type));
+    const problems = [];
+    const foundTypes = new Set();
+    for (const folder of subdirectoriesOf(root, ignore)) {
+        const entry = entryFileIn(join(root, folder));
+        if (!entry) {
+            problems.push(`${folder}/ has no ${ENTRY_FILES.join(' or ')}; add one or pass it in \`ignore\`.`);
+            continue;
+        }
+        const module = await loadEntry(entry);
+        const exported = Object.entries(module).filter(([, value]) => isPrimitiveDefinition(value));
+        if (exported.length === 0) {
+            problems.push(`${folder}/ exports no primitive definition; add one or pass it in \`ignore\`.`);
+            continue;
+        }
+        for (const [exportName, definition] of exported) {
+            foundTypes.add(definition.type);
+            if (registeredTypes.has(definition.type)) {
+                continue;
+            }
+            problems.push(`${folder}/ defines "${definition.type}" but nothing registers it.\n` +
+                `  Import \`${exportName}\` from './${folder}' and add it to the registry array,\n` +
+                `  then add its node type to the pack's body-node union.`);
+        }
+    }
+    for (const { type } of registered) {
+        if (!foundTypes.has(type)) {
+            problems.push(`"${type}" is registered but no directory under ${root} defines it.`);
+        }
+    }
+    if (problems.length > 0) {
+        throw new Error(`Pack registration is incomplete:\n${problems.map((line) => `- ${line}`).join('\n')}`);
+    }
+};
+//# sourceMappingURL=registration.js.map

package/dist/testing/registration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registration.js","sourceRoot":"","sources":["../../src/testing/registration.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// Node-only, and reached only through the `./testing` entry: this reads the\n// filesystem, which no rendering path may do.\n\nimport { readdirSync, statSync } from 'node:fs';\nimport { join, resolve } from 'node:path';\nimport { fileURLToPath, pathToFileURL } from 'node:url';\n\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\n/** What {@link assertPackRegistrationComplete} needs to compare a pack against its directory. */\nexport interface PackRegistrationOptions {\n  /** Directory whose subdirectories are one primitive each. A relative path resolves against the working directory; a `URL` is resolved with `fileURLToPath`. */\n  primitivesDir: URL | string;\n  /** The pack's registry array, as passed to `definePrimitivePack`. */\n  registered: readonly AnyPrimitiveDefinition[];\n  /** Subdirectory names that hold no primitive. */\n  ignore?: readonly string[];\n}\n\nconst ENTRY_FILES = ['index.tsx', 'index.ts'] as const;\n\n/** Duck-typed so a definition from a different copy of the sdk still matches. */\nconst isPrimitiveDefinition = (\n  value: unknown\n): value is AnyPrimitiveDefinition => {\n  if (typeof value !== 'object' || value === null) {\n    return false;\n  }\n  const { type, catalog, schema, renderers } = value as Record<string, unknown>;\n  return (\n    typeof type === 'string' &&\n    typeof catalog === 'object' &&\n    catalog !== null &&\n    typeof schema === 'object' &&\n    schema !== null &&\n    typeof renderers === 'object' &&\n    renderers !== null\n  );\n};\n\nconst entryFileIn = (dir: string): string | undefined => {\n  for (const name of ENTRY_FILES) {\n    const candidate = join(dir, name);\n    try {\n      if (statSync(candidate).isFile()) {\n        return candidate;\n      }\n    } catch {\n      // Not this name; try the next.\n    }\n  }\n  return undefined;\n};\n\n// The CommonJS build compiles `import()` to `require()`, which rejects `file:` URLs.\nconst loadEntry = async (entry: string): Promise<Record<string, unknown>> =>\n  (await import(\n    typeof require === 'function' ? entry : pathToFileURL(entry).href\n  )) as Record<string, unknown>;\n\nconst subdirectoriesOf = (root: string, ignore: readonly string[]): string[] =>\n  readdirSync(root, { withFileTypes: true })\n    .filter((entry) => entry.isDirectory() && !ignore.includes(entry.name))\n    .map((entry) => entry.name)\n    .sort();\n\n/**\n * Fails when the primitives directory and the pack's registry disagree: a\n * subdirectory with no entry file or no exported definition, a defined type\n * nothing registers, or a registered type no directory defines. Each problem\n * line carries its fix.\n *\n * A pack keeps two hand-written lists, the registry array and the body-node\n * union, and nothing in the type system relates either to the directory they\n * describe. A primitive absent from both lists leaves them agreeing with each\n * other, so it compiles and every other test passes while the primitive is\n * unreachable. This is the check that notices.\n *\n * @example\n * ```ts\n * await assertPackRegistrationComplete({\n *   primitivesDir: new URL('./primitives/', import.meta.url),\n *   registered: slideDeckPrimitives,\n * });\n * ```\n */\nexport const assertPackRegistrationComplete = async ({\n  primitivesDir,\n  registered,\n  ignore = [],\n}: PackRegistrationOptions): Promise<void> => {\n  const root = resolve(\n    typeof primitivesDir === 'string'\n      ? primitivesDir\n      : fileURLToPath(primitivesDir)\n  );\n  const registeredTypes = new Set(registered.map(({ type }) => type));\n  const problems: string[] = [];\n  const foundTypes = new Set<string>();\n\n  for (const folder of subdirectoriesOf(root, ignore)) {\n    const entry = entryFileIn(join(root, folder));\n    if (!entry) {\n      problems.push(\n        `${folder}/ has no ${ENTRY_FILES.join(' or ')}; add one or pass it in \\`ignore\\`.`\n      );\n      continue;\n    }\n\n    const module = await loadEntry(entry);\n    const exported = Object.entries(module).filter(([, value]) =>\n      isPrimitiveDefinition(value)\n    ) as Array<[string, AnyPrimitiveDefinition]>;\n\n    if (exported.length === 0) {\n      problems.push(\n        `${folder}/ exports no primitive definition; add one or pass it in \\`ignore\\`.`\n      );\n      continue;\n    }\n\n    for (const [exportName, definition] of exported) {\n      foundTypes.add(definition.type);\n      if (registeredTypes.has(definition.type)) {\n        continue;\n      }\n      problems.push(\n        `${folder}/ defines \"${definition.type}\" but nothing registers it.\\n` +\n          `  Import \\`${exportName}\\` from './${folder}' and add it to the registry array,\\n` +\n          `  then add its node type to the pack's body-node union.`\n      );\n    }\n  }\n\n  for (const { type } of registered) {\n    if (!foundTypes.has(type)) {\n      problems.push(\n        `\"${type}\" is registered but no directory under ${root} defines it.`\n      );\n    }\n  }\n\n  if (problems.length > 0) {\n    throw new Error(\n      `Pack registration is incomplete:\\n${problems.map((line) => `- ${line}`).join('\\n')}`\n    );\n  }\n};\n"]}

package/dist/validate/authoring_schema.d.ts

@@ -0,0 +1,33 @@
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+import { type CompositionJsonSchemaOptions } from './json_schema.js';
+type JsonSchema = Record<string, unknown>;
+/** Options for {@link buildAuthoringJsonSchema}. */
+export interface AuthoringJsonSchemaOptions extends CompositionJsonSchemaOptions {
+    /** `$def` id to `description`. Survives `z.toJSONSchema` dropping `.refine` text. */
+    describe?: Readonly<Record<string, string>>;
+    /** `$defId.property` paths to drop, e.g. `'kpi.delta'`. */
+    omitProperties?: readonly string[];
+}
+/**
+ * Projects a composition to the JSON Schema an agent reads.
+ *
+ * {@link buildCompositionJsonSchema} stays the validator projection. This walk
+ * names shared SDK defs, inlines scalar leaves, and drops host-only fields.
+ */
+export declare const buildAuthoringJsonSchema: (definitions: readonly AnyPrimitiveDefinition[], options?: AuthoringJsonSchemaOptions) => JsonSchema;
+/**
+ * The `$defs` that `types` reach in a schema from {@link buildAuthoringJsonSchema},
+ * keyed as `schema` keys them, with the body-node union stubbed so a container
+ * does not pull in every primitive.
+ */
+export declare const authoringSchemaSubset: (schema: JsonSchema, types: readonly string[]) => {
+    $defs: Record<string, unknown>;
+};
+/**
+ * The `body` of a schema from {@link buildAuthoringJsonSchema} as a schema of
+ * its own, for an editor that validates body nodes rather than a whole
+ * composition. Carries the `$defs` the body reaches.
+ */
+export declare const authoringBodySchema: (schema: JsonSchema) => JsonSchema;
+export {};
+//# sourceMappingURL=authoring_schema.d.ts.map

package/dist/validate/authoring_schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_schema.d.ts","sourceRoot":"","sources":["../../src/validate/authoring_schema.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEzE,OAAO,EAEL,KAAK,4BAA4B,EAClC,MAAM,eAAe,CAAC;AAQvB,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAc1C,oDAAoD;AACpD,MAAM,WAAW,0BAA2B,SAAQ,4BAA4B;IAC9E,qFAAqF;IACrF,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5C,2DAA2D;IAC3D,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC;AA6RD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,SAAS,sBAAsB,EAAE,EAC9C,UAAS,0BAA+B,KACvC,UAUF,CAAC;AAOF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,OAAO,SAAS,MAAM,EAAE,KACvB;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAwBlC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,QAAQ,UAAU,KAAG,UASxD,CAAC"}