@elastic/isomer-studio 0.0.0 → 0.4.0

package/dist/home/tokens.js

@@ -0,0 +1,171 @@
+/*
+ * 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 { css } from '@emotion/react';
+import { ISOMER_MARK } from '../chrome/isomer_mark.js';
+/** Home's own palette: one dark look on the plum shell, whatever the color mode. */
+export const HOME = {
+    shell: '#3E3748',
+    fg: '#FFFFFF',
+    fg2: 'rgba(255, 255, 255, 0.72)',
+    fg3: 'rgba(255, 255, 255, 0.55)',
+    surface1: 'rgba(255, 255, 255, 0.05)',
+    surface2: 'rgba(255, 255, 255, 0.07)',
+    surface3: 'rgba(255, 255, 255, 0.11)',
+    field: 'rgba(22, 12, 30, 0.5)',
+    line1: 'rgba(255, 255, 255, 0.12)',
+    line2: 'rgba(255, 255, 255, 0.14)',
+    line3: 'rgba(255, 255, 255, 0.18)',
+    accent: '#F78BBB',
+    accentBorder: '#F04E98',
+    docs: ISOMER_MARK.blue,
+    dev: ISOMER_MARK.teal,
+    app: ISOMER_MARK.yellow,
+    actionSurface: '#302938',
+    actionSurfaceHover: '#382F40',
+};
+/** The glows behind the shell: the same stops as Workbench and Reference, in the logo's palette. */
+export const homeBackground = css `
+  background-color: ${HOME.shell};
+  background-image:
+    radial-gradient(circle at 0% 0%, rgba(0, 191, 179, 0.3), transparent 24%),
+    radial-gradient(
+      circle at 4% 100%,
+      rgba(254, 197, 20, 0.2),
+      transparent 22%
+    ),
+    radial-gradient(circle at 40% 0%, rgba(240, 78, 152, 0.14), transparent 18%);
+`;
+export const CONTENT_WIDTH = 620;
+export const HOME_NARROW = `@container isomer-home (max-width: ${CONTENT_WIDTH - 1}px)`;
+export const WIDE_CONTENT_WIDTH = 880;
+export const PANEL_WIDTH = 360;
+export const GUTTER = 48;
+/** Where the main column fits {@link WIDE_CONTENT_WIDTH} beside the panel. */
+export const WIDE = `@media (min-width: ${WIDE_CONTENT_WIDTH + 2 * GUTTER + PANEL_WIDTH + 64}px)`;
+/** Tiles per row, set on the main column and read by every tile grid inside it. */
+export const TILE_COLUMNS = '--isomer-studio-tile-columns';
+export const sectionLabel = css `
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.01em;
+  color: ${HOME.fg2};
+`;
+export const sectionHeading = css `
+  margin: 0;
+  font: inherit;
+`;
+export const quietLabel = css `
+  ${sectionLabel};
+  font-size: 11px;
+  font-weight: 400;
+  letter-spacing: 0.06em;
+  text-transform: uppercase;
+  color: ${HOME.fg3};
+`;
+/** A tile's chrome. Rows line up across a grid through subgrid, so a wrapped title shifts its neighbours too. */
+export const tile = (rows) => css `
+  display: grid;
+  grid-template-rows: subgrid;
+  grid-row: span ${rows};
+  row-gap: 5px;
+  padding: 14px 16px;
+  border-radius: 10px;
+  box-sizing: border-box;
+  min-height: 120px;
+  background: ${HOME.surface2};
+  border: 1px solid ${HOME.line2};
+  color: ${HOME.fg2};
+  text-decoration: none;
+  transition:
+    background 0.12s,
+    border-color 0.12s;
+  &:hover,
+  &:focus-within {
+    background: ${HOME.surface3};
+    text-decoration: none;
+  }
+`;
+/** Opaque plum keeps the logo-colored actions readable over the shell's glows. */
+export const actionCard = css `
+  background: ${HOME.actionSurface};
+  &:hover,
+  &:focus-within {
+    background: ${HOME.actionSurfaceHover};
+  }
+`;
+export const tileTop = css `
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 8px;
+`;
+export const tileName = css `
+  font-size: 14px;
+  font-weight: 600;
+  color: ${HOME.accent};
+`;
+export const tileDescription = css `
+  font-size: 12px;
+  color: ${HOME.fg2};
+  text-wrap: pretty;
+`;
+/** The bottom row of links, shown on hover or focus; always shown where there is no hover. */
+export const tileActions = css `
+  margin-top: auto;
+  padding-top: 6px;
+  display: flex;
+  gap: 14px;
+  font-size: 12px;
+  font-weight: 600;
+  opacity: 0;
+  transition: opacity 0.12s;
+  a {
+    text-decoration: none;
+  }
+  a:hover {
+    text-decoration: underline;
+  }
+  *:hover > &,
+  *:focus-within > & {
+    opacity: 1;
+  }
+  @media (hover: none) {
+    opacity: 1;
+  }
+`;
+/** A dashed tile that points somewhere else: the gallery, or the docs on adding an app. */
+export const helpTile = (rows, color) => css `
+  ${tile(rows)};
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  text-align: center;
+  gap: 6px;
+  border-style: dashed;
+  border-color: rgba(255, 255, 255, 0.25);
+  background: ${HOME.surface1};
+  &:hover,
+  &:focus-within {
+    border-color: ${color};
+  }
+`;
+export const tilesGrid = css `
+  display: grid;
+  grid-template-columns: repeat(var(${TILE_COLUMNS}, 3), minmax(0, 1fr));
+  gap: 12px;
+  ${HOME_NARROW} {
+    grid-template-columns: minmax(0, 1fr);
+  }
+`;
+export const monoFont = (familyCode) => css `
+  font-family: ${familyCode};
+`;
+//# sourceMappingURL=tokens.js.map

