@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/validate/validation.d.ts

@@ -0,0 +1,95 @@
+import { type SurfaceName } from '../composition/body_node_base.js';
+import type { Composition } from '../composition/composition.js';
+import type { PrimitiveNode } from '../composition/node.js';
+import { CompositionValidationError, type ValidationError } from '../composition/validation_error.js';
+import type { AnyPrimitiveDefinition } from '../define/primitive_module.js';
+import { type InputBudget } from './input_budget.js';
+/**
+ * A non-fatal validation finding, scoped to the surface it concerns.
+ *
+ * Warnings carry `surface` because every one of them is a statement about one
+ * render target — a composition that draws nothing on `slack` is not news to a
+ * caller rendering HTML. Without the scope a host receives every surface's
+ * findings on every call and learns to ignore the channel.
+ * {@link warningsForSurface} is the filter.
+ */
+export interface ValidationWarning {
+    /** The render target this finding concerns, never the composition as a whole. */
+    surface: SurfaceName;
+    /**
+     * Path of the offending node within the composition, absent for
+     * whole-composition findings.
+     */
+    path?: string;
+    /** Safe to show a user, and phrased for whoever can act on it. */
+    message: string;
+}
+/**
+ * The outcome of `validate`: errors are fatal, warnings are advisory.
+ *
+ * `valid` tracks `errors` only — a composition can be valid and still carry
+ * warnings, which is the normal case for a surface gap.
+ */
+export interface ValidationResult {
+    /** True when `errors` is empty, regardless of `warnings`. */
+    valid: boolean;
+    /** Fatal findings. Empty when `valid`. */
+    errors: ValidationError[];
+    /** Advisory findings, empty when there are none. */
+    warnings: ValidationWarning[];
+}
+declare const checkedComposition: unique symbol;
+/** The copy {@link createCompositionValidator} checked, which a validating render draws in place of the caller's value. The brand is type-only. */
+export type CheckedComposition<TNode extends PrimitiveNode = PrimitiveNode> = Composition<TNode> & {
+    readonly [checkedComposition]: true;
+};
+/** A {@link ValidationResult} with the composition it describes. */
+export interface CheckedValidationResult<TNode extends PrimitiveNode = PrimitiveNode> extends ValidationResult {
+    /** Undefined only when {@link checkInputBudget} refused the input. */
+    composition: CheckedComposition<TNode> | undefined;
+}
+/** Narrows a result's warnings to the surface a caller is about to render. */
+export declare const warningsForSurface: (result: ValidationResult, surface: SurfaceName) => ValidationWarning[];
+/** Whether a render reports validation findings or raises on them. */
+export type ValidationErrorMode = 'collect' | 'throw';
+export { CompositionValidationError };
+/** Raises {@link CompositionValidationError} when `mode` is `throw` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input, which nothing can render. */
+export declare const enforceValidationMode: (result: ValidationResult, mode?: ValidationErrorMode) => void;
+/** The composition `result` checked, which is what a render draws. Throws {@link CompositionValidationError} when `mode` is `'throw'` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input. */
+export declare const compositionToRender: <TNode extends PrimitiveNode>(result: CheckedValidationResult<TNode>, mode?: ValidationErrorMode) => CheckedComposition<TNode>;
+/** Options for {@link createCompositionValidator}. */
+export interface CompositionValidatorOptions {
+    /** Limits checked before the schema runs; see {@link checkInputBudget}. */
+    inputBudget?: InputBudget;
+}
+/**
+ * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.
+ *
+ * `definitions` is memoized on array identity, so a caller that rebuilds the
+ * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a
+ * fresh discriminated union each time. Hold the array `composePacks` returns
+ * and reuse it across the validator, the parser, and the authoring context.
+ */
+export declare const createCompositionValidator: <TNode extends PrimitiveNode = PrimitiveNode>(definitions: readonly AnyPrimitiveDefinition[], options?: CompositionValidatorOptions) => ((composition: Composition<TNode>) => CheckedValidationResult<TNode>);
+/** The outcome of `parse`. */
+export interface ParsedComposition {
+    /** True when the value matched the schema. Says nothing about id uniqueness. */
+    valid: boolean;
+    /** Schema failures. Empty when `valid`. */
+    errors: ValidationError[];
+    /** The parsed document, present only when `valid`. */
+    composition?: Composition;
+}
+/**
+ * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.
+ *
+ * Deliberately narrower than {@link createCompositionValidator}. This answers
+ * "is this a `Composition`", not "is this a good one" — it does not run the
+ * duplicate-id pass or produce warnings, so a composition with two nodes
+ * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so
+ * a caller that wants the semantic checks runs `validate` on the result.
+ *
+ * Shares {@link createCompositionValidator}'s memoization identity requirement.
+ */
+export declare const createCompositionParser: (definitions: readonly AnyPrimitiveDefinition[], { inputBudget }?: Pick<CompositionValidatorOptions, "inputBudget">) => ((value: unknown) => ParsedComposition);
+//# sourceMappingURL=validation.d.ts.map

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

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