package/dist/home/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/home/tokens.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 { css } from '@emotion/react';\n\nimport { ISOMER_MARK } from '../chrome/isomer_mark';\n\n/** Home's own palette: one dark look on the plum shell, whatever the color mode. */\nexport const HOME = {\n  shell: '#3E3748',\n  fg: '#FFFFFF',\n  fg2: 'rgba(255, 255, 255, 0.72)',\n  fg3: 'rgba(255, 255, 255, 0.55)',\n  surface1: 'rgba(255, 255, 255, 0.05)',\n  surface2: 'rgba(255, 255, 255, 0.07)',\n  surface3: 'rgba(255, 255, 255, 0.11)',\n  field: 'rgba(22, 12, 30, 0.5)',\n  line1: 'rgba(255, 255, 255, 0.12)',\n  line2: 'rgba(255, 255, 255, 0.14)',\n  line3: 'rgba(255, 255, 255, 0.18)',\n  accent: '#F78BBB',\n  accentBorder: '#F04E98',\n  docs: ISOMER_MARK.blue,\n  dev: ISOMER_MARK.teal,\n  app: ISOMER_MARK.yellow,\n  actionSurface: '#302938',\n  actionSurfaceHover: '#382F40',\n} as const;\n\n/** The glows behind the shell: the same stops as Workbench and Reference, in the logo's palette. */\nexport const homeBackground = css`\n  background-color: ${HOME.shell};\n  background-image:\n    radial-gradient(circle at 0% 0%, rgba(0, 191, 179, 0.3), transparent 24%),\n    radial-gradient(\n      circle at 4% 100%,\n      rgba(254, 197, 20, 0.2),\n      transparent 22%\n    ),\n    radial-gradient(circle at 40% 0%, rgba(240, 78, 152, 0.14), transparent 18%);\n`;\n\nexport const CONTENT_WIDTH = 620;\nexport const HOME_NARROW = `@container isomer-home (max-width: ${CONTENT_WIDTH - 1}px)`;\nexport const WIDE_CONTENT_WIDTH = 880;\nexport const PANEL_WIDTH = 360;\nexport const GUTTER = 48;\n\n/** Where the main column fits {@link WIDE_CONTENT_WIDTH} beside the panel. */\nexport const WIDE = `@media (min-width: ${WIDE_CONTENT_WIDTH + 2 * GUTTER + PANEL_WIDTH + 64}px)`;\n\n/** Tiles per row, set on the main column and read by every tile grid inside it. */\nexport const TILE_COLUMNS = '--isomer-studio-tile-columns';\n\nexport const sectionLabel = css`\n  display: flex;\n  align-items: center;\n  justify-content: space-between;\n  font-size: 12px;\n  font-weight: 600;\n  letter-spacing: 0.01em;\n  color: ${HOME.fg2};\n`;\n\nexport const sectionHeading = css`\n  margin: 0;\n  font: inherit;\n`;\n\nexport const quietLabel = css`\n  ${sectionLabel};\n  font-size: 11px;\n  font-weight: 400;\n  letter-spacing: 0.06em;\n  text-transform: uppercase;\n  color: ${HOME.fg3};\n`;\n\n/** A tile's chrome. Rows line up across a grid through subgrid, so a wrapped title shifts its neighbours too. */\nexport const tile = (rows: number) => css`\n  display: grid;\n  grid-template-rows: subgrid;\n  grid-row: span ${rows};\n  row-gap: 5px;\n  padding: 14px 16px;\n  border-radius: 10px;\n  box-sizing: border-box;\n  min-height: 120px;\n  background: ${HOME.surface2};\n  border: 1px solid ${HOME.line2};\n  color: ${HOME.fg2};\n  text-decoration: none;\n  transition:\n    background 0.12s,\n    border-color 0.12s;\n  &:hover,\n  &:focus-within {\n    background: ${HOME.surface3};\n    text-decoration: none;\n  }\n`;\n\n/** Opaque plum keeps the logo-colored actions readable over the shell's glows. */\nexport const actionCard = css`\n  background: ${HOME.actionSurface};\n  &:hover,\n  &:focus-within {\n    background: ${HOME.actionSurfaceHover};\n  }\n`;\n\nexport const tileTop = css`\n  display: flex;\n  align-items: flex-start;\n  justify-content: space-between;\n  gap: 8px;\n`;\n\nexport const tileName = css`\n  font-size: 14px;\n  font-weight: 600;\n  color: ${HOME.accent};\n`;\n\nexport const tileDescription = css`\n  font-size: 12px;\n  color: ${HOME.fg2};\n  text-wrap: pretty;\n`;\n\n/** The bottom row of links, shown on hover or focus; always shown where there is no hover. */\nexport const tileActions = css`\n  margin-top: auto;\n  padding-top: 6px;\n  display: flex;\n  gap: 14px;\n  font-size: 12px;\n  font-weight: 600;\n  opacity: 0;\n  transition: opacity 0.12s;\n  a {\n    text-decoration: none;\n  }\n  a:hover {\n    text-decoration: underline;\n  }\n  *:hover > &,\n  *:focus-within > & {\n    opacity: 1;\n  }\n  @media (hover: none) {\n    opacity: 1;\n  }\n`;\n\n/** A dashed tile that points somewhere else: the gallery, or the docs on adding an app. */\nexport const helpTile = (rows: number, color: string) => css`\n  ${tile(rows)};\n  display: flex;\n  flex-direction: column;\n  justify-content: center;\n  align-items: center;\n  text-align: center;\n  gap: 6px;\n  border-style: dashed;\n  border-color: rgba(255, 255, 255, 0.25);\n  background: ${HOME.surface1};\n  &:hover,\n  &:focus-within {\n    border-color: ${color};\n  }\n`;\n\nexport const tilesGrid = css`\n  display: grid;\n  grid-template-columns: repeat(var(${TILE_COLUMNS}, 3), minmax(0, 1fr));\n  gap: 12px;\n  ${HOME_NARROW} {\n    grid-template-columns: minmax(0, 1fr);\n  }\n`;\n\nexport const monoFont = (familyCode: string) => css`\n  font-family: ${familyCode};\n`;\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export type { StudioApp, StudioAppPage, StudioAppProps, StudioAppSurface, StudioCompose, StudioConfig, StudioPreviewProps, StudioRuntime, StudioSurfaceProps, StudioTheme, } from './config.js';
+export { defineStudioConfig } from './config.js';
+export { adoptStylesheet } from './surfaces/adopt_stylesheet.js';
+export type { PreviewZoom } from './surfaces/scaled_preview.js';
+export type { RenderPdf } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,YAAY,EACV,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,WAAW,GACZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/*
+ * 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 { defineStudioConfig } from './config.js';
+export { adoptStylesheet } from './surfaces/adopt_stylesheet.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,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 type {\n  StudioApp,\n  StudioAppPage,\n  StudioAppProps,\n  StudioAppSurface,\n  StudioCompose,\n  StudioConfig,\n  StudioPreviewProps,\n  StudioRuntime,\n  StudioSurfaceProps,\n  StudioTheme,\n} from './config';\nexport { defineStudioConfig } from './config';\nexport { adoptStylesheet } from './surfaces/adopt_stylesheet';\nexport type { PreviewZoom } from './surfaces/scaled_preview';\nexport type { RenderPdf } from './types';\n"]}

package/dist/model/app_problems.d.ts

@@ -0,0 +1,4 @@
+export declare const APP_ID_PATTERN: RegExp;
+/** What is wrong with a config's `apps`, one line per problem, each naming the app. Runs in Node and the browser. */
+export declare const appProblems: (apps: unknown) => string[];
+//# sourceMappingURL=app_problems.d.ts.map

package/dist/model/app_problems.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_problems.d.ts","sourceRoot":"","sources":["../../src/model/app_problems.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,cAAc,QAAsB,CAAC;AAkDlD,qHAAqH;AACrH,eAAO,MAAM,WAAW,GAAI,MAAM,OAAO,KAAG,MAAM,EAyCjD,CAAC"}

package/dist/model/app_problems.js

@@ -0,0 +1,90 @@
+/*
+ * 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 const APP_ID_PATTERN = /^[a-z][a-z0-9-]*$/;
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const label = (index, id) => typeof id === 'string' ? `apps[${index}] ("${id}")` : `apps[${index}]`;
+const isNonEmptyString = (value) => typeof value === 'string' && value.trim().length > 0;
+const isPagePath = (path) => typeof path === 'string' &&
+    path.split('/').every((segment) => segment.length > 0);
+const pageProblems = (name, pages) => {
+    if (pages === undefined) {
+        return [];
+    }
+    if (!Array.isArray(pages)) {
+        return [`${name}: pages must be an array.`];
+    }
+    const problems = [];
+    const seen = new Set();
+    pages.forEach((page, index) => {
+        const at = `${name}: pages[${index}]`;
+        if (!isRecord(page)) {
+            problems.push(`${at} must be an object.`);
+            return;
+        }
+        const { path, title, section } = page;
+        if (!isPagePath(path)) {
+            problems.push(`${at}: path must be one or more non-empty segments, with no leading or trailing "/".`);
+        }
+        else if (seen.has(path)) {
+            problems.push(`${at}: path "${path}" is used by an earlier page.`);
+        }
+        else {
+            seen.add(path);
+        }
+        if (!isNonEmptyString(title)) {
+            problems.push(`${at}: title must be a non-empty string.`);
+        }
+        if (section !== undefined && !isNonEmptyString(section)) {
+            problems.push(`${at}: section must be a non-empty string.`);
+        }
+    });
+    return problems;
+};
+/** What is wrong with a config's `apps`, one line per problem, each naming the app. Runs in Node and the browser. */
+export const appProblems = (apps) => {
+    if (apps === undefined) {
+        return [];
+    }
+    if (!Array.isArray(apps)) {
+        return ['apps must be an array.'];
+    }
+    const problems = [];
+    const seen = new Set();
+    apps.forEach((app, index) => {
+        if (!isRecord(app)) {
+            problems.push(`apps[${index}] must be an object.`);
+            return;
+        }
+        const { id, title, description, icon, load, pages } = app;
+        const name = label(index, id);
+        if (typeof id !== 'string' || !APP_ID_PATTERN.test(id)) {
+            problems.push(`${name}: id must match ${APP_ID_PATTERN.source}.`);
+        }
+        else if (seen.has(id)) {
+            problems.push(`${name}: id is used by an earlier app.`);
+        }
+        else {
+            seen.add(id);
+        }
+        if (!isNonEmptyString(title)) {
+            problems.push(`${name}: title must be a non-empty string.`);
+        }
+        if (description !== undefined && !isNonEmptyString(description)) {
+            problems.push(`${name}: description must be a non-empty string.`);
+        }
+        if (typeof load !== 'function') {
+            problems.push(`${name}: load must be a function.`);
+        }
+        if (icon !== undefined &&
+            !(isRecord(icon) && typeof icon.svg === 'string')) {
+            problems.push(`${name}: icon must be { svg: string }.`);
+        }
+        problems.push(...pageProblems(name, pages));
+    });
+    return problems;
+};
+//# sourceMappingURL=app_problems.js.map