package/dist/validate/validation.js

@@ -0,0 +1,157 @@
+/*
+ * 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 { childNodePath, createChildNodeWalker, rendersOnSurface, SURFACE_NAMES, } from '../composition/body_node_base.js';
+import { quoteText } from '../composition/one_line.js';
+import { CompositionValidationError, } from '../composition/validation_error.js';
+import { getCompositionSchemaForDefinitions } from './composition_schema.js';
+import { checkInputBudget, isInputRefusal, } from './input_budget.js';
+import { createNodeIssueFormatter } from './node_issues.js';
+const checkedComposition = Symbol.for('elastic.isomer.checked_composition');
+/** Narrows a result's warnings to the surface a caller is about to render. */
+export const warningsForSurface = (result, surface) => result.warnings.filter((warning) => warning.surface === surface);
+export { CompositionValidationError };
+/** Raises {@link CompositionValidationError} when `mode` is `throw` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input, which nothing can render. */
+export const enforceValidationMode = (result, mode) => {
+    if (!result.valid &&
+        (mode === 'throw' || result.errors.some(isInputRefusal))) {
+        throw new CompositionValidationError(result.errors);
+    }
+};
+/** The composition `result` checked, which is what a render draws. Throws {@link CompositionValidationError} when `mode` is `'throw'` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input. */
+export const compositionToRender = (result, mode) => {
+    enforceValidationMode(result, mode);
+    const { composition } = result;
+    if (composition === undefined) {
+        throw new CompositionValidationError(result.errors);
+    }
+    return composition;
+};
+/** The body's nodes, as {@link IssueRoot}s for a node issue formatter. */
+const bodyRoots = (value) => {
+    const { body } = (value ?? {});
+    return Array.isArray(body)
+        ? body.map((node, index) => [node, `body[${index}]`])
+        : [];
+};
+/**
+ * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.
+ *
+ * `definitions` is memoized on array identity, so a caller that rebuilds the
+ * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a
+ * fresh discriminated union each time. Hold the array `composePacks` returns
+ * and reuse it across the validator, the parser, and the authoring context.
+ */
+export const createCompositionValidator = (definitions, options = {}) => {
+    const schema = getCompositionSchemaForDefinitions(definitions);
+    const walk = createChildNodeWalker(definitions);
+    const formatIssues = createNodeIssueFormatter(definitions);
+    return (composition) => {
+        const checked = checkInputBudget(composition, options.inputBudget);
+        if (!checked.valid) {
+            return {
+                valid: false,
+                errors: [checked.error],
+                warnings: [],
+                composition: undefined,
+            };
+        }
+        const plain = checked.value;
+        const result = schema.safeParse(plain, { reportInput: true });
+        if (result.success) {
+            const { body } = plain;
+            const idErrors = collectDuplicateNodeIdErrors(body, walk);
+            const warnings = collectEmptySurfaceWarnings(body, walk);
+            return {
+                valid: idErrors.length === 0,
+                errors: idErrors,
+                warnings,
+                composition: plain,
+            };
+        }
+        return {
+            valid: false,
+            errors: formatIssues(bodyRoots(plain), result.error.issues),
+            warnings: [],
+            composition: plain,
+        };
+    };
+};
+/**
+ * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.
+ *
+ * Deliberately narrower than {@link createCompositionValidator}. This answers
+ * "is this a `Composition`", not "is this a good one" — it does not run the
+ * duplicate-id pass or produce warnings, so a composition with two nodes
+ * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so
+ * a caller that wants the semantic checks runs `validate` on the result.
+ *
+ * Shares {@link createCompositionValidator}'s memoization identity requirement.
+ */
+export const createCompositionParser = (definitions, { inputBudget } = {}) => {
+    const schema = getCompositionSchemaForDefinitions(definitions);
+    const formatIssues = createNodeIssueFormatter(definitions);
+    return (value) => {
+        const checked = checkInputBudget(value, inputBudget);
+        if (!checked.valid) {
+            return { valid: false, errors: [checked.error] };
+        }
+        const result = schema.safeParse(checked.value, { reportInput: true });
+        if (result.success) {
+            return {
+                valid: true,
+                errors: [],
+                composition: result.data,
+            };
+        }
+        return {
+            valid: false,
+            errors: formatIssues(bodyRoots(checked.value), result.error.issues),
+        };
+    };
+};
+/** Warns once per surface that the whole body renders nothing on. */
+const collectEmptySurfaceWarnings = (body, walk) => SURFACE_NAMES.filter((surface) => !body.some((node) => rendersOnSurface(node, surface, walk))).map((surface) => ({
+    surface,
+    message: `composition renders no nodes on surface "${surface}"`,
+}));
+/**
+ * Errors for each node whose `id` repeats one already seen, naming the first
+ * use.
+ *
+ * Errors rather than warnings, because ids are what a host addresses a node by.
+ * Run by `validate` and deliberately not by `parse`; see
+ * {@link createCompositionParser}.
+ */
+const collectDuplicateNodeIdErrors = (body, walk) => {
+    const errors = [];
+    const seen = new Map();
+    const visit = (node, path) => {
+        if (!node || typeof node !== 'object') {
+            return;
+        }
+        const { id, type } = node;
+        if (typeof id === 'string') {
+            const first = seen.get(id);
+            if (first) {
+                errors.push({
+                    path: `${path}.id`,
+                    message: `duplicates id ${quoteText(id)} first used at ${first}`,
+                    ...(typeof type === 'string' ? { nodeType: type } : {}),
+                });
+            }
+            else {
+                seen.set(id, path);
+            }
+        }
+        walk(node).forEach(({ node: child, path: field }) => {
+            visit(child, childNodePath(path, field));
+        });
+    };
+    body.forEach((node, index) => visit(node, `body[${index}]`));
+    return errors;
+};
+//# sourceMappingURL=validation.js.map