package/dist/model/app_problems.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app_problems.js","sourceRoot":"","sources":["../../src/model/app_problems.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\nexport const APP_ID_PATTERN = /^[a-z][a-z0-9-]*$/;\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null;\n\nconst label = (index: number, id: unknown) =>\n  typeof id === 'string' ? `apps[${index}] (\"${id}\")` : `apps[${index}]`;\n\nconst isNonEmptyString = (value: unknown): value is string =>\n  typeof value === 'string' && value.trim().length > 0;\n\nconst isPagePath = (path: unknown): path is string =>\n  typeof path === 'string' &&\n  path.split('/').every((segment) => segment.length > 0);\n\nconst pageProblems = (name: string, pages: unknown): string[] => {\n  if (pages === undefined) {\n    return [];\n  }\n  if (!Array.isArray(pages)) {\n    return [`${name}: pages must be an array.`];\n  }\n  const problems: string[] = [];\n  const seen = new Set<string>();\n  pages.forEach((page: unknown, index) => {\n    const at = `${name}: pages[${index}]`;\n    if (!isRecord(page)) {\n      problems.push(`${at} must be an object.`);\n      return;\n    }\n    const { path, title, section } = page;\n    if (!isPagePath(path)) {\n      problems.push(\n        `${at}: path must be one or more non-empty segments, with no leading or trailing \"/\".`\n      );\n    } else if (seen.has(path)) {\n      problems.push(`${at}: path \"${path}\" is used by an earlier page.`);\n    } else {\n      seen.add(path);\n    }\n    if (!isNonEmptyString(title)) {\n      problems.push(`${at}: title must be a non-empty string.`);\n    }\n    if (section !== undefined && !isNonEmptyString(section)) {\n      problems.push(`${at}: section must be a non-empty string.`);\n    }\n  });\n  return problems;\n};\n\n/** What is wrong with a config's `apps`, one line per problem, each naming the app. Runs in Node and the browser. */\nexport const appProblems = (apps: unknown): string[] => {\n  if (apps === undefined) {\n    return [];\n  }\n  if (!Array.isArray(apps)) {\n    return ['apps must be an array.'];\n  }\n  const problems: string[] = [];\n  const seen = new Set<string>();\n  apps.forEach((app: unknown, index) => {\n    if (!isRecord(app)) {\n      problems.push(`apps[${index}] must be an object.`);\n      return;\n    }\n    const { id, title, description, icon, load, pages } = app;\n    const name = label(index, id);\n    if (typeof id !== 'string' || !APP_ID_PATTERN.test(id)) {\n      problems.push(`${name}: id must match ${APP_ID_PATTERN.source}.`);\n    } else if (seen.has(id)) {\n      problems.push(`${name}: id is used by an earlier app.`);\n    } else {\n      seen.add(id);\n    }\n    if (!isNonEmptyString(title)) {\n      problems.push(`${name}: title must be a non-empty string.`);\n    }\n    if (description !== undefined && !isNonEmptyString(description)) {\n      problems.push(`${name}: description must be a non-empty string.`);\n    }\n    if (typeof load !== 'function') {\n      problems.push(`${name}: load must be a function.`);\n    }\n    if (\n      icon !== undefined &&\n      !(isRecord(icon) && typeof icon.svg === 'string')\n    ) {\n      problems.push(`${name}: icon must be { svg: string }.`);\n    }\n    problems.push(...pageProblems(name, pages));\n  });\n  return problems;\n};\n"]}

package/dist/model/authoring_types.d.ts

@@ -0,0 +1,23 @@
+import type { RuntimeAuthoringContext } from '@elastic/isomer-runtime';
+import type { AnyPrimitiveDefinition } from '@elastic/isomer-sdk';
+type SchemaNode = Record<string, unknown>;
+/** The module the SDK declares the authoring components in, and the editor's `jsxImportSource`. */
+export declare const AUTHORING_MODULE = "@elastic/isomer-authoring";
+/** What the editors check against: TypeScript declarations for JSX, a JSON Schema for JSON. */
+export interface AuthoringTypes {
+    declarations: string;
+    bodySchema: SchemaNode;
+    /** The component names JSX source uses without importing. */
+    components: string[];
+}
+/** The shim's components: what JSX source can open a tag with. */
+export declare const authoringComponents: (primitives: readonly AnyPrimitiveDefinition[]) => string[];
+/**
+ * The SDK's authoring module, plus a global per shim component, since the editor's source uses
+ * them without importing.
+ */
+export declare const authoringDeclarations: (schema: SchemaNode, primitives: readonly AnyPrimitiveDefinition[]) => string;
+/** A JSON Schema for the JSON editor: one body node, or an array of them. */
+export declare const bodyJsonSchema: ({ bodySchema, }: Pick<RuntimeAuthoringContext, "bodySchema">) => SchemaNode;
+export {};
+//# sourceMappingURL=authoring_types.d.ts.map

package/dist/model/authoring_types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_types.d.ts","sourceRoot":"","sources":["../../src/model/authoring_types.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAKlE,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C,mGAAmG;AACnG,eAAO,MAAM,gBAAgB,8BAA8B,CAAC;AAE5D,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,GAC9B,YAAY,SAAS,sBAAsB,EAAE,KAC5C,MAAM,EAGN,CAAC;AAEJ;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,UAAU,EAClB,YAAY,SAAS,sBAAsB,EAAE,KAC5C,MAYF,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,cAAc,GAAI,iBAE5B,IAAI,CAAC,uBAAuB,EAAE,YAAY,CAAC,KAAG,UAMhD,CAAC"}

package/dist/model/authoring_types.js

@@ -0,0 +1,35 @@
+/*
+ * 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 { buildAuthoringDeclarations } from '@elastic/isomer-sdk/author';
+import { createShim } from './compile_jsx.js';
+/** The module the SDK declares the authoring components in, and the editor's `jsxImportSource`. */
+export const AUTHORING_MODULE = '@elastic/isomer-authoring';
+/** The shim's components: what JSX source can open a tag with. */
+export const authoringComponents = (primitives) => Object.keys(createShim(primitives)).filter((name) => name !== 'toComposition');
+/**
+ * The SDK's authoring module, plus a global per shim component, since the editor's source uses
+ * them without importing.
+ */
+export const authoringDeclarations = (schema, primitives) => {
+    const names = authoringComponents(primitives);
+    return [
+        buildAuthoringDeclarations(schema, primitives, {
+            jsx: true,
+            moduleName: AUTHORING_MODULE,
+        }),
+        ...names.map((name) => `declare const ${name}: typeof import(${JSON.stringify(AUTHORING_MODULE)}).${name};`),
+    ].join('\n\n');
+};
+/** A JSON Schema for the JSON editor: one body node, or an array of them. */
+export const bodyJsonSchema = ({ bodySchema, }) => {
+    const { $defs, items } = bodySchema;
+    if (!items) {
+        return {};
+    }
+    return { $defs, oneOf: [items, { type: 'array', minItems: 1, items }] };
+};
+//# sourceMappingURL=authoring_types.js.map

package/dist/model/authoring_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authoring_types.js","sourceRoot":"","sources":["../../src/model/authoring_types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAI3C,mGAAmG;AACnG,MAAM,CAAC,MAAM,gBAAgB,GAAG,2BAA2B,CAAC;AAU5D,kEAAkE;AAClE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,UAA6C,EACnC,EAAE,CACZ,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CACxC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,eAAe,CACnC,CAAC;AAEJ;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,MAAkB,EAClB,UAA6C,EACrC,EAAE;IACV,MAAM,KAAK,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO;QACL,0BAA0B,CAAC,MAAM,EAAE,UAAU,EAAE;YAC7C,GAAG,EAAE,IAAI;YACT,UAAU,EAAE,gBAAgB;SAC7B,CAAC;QACF,GAAG,KAAK,CAAC,GAAG,CACV,CAAC,IAAI,EAAE,EAAE,CACP,iBAAiB,IAAI,mBAAmB,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,KAAK,IAAI,GAAG,CACvF;KACF,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAC7B,UAAU,GACkC,EAAc,EAAE;IAC5D,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAC1E,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 type { RuntimeAuthoringContext } from '@elastic/isomer-runtime';\nimport type { AnyPrimitiveDefinition } from '@elastic/isomer-sdk';\nimport { buildAuthoringDeclarations } from '@elastic/isomer-sdk/author';\n\nimport { createShim } from './compile_jsx';\n\ntype SchemaNode = Record<string, unknown>;\n\n/** The module the SDK declares the authoring components in, and the editor's `jsxImportSource`. */\nexport const AUTHORING_MODULE = '@elastic/isomer-authoring';\n\n/** What the editors check against: TypeScript declarations for JSX, a JSON Schema for JSON. */\nexport interface AuthoringTypes {\n  declarations: string;\n  bodySchema: SchemaNode;\n  /** The component names JSX source uses without importing. */\n  components: string[];\n}\n\n/** The shim's components: what JSX source can open a tag with. */\nexport const authoringComponents = (\n  primitives: readonly AnyPrimitiveDefinition[]\n): string[] =>\n  Object.keys(createShim(primitives)).filter(\n    (name) => name !== 'toComposition'\n  );\n\n/**\n * The SDK's authoring module, plus a global per shim component, since the editor's source uses\n * them without importing.\n */\nexport const authoringDeclarations = (\n  schema: SchemaNode,\n  primitives: readonly AnyPrimitiveDefinition[]\n): string => {\n  const names = authoringComponents(primitives);\n  return [\n    buildAuthoringDeclarations(schema, primitives, {\n      jsx: true,\n      moduleName: AUTHORING_MODULE,\n    }),\n    ...names.map(\n      (name) =>\n        `declare const ${name}: typeof import(${JSON.stringify(AUTHORING_MODULE)}).${name};`\n    ),\n  ].join('\\n\\n');\n};\n\n/** A JSON Schema for the JSON editor: one body node, or an array of them. */\nexport const bodyJsonSchema = ({\n  bodySchema,\n}: Pick<RuntimeAuthoringContext, 'bodySchema'>): SchemaNode => {\n  const { $defs, items } = bodySchema;\n  if (!items) {\n    return {};\n  }\n  return { $defs, oneOf: [items, { type: 'array', minItems: 1, items }] };\n};\n"]}

package/dist/model/compile_jsx.d.ts

@@ -0,0 +1,19 @@
+import type { PrimitiveNode } from '@elastic/isomer-sdk';
+import type { JsxShim } from '@elastic/isomer-sdk/author';
+import type { JsxTransform } from '../types.js';
+/** The binding compiled code assigns its element to. Lowercase-initial, so no component name can shadow it. */
+export declare const COMPILED_RESULT = "isomerStudioResult";
+/** Builds the authoring shim once per primitive inventory. */
+export declare const createShim: (primitives: readonly {
+    type: string;
+}[]) => JsxShim;
+/** Runs compiled code with `scope` as its free variables and returns {@link COMPILED_RESULT}. */
+export type CompiledEvaluator = (code: string, scope: Readonly<Record<string, unknown>>) => unknown;
+/**
+ * Compiles one `<Composition>` element written as authoring JSX to its body nodes.
+ * Runs the source in this page as a module by default, so only feed it what the user typed.
+ */
+export declare const compileCompositionJsx: (source: string, shim: JsxShim, transformJsx: JsxTransform, { evaluate }?: {
+    evaluate?: CompiledEvaluator;
+}) => Promise<PrimitiveNode[]>;
+//# sourceMappingURL=compile_jsx.d.ts.map

package/dist/model/compile_jsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile_jsx.d.ts","sourceRoot":"","sources":["../../src/model/compile_jsx.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAEV,OAAO,EACR,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAI7C,+GAA+G;AAC/G,eAAO,MAAM,eAAe,uBAAuB,CAAC;AAEpD,8DAA8D;AAC9D,eAAO,MAAM,UAAU,GAAI,YAAY,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,KAAG,OAC3C,CAAC;AAU3B,iGAAiG;AACjG,MAAM,MAAM,iBAAiB,GAAG,CAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACrC,OAAO,CAAC;AA+Bb;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,MAAM,OAAO,EACb,cAAc,YAAY,EAC1B,eAAiC;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAAO,KACrE,OAAO,CAAC,aAAa,EAAE,CAezB,CAAC"}

package/dist/model/compile_jsx.js