package/dist/validate/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validate/validation.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport {\n  childNodePath,\n  createChildNodeWalker,\n  rendersOnSurface,\n  SURFACE_NAMES,\n  type SurfaceName,\n} from '../composition/body_node_base';\nimport type { Composition } from '../composition/composition';\nimport type { PrimitiveNode } from '../composition/node';\nimport { quoteText } from '../composition/one_line';\nimport {\n  CompositionValidationError,\n  type ValidationError,\n} from '../composition/validation_error';\nimport type { AnyPrimitiveDefinition } from '../define/primitive_module';\n\nimport { getCompositionSchemaForDefinitions } from './composition_schema';\nimport {\n  checkInputBudget,\n  type InputBudget,\n  isInputRefusal,\n} from './input_budget';\nimport { createNodeIssueFormatter, type IssueRoot } from './node_issues';\n\n/**\n * A non-fatal validation finding, scoped to the surface it concerns.\n *\n * Warnings carry `surface` because every one of them is a statement about one\n * render target — a composition that draws nothing on `slack` is not news to a\n * caller rendering HTML. Without the scope a host receives every surface's\n * findings on every call and learns to ignore the channel.\n * {@link warningsForSurface} is the filter.\n */\nexport interface ValidationWarning {\n  /** The render target this finding concerns, never the composition as a whole. */\n  surface: SurfaceName;\n  /**\n   * Path of the offending node within the composition, absent for\n   * whole-composition findings.\n   */\n  path?: string;\n  /** Safe to show a user, and phrased for whoever can act on it. */\n  message: string;\n}\n\n/**\n * The outcome of `validate`: errors are fatal, warnings are advisory.\n *\n * `valid` tracks `errors` only — a composition can be valid and still carry\n * warnings, which is the normal case for a surface gap.\n */\nexport interface ValidationResult {\n  /** True when `errors` is empty, regardless of `warnings`. */\n  valid: boolean;\n  /** Fatal findings. Empty when `valid`. */\n  errors: ValidationError[];\n  /** Advisory findings, empty when there are none. */\n  warnings: ValidationWarning[];\n}\n\nconst checkedComposition = Symbol.for('elastic.isomer.checked_composition');\n\n/** The copy {@link createCompositionValidator} checked, which a validating render draws in place of the caller's value. The brand is type-only. */\nexport type CheckedComposition<TNode extends PrimitiveNode = PrimitiveNode> =\n  Composition<TNode> & { readonly [checkedComposition]: true };\n\n/** A {@link ValidationResult} with the composition it describes. */\nexport interface CheckedValidationResult<\n  TNode extends PrimitiveNode = PrimitiveNode,\n> extends ValidationResult {\n  /** Undefined only when {@link checkInputBudget} refused the input. */\n  composition: CheckedComposition<TNode> | undefined;\n}\n\n/** Narrows a result's warnings to the surface a caller is about to render. */\nexport const warningsForSurface = (\n  result: ValidationResult,\n  surface: SurfaceName\n): ValidationWarning[] =>\n  result.warnings.filter((warning) => warning.surface === surface);\n\n/** Whether a render reports validation findings or raises on them. */\nexport type ValidationErrorMode = 'collect' | 'throw';\n\nexport { CompositionValidationError };\n\n/** Raises {@link CompositionValidationError} when `mode` is `throw` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input, which nothing can render. */\nexport const enforceValidationMode = (\n  result: ValidationResult,\n  mode?: ValidationErrorMode\n): void => {\n  if (\n    !result.valid &&\n    (mode === 'throw' || result.errors.some(isInputRefusal))\n  ) {\n    throw new CompositionValidationError(result.errors);\n  }\n};\n\n/** The composition `result` checked, which is what a render draws. Throws {@link CompositionValidationError} when `mode` is `'throw'` and `result` is invalid, or in any mode when {@link checkInputBudget} refused the input. */\nexport const compositionToRender = <TNode extends PrimitiveNode>(\n  result: CheckedValidationResult<TNode>,\n  mode?: ValidationErrorMode\n): CheckedComposition<TNode> => {\n  enforceValidationMode(result, mode);\n  const { composition } = result;\n  if (composition === undefined) {\n    throw new CompositionValidationError(result.errors);\n  }\n  return composition;\n};\n\n/** Options for {@link createCompositionValidator}. */\nexport interface CompositionValidatorOptions {\n  /** Limits checked before the schema runs; see {@link checkInputBudget}. */\n  inputBudget?: InputBudget;\n}\n\n/** The body's nodes, as {@link IssueRoot}s for a node issue formatter. */\nconst bodyRoots = (value: unknown): IssueRoot[] => {\n  const { body } = (value ?? {}) as { body?: unknown };\n  return Array.isArray(body)\n    ? body.map((node, index) => [node, `body[${index}]`] as const)\n    : [];\n};\n\n/**\n * Builds the trusted-input validator: {@link checkInputBudget}, then the schema and the semantic passes on its copy, which the result carries.\n *\n * `definitions` is memoized on array identity, so a caller that rebuilds the\n * array per call (`createCompositionValidator(packs.flatMap(…))`) resolves a\n * fresh discriminated union each time. Hold the array `composePacks` returns\n * and reuse it across the validator, the parser, and the authoring context.\n */\nexport const createCompositionValidator = <\n  TNode extends PrimitiveNode = PrimitiveNode,\n>(\n  definitions: readonly AnyPrimitiveDefinition[],\n  options: CompositionValidatorOptions = {}\n): ((composition: Composition<TNode>) => CheckedValidationResult<TNode>) => {\n  const schema = getCompositionSchemaForDefinitions(definitions);\n  const walk = createChildNodeWalker(definitions);\n  const formatIssues = createNodeIssueFormatter(definitions);\n  return (composition) => {\n    const checked = checkInputBudget(composition, options.inputBudget);\n    if (!checked.valid) {\n      return {\n        valid: false,\n        errors: [checked.error],\n        warnings: [],\n        composition: undefined,\n      };\n    }\n    const plain = checked.value as CheckedComposition<TNode>;\n    const result = schema.safeParse(plain, { reportInput: true });\n    if (result.success) {\n      const { body } = plain;\n      const idErrors = collectDuplicateNodeIdErrors(body, walk);\n      const warnings = collectEmptySurfaceWarnings(body, walk);\n      return {\n        valid: idErrors.length === 0,\n        errors: idErrors,\n        warnings,\n        composition: plain,\n      };\n    }\n    return {\n      valid: false,\n      errors: formatIssues(bodyRoots(plain), result.error.issues),\n      warnings: [],\n      composition: plain,\n    };\n  };\n};\n\n/** The outcome of `parse`. */\nexport interface ParsedComposition {\n  /** True when the value matched the schema. Says nothing about id uniqueness. */\n  valid: boolean;\n  /** Schema failures. Empty when `valid`. */\n  errors: ValidationError[];\n  /** The parsed document, present only when `valid`. */\n  composition?: Composition;\n}\n\n/**\n * Builds the untrusted-input parser: {@link checkInputBudget}, then the schema only on its copy, reported rather than thrown.\n *\n * Deliberately narrower than {@link createCompositionValidator}. This answers\n * \"is this a `Composition`\", not \"is this a good one\" — it does not run the\n * duplicate-id pass or produce warnings, so a composition with two nodes\n * sharing an `id` parses as valid. Id uniqueness is a `validate` guarantee, so\n * a caller that wants the semantic checks runs `validate` on the result.\n *\n * Shares {@link createCompositionValidator}'s memoization identity requirement.\n */\nexport const createCompositionParser = (\n  definitions: readonly AnyPrimitiveDefinition[],\n  { inputBudget }: Pick<CompositionValidatorOptions, 'inputBudget'> = {}\n): ((value: unknown) => ParsedComposition) => {\n  const schema = getCompositionSchemaForDefinitions(definitions);\n  const formatIssues = createNodeIssueFormatter(definitions);\n  return (value) => {\n    const checked = checkInputBudget(value, inputBudget);\n    if (!checked.valid) {\n      return { valid: false, errors: [checked.error] };\n    }\n    const result = schema.safeParse(checked.value, { reportInput: true });\n    if (result.success) {\n      return {\n        valid: true,\n        errors: [],\n        composition: result.data as unknown as Composition,\n      };\n    }\n    return {\n      valid: false,\n      errors: formatIssues(bodyRoots(checked.value), result.error.issues),\n    };\n  };\n};\n\n/** Warns once per surface that the whole body renders nothing on. */\nconst collectEmptySurfaceWarnings = (\n  body: readonly unknown[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationWarning[] =>\n  SURFACE_NAMES.filter(\n    (surface) => !body.some((node) => rendersOnSurface(node, surface, walk))\n  ).map((surface) => ({\n    surface,\n    message: `composition renders no nodes on surface \"${surface}\"`,\n  }));\n\n/**\n * Errors for each node whose `id` repeats one already seen, naming the first\n * use.\n *\n * Errors rather than warnings, because ids are what a host addresses a node by.\n * Run by `validate` and deliberately not by `parse`; see\n * {@link createCompositionParser}.\n */\nconst collectDuplicateNodeIdErrors = (\n  body: readonly unknown[],\n  walk: ReturnType<typeof createChildNodeWalker>\n): ValidationError[] => {\n  const errors: ValidationError[] = [];\n  const seen = new Map<string, string>();\n  const visit = (node: unknown, path: string): void => {\n    if (!node || typeof node !== 'object') {\n      return;\n    }\n    const { id, type } = node as { id?: unknown; type?: unknown };\n    if (typeof id === 'string') {\n      const first = seen.get(id);\n      if (first) {\n        errors.push({\n          path: `${path}.id`,\n          message: `duplicates id ${quoteText(id)} first used at ${first}`,\n          ...(typeof type === 'string' ? { nodeType: type } : {}),\n        });\n      } else {\n        seen.set(id, path);\n      }\n    }\n    walk(node).forEach(({ node: child, path: field }) => {\n      visit(child, childNodePath(path, field));\n    });\n  };\n  body.forEach((node, index) => visit(node, `body[${index}]`));\n  return errors;\n};\n"]}

package/dist/validate/value_schemas.d.ts

@@ -0,0 +1,53 @@
+import { z } from 'zod';
+/** Derived from {@link ALL_NAMED_COLORS} rather than restating the literals. */
+export declare const namedColorSchema: z.ZodEnum<{
+    primary: "primary";
+    danger: "danger";
+    success: "success";
+    neutral: "neutral";
+    accent: "accent";
+    warning: "warning";
+    risk: "risk";
+}>;
+/** `RenderTheme`: the light/dark preference a caller asks for. */
+export declare const renderThemeSchema: z.ZodEnum<{
+    auto: "auto";
+    light: "light";
+    dark: "dark";
+}>;
+/**
+ * The raw quantity plus a format hint, formatted once in a primitive's model so
+ * every surface renders the same string. See `StructuredValue`.
+ */
+export declare const structuredValueSchema: z.ZodObject<{
+    raw: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    format: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        date: "date";
+        compact: "compact";
+        percent: "percent";
+        currency: "currency";
+        bytes: "bytes";
+        duration: "duration";
+        relativeTime: "relativeTime";
+    }>>;
+    precision: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Value-bearing fields accept preformatted prose or a structured value. */
+export declare const displayValueSchema: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+    raw: z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>;
+    format: z.ZodOptional<z.ZodEnum<{
+        number: "number";
+        date: "date";
+        compact: "compact";
+        percent: "percent";
+        currency: "currency";
+        bytes: "bytes";
+        duration: "duration";
+        relativeTime: "relativeTime";
+    }>>;
+    precision: z.ZodOptional<z.ZodNumber>;
+    currency: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+//# sourceMappingURL=value_schemas.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value_schemas.d.ts","sourceRoot":"","sources":["../../src/validate/value_schemas.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,gFAAgF;AAChF,eAAO,MAAM,gBAAgB;;;;;;;;EAE5B,CAAC;AAEF,kEAAkE;AAClE,eAAO,MAAM,iBAAiB;;;;EAAwC,CAAC;AAEvE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;iBAiBhC,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;mBAM9B,CAAC"}

package/dist/validate/value_schemas.js

@@ -0,0 +1,50 @@
+/*
+ * 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.
+ */
+// Zod for the value shapes the sdk already owns types for: `NamedColor`, and
+// the structured display value.
+//
+// Only the shapes the sdk owns belong here. That is what lets any vocabulary
+// package validate a color or a display value without depending on another
+// pack's schemas.
+import { z } from 'zod';
+import { ALL_NAMED_COLORS } from '../composition/named_color.js';
+import { STRUCTURED_VALUE_FORMATS } from '../composition/structured_value.js';
+import { oneOf } from '../define/zod_format.js';
+import { requiredString } from '../define/zod_helpers.js';
+// An enum whose own message names the accepted values, as validation reports it.
+const closedEnum = (values) => z.enum(values, { error: () => oneOf(values) });
+/** Derived from {@link ALL_NAMED_COLORS} rather than restating the literals. */
+export const namedColorSchema = closedEnum(ALL_NAMED_COLORS);
+/** `RenderTheme`: the light/dark preference a caller asks for. */
+export const renderThemeSchema = closedEnum(['auto', 'light', 'dark']);
+/**
+ * The raw quantity plus a format hint, formatted once in a primitive's model so
+ * every surface renders the same string. See `StructuredValue`.
+ */
+export const structuredValueSchema = z.object({
+    raw: z.union([z.number(), requiredString()], {
+        error: () => 'must be a finite number or a non-empty string',
+    }),
+    format: closedEnum(STRUCTURED_VALUE_FORMATS).optional(),
+    precision: z
+        .number({ error: () => 'must be an integer between 0 and 6' })
+        .int({ error: 'must be an integer between 0 and 6' })
+        .min(0, { error: 'must be an integer between 0 and 6' })
+        .max(6, { error: 'must be an integer between 0 and 6' })
+        .optional(),
+    currency: z
+        .string({ error: () => 'must be a three-letter currency code' })
+        .regex(/^[A-Za-z]{3}$/, {
+        error: 'must be a three-letter currency code',
+    })
+        .optional(),
+});
+/** Value-bearing fields accept preformatted prose or a structured value. */
+export const displayValueSchema = z.union([requiredString(), structuredValueSchema], {
+    error: () => 'must be a non-empty string or a structured value ({ raw, format?, precision?, currency? })',
+});
+//# sourceMappingURL=value_schemas.js.map

package/dist/validate/value_schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value_schemas.js","sourceRoot":"","sources":["../../src/validate/value_schemas.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6EAA6E;AAC7E,gCAAgC;AAChC,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,kBAAkB;AAElB,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAmB,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,iFAAiF;AACjF,MAAM,UAAU,GAAG,CACjB,MAAS,EACT,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEpD,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CACxC,gBAAiD,CAClD,CAAC;AAEF,kEAAkE;AAClE,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AAEvE;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE;QAC3C,KAAK,EAAE,GAAG,EAAE,CAAC,+CAA+C;KAC7D,CAAC;IACF,MAAM,EAAE,UAAU,CAAC,wBAAwB,CAAC,CAAC,QAAQ,EAAE;IACvD,SAAS,EAAE,CAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,oCAAoC,EAAE,CAAC;SAC7D,GAAG,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACpD,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACvD,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACvD,QAAQ,EAAE;IACb,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,sCAAsC,EAAE,CAAC;SAC/D,KAAK,CAAC,eAAe,EAAE;QACtB,KAAK,EAAE,sCAAsC;KAC9C,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAEH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CACvC,CAAC,cAAc,EAAE,EAAE,qBAAqB,CAAC,EACzC;IACE,KAAK,EAAE,GAAG,EAAE,CACV,4FAA4F;CAC/F,CACF,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// Zod for the value shapes the sdk already owns types for: `NamedColor`, and\n// the structured display value.\n//\n// Only the shapes the sdk owns belong here. That is what lets any vocabulary\n// package validate a color or a display value without depending on another\n// pack's schemas.\n\nimport { z } from 'zod';\n\nimport { ALL_NAMED_COLORS, type NamedColor } from '../composition/named_color';\nimport { STRUCTURED_VALUE_FORMATS } from '../composition/structured_value';\nimport { oneOf } from '../define/zod_format';\nimport { requiredString } from '../define/zod_helpers';\n\n// An enum whose own message names the accepted values, as validation reports it.\nconst closedEnum = <const T extends readonly [string, ...string[]]>(\n  values: T\n) => z.enum(values, { error: () => oneOf(values) });\n\n/** Derived from {@link ALL_NAMED_COLORS} rather than restating the literals. */\nexport const namedColorSchema = closedEnum(\n  ALL_NAMED_COLORS as [NamedColor, ...NamedColor[]]\n);\n\n/** `RenderTheme`: the light/dark preference a caller asks for. */\nexport const renderThemeSchema = closedEnum(['auto', 'light', 'dark']);\n\n/**\n * The raw quantity plus a format hint, formatted once in a primitive's model so\n * every surface renders the same string. See `StructuredValue`.\n */\nexport const structuredValueSchema = z.object({\n  raw: z.union([z.number(), requiredString()], {\n    error: () => 'must be a finite number or a non-empty string',\n  }),\n  format: closedEnum(STRUCTURED_VALUE_FORMATS).optional(),\n  precision: z\n    .number({ error: () => 'must be an integer between 0 and 6' })\n    .int({ error: 'must be an integer between 0 and 6' })\n    .min(0, { error: 'must be an integer between 0 and 6' })\n    .max(6, { error: 'must be an integer between 0 and 6' })\n    .optional(),\n  currency: z\n    .string({ error: () => 'must be a three-letter currency code' })\n    .regex(/^[A-Za-z]{3}$/, {\n      error: 'must be a three-letter currency code',\n    })\n    .optional(),\n});\n\n/** Value-bearing fields accept preformatted prose or a structured value. */\nexport const displayValueSchema = z.union(\n  [requiredString(), structuredValueSchema],\n  {\n    error: () =>\n      'must be a non-empty string or a structured value ({ raw, format?, precision?, currency? })',\n  }\n);\n"]}

package/package.json

@@ -1,6 +1,120 @@
 {
-   "name": "@elastic/isomer-sdk",
-   "version": "0.0.0",
-   "description": "Placeholder to enable Trusted Publisher configuration.",
-   "repository": { "type": "git", "url": "https://github.com/elastic/isomer" }
-}
+  "name": "@elastic/isomer-sdk",
+  "version": "0.2.0",
+  "description": "Shared primitive-pack toolkit for Isomer: the composition contract, validation, and rendering.",
+  "license": "Elastic-2.0",
+  "author": "Elastic",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elastic/isomer.git",
+    "directory": "packages/isomer-sdk"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "main": "./dist/cjs/entries/index.js",
+  "module": "./dist/entries/index.js",
+  "types": "./dist/entries/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/entries/index.d.ts",
+      "import": "./dist/entries/index.js",
+      "require": "./dist/cjs/entries/index.js"
+    },
+    "./html": {
+      "types": "./dist/entries/html.d.ts",
+      "import": "./dist/entries/html.js",
+      "require": "./dist/cjs/entries/html.js"
+    },
+    "./slack": {
+      "types": "./dist/entries/slack.d.ts",
+      "import": "./dist/entries/slack.js",
+      "require": "./dist/cjs/entries/slack.js"
+    },
+    "./text": {
+      "types": "./dist/entries/text.d.ts",
+      "import": "./dist/entries/text.js",
+      "require": "./dist/cjs/entries/text.js"
+    },
+    "./markdown": {
+      "types": "./dist/entries/markdown.d.ts",
+      "import": "./dist/entries/markdown.js",
+      "require": "./dist/cjs/entries/markdown.js"
+    },
+    "./react": {
+      "types": "./dist/entries/react.d.ts",
+      "import": "./dist/entries/react.js",
+      "require": "./dist/cjs/entries/react.js"
+    },
+    "./author": {
+      "types": "./dist/author/index.d.ts",
+      "import": "./dist/author/index.js",
+      "require": "./dist/cjs/author/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js",
+      "require": "./dist/cjs/testing/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "html": [
+        "./dist/entries/html.d.ts"
+      ],
+      "slack": [
+        "./dist/entries/slack.d.ts"
+      ],
+      "text": [
+        "./dist/entries/text.d.ts"
+      ],
+      "markdown": [
+        "./dist/entries/markdown.d.ts"
+      ],
+      "react": [
+        "./dist/entries/react.d.ts"
+      ],
+      "author": [
+        "./dist/author/index.d.ts"
+      ],
+      "testing": [
+        "./dist/testing/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "NOTICE.txt",
+    "THIRD_PARTY_LICENSES.md",
+    "LICENSE.txt"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18 <20",
+    "react-dom": ">=18 <20",
+    "zod": "^4.4.1"
+  },
+  "peerDependenciesMeta": {
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "acorn": "^8.18.0",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "mdast-util-to-markdown": "^2.1.2",
+    "micromark-extension-gfm": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.4",
+    "parse5": "^7.3.0"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}