@@ -0,0 +1,55 @@
+/*
+ * 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 { buildJsxShim } from '@elastic/isomer-sdk/author';
+import { JSX_TRANSFORM_OPTIONS } from './jsx_transform.js';
+/** The binding compiled code assigns its element to. Lowercase-initial, so no component name can shadow it. */
+export const COMPILED_RESULT = 'isomerStudioResult';
+/** Builds the authoring shim once per primitive inventory. */
+export const createShim = (primitives) => buildJsxShim(primitives);
+const isElement = (value) => typeof value === 'object' &&
+    value !== null &&
+    'type' in value &&
+    'props' in value;
+const isRunner = (value) => typeof value === 'function';
+const evaluateAsModule = async (code, scope) => {
+    const module = `export default ({ ${Object.keys(scope).join(', ')} }) => {
+  let ${COMPILED_RESULT};
+  ${code}
+  return ${COMPILED_RESULT};
+};`;
+    const url = URL.createObjectURL(new Blob([module], { type: 'text/javascript' }));
+    try {
+        const { default: run } = (await import(
+        /* @vite-ignore */ /* webpackIgnore: true */ url));
+        if (!isRunner(run)) {
+            throw new Error('The compiled JSX did not load.');
+        }
+        return run(scope);
+    }
+    finally {
+        URL.revokeObjectURL(url);
+    }
+};
+/**
+ * Compiles one `<Composition>` element written as authoring JSX to its body nodes.
+ * Runs the source in this page as a module by default, so only feed it what the user typed.
+ */
+export const compileCompositionJsx = async (source, shim, transformJsx, { evaluate = evaluateAsModule } = {}) => {
+    const compiled = await transformJsx(`${COMPILED_RESULT} =\n${source}`);
+    const components = Object.fromEntries(Object.entries(shim).filter(([name]) => name !== 'toComposition'));
+    const element = await evaluate(compiled, {
+        ...components,
+        [JSX_TRANSFORM_OPTIONS.jsxFactory]: createElement,
+        [JSX_TRANSFORM_OPTIONS.jsxFragment]: Fragment,
+    });
+    if (!isElement(element)) {
+        throw new Error('The JSX did not produce an element.');
+    }
+    return shim.toComposition(element).body;
+};
+//# sourceMappingURL=compile_jsx.js.map

package/dist/model/compile_jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile_jsx.js","sourceRoot":"","sources":["../../src/model/compile_jsx.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAMhD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAI1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,+GAA+G;AAC/G,MAAM,CAAC,MAAM,eAAe,GAAG,oBAAoB,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,UAAuC,EAAW,EAAE,CAC7E,YAAY,CAAC,UAAU,CAAC,CAAC;AAE3B,MAAM,SAAS,GAAG,CAChB,KAAc,EACiC,EAAE,CACjD,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACf,OAAO,IAAI,KAAK,CAAC;AAQnB,MAAM,QAAQ,GAAG,CACf,KAAc,EACkD,EAAE,CAClE,OAAO,KAAK,KAAK,UAAU,CAAC;AAE9B,MAAM,gBAAgB,GAAsB,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE;IAChE,MAAM,MAAM,GAAG,qBAAqB,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3D,eAAe;IACnB,IAAI;WACG,eAAe;GACvB,CAAC;IACF,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAC7B,IAAI,IAAI,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,CAChD,CAAC;IACF,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,MAAM,MAAM;QACpC,kBAAkB,CAAC,yBAAyB,CAAC,GAAG,CACjD,CAEA,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,MAAc,EACd,IAAa,EACb,YAA0B,EAC1B,EAAE,QAAQ,GAAG,gBAAgB,KAAuC,EAAE,EAC5C,EAAE;IAC5B,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,GAAG,eAAe,OAAO,MAAM,EAAE,CAAC,CAAC;IACvE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,CACnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,IAAI,KAAK,eAAe,CAAC,CAClE,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE;QACvC,GAAG,UAAU;QACb,CAAC,qBAAqB,CAAC,UAAU,CAAC,EAAE,aAAa;QACjD,CAAC,qBAAqB,CAAC,WAAW,CAAC,EAAE,QAAQ;KAC9C,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;AAC1C,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 type { ReactElement } from 'react';\nimport { createElement, Fragment } from 'react';\nimport type { PrimitiveNode } from '@elastic/isomer-sdk';\nimport type {\n  CompositionAuthorProps,\n  JsxShim,\n} from '@elastic/isomer-sdk/author';\nimport { buildJsxShim } from '@elastic/isomer-sdk/author';\n\nimport type { JsxTransform } from '../types';\n\nimport { JSX_TRANSFORM_OPTIONS } from './jsx_transform';\n\n/** The binding compiled code assigns its element to. Lowercase-initial, so no component name can shadow it. */\nexport const COMPILED_RESULT = 'isomerStudioResult';\n\n/** Builds the authoring shim once per primitive inventory. */\nexport const createShim = (primitives: readonly { type: string }[]): JsxShim =>\n  buildJsxShim(primitives);\n\nconst isElement = (\n  value: unknown\n): value is ReactElement<CompositionAuthorProps> =>\n  typeof value === 'object' &&\n  value !== null &&\n  'type' in value &&\n  'props' in value;\n\n/** Runs compiled code with `scope` as its free variables and returns {@link COMPILED_RESULT}. */\nexport type CompiledEvaluator = (\n  code: string,\n  scope: Readonly<Record<string, unknown>>\n) => unknown;\n\nconst isRunner = (\n  value: unknown\n): value is (scope: Readonly<Record<string, unknown>>) => unknown =>\n  typeof value === 'function';\n\nconst evaluateAsModule: CompiledEvaluator = async (code, scope) => {\n  const module = `export default ({ ${Object.keys(scope).join(', ')} }) => {\n  let ${COMPILED_RESULT};\n  ${code}\n  return ${COMPILED_RESULT};\n};`;\n  const url = URL.createObjectURL(\n    new Blob([module], { type: 'text/javascript' })\n  );\n  try {\n    const { default: run } = (await import(\n      /* @vite-ignore */ /* webpackIgnore: true */ url\n    )) as {\n      default?: unknown;\n    };\n    if (!isRunner(run)) {\n      throw new Error('The compiled JSX did not load.');\n    }\n    return run(scope);\n  } finally {\n    URL.revokeObjectURL(url);\n  }\n};\n\n/**\n * Compiles one `<Composition>` element written as authoring JSX to its body nodes.\n * Runs the source in this page as a module by default, so only feed it what the user typed.\n */\nexport const compileCompositionJsx = async (\n  source: string,\n  shim: JsxShim,\n  transformJsx: JsxTransform,\n  { evaluate = evaluateAsModule }: { evaluate?: CompiledEvaluator } = {}\n): Promise<PrimitiveNode[]> => {\n  const compiled = await transformJsx(`${COMPILED_RESULT} =\\n${source}`);\n  const components = Object.fromEntries(\n    Object.entries(shim).filter(([name]) => name !== 'toComposition')\n  );\n  const element = await evaluate(compiled, {\n    ...components,\n    [JSX_TRANSFORM_OPTIONS.jsxFactory]: createElement,\n    [JSX_TRANSFORM_OPTIONS.jsxFragment]: Fragment,\n  });\n\n  if (!isElement(element)) {\n    throw new Error('The JSX did not produce an element.');\n  }\n  return shim.toComposition(element).body;\n};\n"]}

package/dist/model/compose_example.d.ts

@@ -0,0 +1,9 @@
+import type { Composition, PrimitiveNode } from '@elastic/isomer-sdk';
+import type { StudioCompose, StudioConfig, StudioTheme } from '../config.js';
+/** A `view` composition with `nodes` as its body. */
+export declare const defaultCompose: StudioCompose;
+/** The config's `compose`, else one that shows a lone node through `previewExample`. */
+export declare const composeOf: ({ compose, previewExample, }: Pick<StudioConfig, "compose" | "previewExample">) => StudioCompose | undefined;
+/** The one way the Studio, its static build, and `check` turn example nodes into a composition. */
+export declare const composeExample: (compose: StudioCompose | undefined, nodes: readonly PrimitiveNode[], theme: StudioTheme) => Composition;
+//# sourceMappingURL=compose_example.d.ts.map

package/dist/model/compose_example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose_example.d.ts","sourceRoot":"","sources":["../../src/model/compose_example.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1E,qDAAqD;AACrD,eAAO,MAAM,cAAc,EAAE,aAI3B,CAAC;AAEH,wFAAwF;AACxF,eAAO,MAAM,SAAS,GAAI,8BAGvB,IAAI,CAAC,YAAY,EAAE,SAAS,GAAG,gBAAgB,CAAC,KACjD,aAAa,GAAG,SAQX,CAAC;AAER,mGAAmG;AACnG,eAAO,MAAM,cAAc,GACzB,SAAS,aAAa,GAAG,SAAS,EAClC,OAAO,SAAS,aAAa,EAAE,EAC/B,OAAO,WAAW,KACjB,WAA4D,CAAC"}

package/dist/model/compose_example.js

@@ -0,0 +1,24 @@
+/*
+ * 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.
+ */
+/** A `view` composition with `nodes` as its body. */
+export const defaultCompose = (nodes, { theme }) => ({
+    type: 'view',
+    body: [...nodes],
+    theme,
+});
+/** The config's `compose`, else one that shows a lone node through `previewExample`. */
+export const composeOf = ({ compose, previewExample, }) => compose ??
+    (previewExample &&
+        ((nodes, { theme }) => {
+            const [only] = nodes;
+            return only && nodes.length === 1
+                ? { ...previewExample(only), theme }
+                : defaultCompose(nodes, { theme });
+        }));
+/** The one way the Studio, its static build, and `check` turn example nodes into a composition. */
+export const composeExample = (compose, nodes, theme) => (compose ?? defaultCompose)(nodes, { theme });
+//# sourceMappingURL=compose_example.js.map

package/dist/model/compose_example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose_example.js","sourceRoot":"","sources":["../../src/model/compose_example.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,qDAAqD;AACrD,MAAM,CAAC,MAAM,cAAc,GAAkB,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAClE,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC;IAChB,KAAK;CACN,CAAC,CAAC;AAEH,wFAAwF;AACxF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,EACxB,OAAO,EACP,cAAc,GACmC,EACvB,EAAE,CAC5B,OAAO;IACP,CAAC,cAAc;QACb,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACpB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;YACrB,OAAO,IAAI,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAC/B,CAAC,CAAC,EAAE,GAAG,cAAc,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE;gBACpC,CAAC,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC,CAAC;AAER,mGAAmG;AACnG,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,OAAkC,EAClC,KAA+B,EAC/B,KAAkB,EACL,EAAE,CAAC,CAAC,OAAO,IAAI,cAAc,CAAC,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,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 type { Composition, PrimitiveNode } from '@elastic/isomer-sdk';\n\nimport type { StudioCompose, StudioConfig, StudioTheme } from '../config';\n\n/** A `view` composition with `nodes` as its body. */\nexport const defaultCompose: StudioCompose = (nodes, { theme }) => ({\n  type: 'view',\n  body: [...nodes],\n  theme,\n});\n\n/** The config's `compose`, else one that shows a lone node through `previewExample`. */\nexport const composeOf = ({\n  compose,\n  previewExample,\n}: Pick<StudioConfig, 'compose' | 'previewExample'>):\n  StudioCompose | undefined =>\n  compose ??\n  (previewExample &&\n    ((nodes, { theme }) => {\n      const [only] = nodes;\n      return only && nodes.length === 1\n        ? { ...previewExample(only), theme }\n        : defaultCompose(nodes, { theme });\n    }));\n\n/** The one way the Studio, its static build, and `check` turn example nodes into a composition. */\nexport const composeExample = (\n  compose: StudioCompose | undefined,\n  nodes: readonly PrimitiveNode[],\n  theme: StudioTheme\n): Composition => (compose ?? defaultCompose)(nodes, { theme });\n"]}

package/dist/model/composition_key.d.ts

@@ -0,0 +1,6 @@
+import type { Composition } from '@elastic/isomer-sdk';
+/** JSON with sorted keys and no whitespace, dropping `undefined` properties as `JSON.stringify` does. */
+export declare const canonicalJson: (value: unknown) => string;
+/** The SHA-256 of `composition`'s canonical JSON, as hex; the same in Node and the browser. */
+export declare const compositionKey: (composition: Composition) => string;
+//# sourceMappingURL=composition_key.d.ts.map

package/dist/model/composition_key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition_key.d.ts","sourceRoot":"","sources":["../../src/model/composition_key.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAOvD,yGAAyG;AACzG,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,MAe9C,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,cAAc,GAAI,aAAa,WAAW,KAAG,MACO,CAAC"}

package/dist/model/composition_key.js

@@ -0,0 +1,26 @@
+/*
+ * 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 { sha256Hex } from './sha256.js';
+const isRecord = (value) => typeof value === 'object' && value !== null;
+/** JSON with sorted keys and no whitespace, dropping `undefined` properties as `JSON.stringify` does. */
+export const canonicalJson = (value) => {
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => (item === undefined ? 'null' : canonicalJson(item))).join(',')}]`;
+    }
+    if (isRecord(value)) {
+        const entries = Object.keys(value)
+            .sort()
+            .flatMap((key) => value[key] === undefined
+            ? []
+            : [`${JSON.stringify(key)}:${canonicalJson(value[key])}`]);
+        return `{${entries.join(',')}}`;
+    }
+    return JSON.stringify(value) ?? 'null';
+};
+/** The SHA-256 of `composition`'s canonical JSON, as hex; the same in Node and the browser. */
+export const compositionKey = (composition) => sha256Hex(new TextEncoder().encode(canonicalJson(composition)));
+//# sourceMappingURL=composition_key.js.map

package/dist/model/composition_key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composition_key.js","sourceRoot":"","sources":["../../src/model/composition_key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,QAAQ,GAAG,CAAC,KAAc,EAAoC,EAAE,CACpE,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AAE9C,yGAAyG;AACzG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAU,EAAE;IACtD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACnG,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC/B,IAAI,EAAE;aACN,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CACf,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;YACtB,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAC5D,CAAC;QACJ,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClC,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;AACzC,CAAC,CAAC;AAEF,+FAA+F;AAC/F,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,WAAwB,EAAU,EAAE,CACjE,SAAS,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,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 type { Composition } from '@elastic/isomer-sdk';\n\nimport { sha256Hex } from './sha256';\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null;\n\n/** JSON with sorted keys and no whitespace, dropping `undefined` properties as `JSON.stringify` does. */\nexport const canonicalJson = (value: unknown): string => {\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => (item === undefined ? 'null' : canonicalJson(item))).join(',')}]`;\n  }\n  if (isRecord(value)) {\n    const entries = Object.keys(value)\n      .sort()\n      .flatMap((key) =>\n        value[key] === undefined\n          ? []\n          : [`${JSON.stringify(key)}:${canonicalJson(value[key])}`]\n      );\n    return `{${entries.join(',')}}`;\n  }\n  return JSON.stringify(value) ?? 'null';\n};\n\n/** The SHA-256 of `composition`'s canonical JSON, as hex; the same in Node and the browser. */\nexport const compositionKey = (composition: Composition): string =>\n  sha256Hex(new TextEncoder().encode(canonicalJson(composition)));\n"]}

package/dist/model/describe_runtime.d.ts

@@ -0,0 +1,33 @@
+import type { PropDescriptor, RegisteredViewSummary, RuntimeSurfaces } from '@elastic/isomer-runtime';
+import type { AnyPrimitiveDefinition, PrimitiveCatalogEntry, PrimitiveGroup } from '@elastic/isomer-sdk';
+import type { StudioRuntime } from '../config.js';
+import type { AuthoringTypes } from './authoring_types.js';
+import type { StudioExample } from './read_examples.js';
+/** A surface the runtime can expose. */
+export type StudioSurface = keyof RuntimeSurfaces;
+/** Display names in display order, exhaustive over the runtime's surfaces so a new one fails the type check here. */
+export declare const SURFACE_LABELS: Readonly<Record<StudioSurface, string>>;
+/** The runtime's catalog entry for a primitive, plus what the Studio derives for display. */
+export interface PrimitiveDoc extends PrimitiveCatalogEntry {
+    label: string;
+    group: string;
+    examples: StudioExample[];
+    props: PropDescriptor[];
+    surfaces: StudioSurface[];
+    definition: AnyPrimitiveDefinition;
+}
+export interface RuntimeDocs {
+    primitives: PrimitiveDoc[];
+    /** The packs' groups in pack order, each sorted by label, then {@link UNCATEGORIZED_GROUP_TITLE} for ungrouped primitives. */
+    groups: PrimitiveGroup[];
+    views: RegisteredViewSummary[];
+    surfaces: StudioSurface[];
+    authoring: AuthoringTypes;
+}
+/** `statGroup` becomes `Stat group`, for a primitive whose catalog has no `name`. */
+export declare const humanize: (type: string) => string;
+/** Surfaces present on `runtime.surfaces`, in {@link SURFACE_LABELS} order; `snapshot` is absent without frames. */
+export declare const runtimeSurfaces: (runtime: Pick<StudioRuntime, "surfaces">) => StudioSurface[];
+/** Everything the Studio shows about a runtime, read from its public API. */
+export declare const describeRuntime: (runtime: StudioRuntime) => RuntimeDocs;
+//# sourceMappingURL=describe_runtime.d.ts.map