@elastic/isomer-studio 0.0.0 → 0.4.0

package/dist/node/build_site.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.
+ */
+import { cpSync, existsSync, mkdirSync, readdirSync, rmSync, writeFileSync, } from 'node:fs';
+import { join, relative, resolve, sep } from 'node:path';
+import { build } from 'esbuild';
+import { composeExample, composeOf } from '../model/compose_example.js';
+import { compositionKey } from '../model/composition_key.js';
+import { readExamples } from '../model/read_examples.js';
+import { APP_DIR, appBuildOptions, appStylesheets, renderIndexHtml, } from './app_bundle.js';
+import { createStudioImporter, loadStudioConfig } from './load_config.js';
+import { createRasterizer, imageFontsOf } from './rasterize.js';
+const THEMES = ['light', 'dark'];
+/** Rasterizes every example in both themes into `dir`, keyed by `compositionKey`, plus `manifest.json`. */
+export const prerenderPngs = async (config, rasterize, dir) => {
+    const { runtime } = config;
+    const compose = composeOf(config);
+    mkdirSync(dir, { recursive: true });
+    const manifest = { version: 1, entries: {} };
+    const failures = [];
+    for (const definition of runtime.primitives) {
+        for (const { name: example, node } of readExamples(definition)) {
+            for (const theme of THEMES) {
+                try {
+                    const composition = composeExample(compose, [node], theme);
+                    const key = compositionKey(composition);
+                    if (manifest.entries[key]) {
+                        continue;
+                    }
+                    const file = `${key}.png`;
+                    writeFileSync(join(dir, file), await rasterize(composition));
+                    manifest.entries[key] = {
+                        file,
+                        primitive: definition.type,
+                        example,
+                        theme,
+                    };
+                }
+                catch (error) {
+                    failures.push(`${definition.type} › ${example} (${theme}): ${error instanceof Error ? error.message : String(error)}`);
+                }
+            }
+        }
+    }
+    writeFileSync(join(dir, 'manifest.json'), `${JSON.stringify(manifest, null, 2)}\n`);
+    return { manifest, failures };
+};
+/** Written into every build, so a later build only clears a directory a Studio build made. */
+export const BUILD_MARKER = '.isomer-studio-build';
+/** Clears `out` for a new build, refusing a non-empty directory that is not a previous build. */
+export const prepareOut = (out) => {
+    if (existsSync(out) &&
+        readdirSync(out).length > 0 &&
+        !existsSync(join(out, BUILD_MARKER))) {
+        throw new Error(`${out} is not empty and holds no Studio build; pick another --out.`);
+    }
+    rmSync(out, { force: true, recursive: true });
+    mkdirSync(out, { recursive: true });
+    writeFileSync(join(out, BUILD_MARKER), '');
+};
+/** Writes the static Studio for `configPath` to `out`: the prebuilt assets, `app.js`, and the PNG manifest. */
+export const buildSite = async ({ configPath, out, base, loader, }) => {
+    const importModule = createStudioImporter(configPath, { loader });
+    const config = await loadStudioConfig(configPath, { importModule });
+    prepareOut(out);
+    cpSync(APP_DIR, out, { recursive: true });
+    const { metafile } = await build({
+        ...appBuildOptions({ configPath, assetsDir: join(out, 'assets') }),
+        metafile: true,
+    });
+    const { bundle, chunks } = appStylesheets(metafile);
+    chunks.forEach((chunk) => rmSync(resolve(chunk)));
+    writeFileSync(join(out, 'index.html'), renderIndexHtml({
+        base,
+        title: config.title,
+        stylesheets: bundle === undefined
+            ? []
+            : [relative(out, resolve(bundle)).split(sep).join('/')],
+    }));
+    const rasterize = createRasterizer(config.runtime, imageFontsOf(config, configPath, importModule));
+    if (!rasterize) {
+        return { pngs: 0, failures: [] };
+    }
+    const { manifest, failures } = await prerenderPngs(config, rasterize, join(out, 'png'));
+    return { pngs: Object.keys(manifest.entries).length, failures };
+};
+//# sourceMappingURL=build_site.js.map

package/dist/node/build_site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build_site.js","sourceRoot":"","sources":["../../src/node/build_site.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  cpSync,\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  rmSync,\n  writeFileSync,\n} from 'node:fs';\nimport { join, relative, resolve, sep } from 'node:path';\n\nimport { build } from 'esbuild';\n\nimport type { StudioConfig, StudioTheme } from '../config';\nimport { composeExample, composeOf } from '../model/compose_example';\nimport { compositionKey } from '../model/composition_key';\nimport type { PngManifest } from '../model/png_manifest';\nimport { readExamples } from '../model/read_examples';\n\nimport {\n  APP_DIR,\n  appBuildOptions,\n  appStylesheets,\n  renderIndexHtml,\n} from './app_bundle';\nimport type { ConfigLoader } from './load_config';\nimport { createStudioImporter, loadStudioConfig } from './load_config';\nimport type { NodeRasterizer } from './rasterize';\nimport { createRasterizer, imageFontsOf } from './rasterize';\n\nconst THEMES: readonly StudioTheme[] = ['light', 'dark'];\n\nexport interface PrerenderResult {\n  manifest: PngManifest;\n  /** Examples that could not be rasterized, as `primitive › example (theme): message`. */\n  failures: string[];\n}\n\n/** Rasterizes every example in both themes into `dir`, keyed by `compositionKey`, plus `manifest.json`. */\nexport const prerenderPngs = async (\n  config: StudioConfig,\n  rasterize: NodeRasterizer,\n  dir: string\n): Promise<PrerenderResult> => {\n  const { runtime } = config;\n  const compose = composeOf(config);\n  mkdirSync(dir, { recursive: true });\n  const manifest: PngManifest = { version: 1, entries: {} };\n  const failures: string[] = [];\n\n  for (const definition of runtime.primitives) {\n    for (const { name: example, node } of readExamples(definition)) {\n      for (const theme of THEMES) {\n        try {\n          const composition = composeExample(compose, [node], theme);\n          const key = compositionKey(composition);\n          if (manifest.entries[key]) {\n            continue;\n          }\n          const file = `${key}.png`;\n          writeFileSync(join(dir, file), await rasterize(composition));\n          manifest.entries[key] = {\n            file,\n            primitive: definition.type,\n            example,\n            theme,\n          };\n        } catch (error) {\n          failures.push(\n            `${definition.type} › ${example} (${theme}): ${error instanceof Error ? error.message : String(error)}`\n          );\n        }\n      }\n    }\n  }\n\n  writeFileSync(\n    join(dir, 'manifest.json'),\n    `${JSON.stringify(manifest, null, 2)}\\n`\n  );\n  return { manifest, failures };\n};\n\n/** Written into every build, so a later build only clears a directory a Studio build made. */\nexport const BUILD_MARKER = '.isomer-studio-build';\n\n/** Clears `out` for a new build, refusing a non-empty directory that is not a previous build. */\nexport const prepareOut = (out: string): void => {\n  if (\n    existsSync(out) &&\n    readdirSync(out).length > 0 &&\n    !existsSync(join(out, BUILD_MARKER))\n  ) {\n    throw new Error(\n      `${out} is not empty and holds no Studio build; pick another --out.`\n    );\n  }\n  rmSync(out, { force: true, recursive: true });\n  mkdirSync(out, { recursive: true });\n  writeFileSync(join(out, BUILD_MARKER), '');\n};\n\nexport interface BuildSiteOptions {\n  configPath: string;\n  out: string;\n  base: string;\n  loader?: ConfigLoader | undefined;\n}\n\nexport interface BuildSiteResult {\n  pngs: number;\n  failures: string[];\n}\n\n/** Writes the static Studio for `configPath` to `out`: the prebuilt assets, `app.js`, and the PNG manifest. */\nexport const buildSite = async ({\n  configPath,\n  out,\n  base,\n  loader,\n}: BuildSiteOptions): Promise<BuildSiteResult> => {\n  const importModule = createStudioImporter(configPath, { loader });\n  const config = await loadStudioConfig(configPath, { importModule });\n  prepareOut(out);\n  cpSync(APP_DIR, out, { recursive: true });\n  const { metafile } = await build({\n    ...appBuildOptions({ configPath, assetsDir: join(out, 'assets') }),\n    metafile: true,\n  });\n  const { bundle, chunks } = appStylesheets(metafile);\n  chunks.forEach((chunk) => rmSync(resolve(chunk)));\n  writeFileSync(\n    join(out, 'index.html'),\n    renderIndexHtml({\n      base,\n      title: config.title,\n      stylesheets:\n        bundle === undefined\n          ? []\n          : [relative(out, resolve(bundle)).split(sep).join('/')],\n    })\n  );\n\n  const rasterize = createRasterizer(\n    config.runtime,\n    imageFontsOf(config, configPath, importModule)\n  );\n  if (!rasterize) {\n    return { pngs: 0, failures: [] };\n  }\n  const { manifest, failures } = await prerenderPngs(\n    config,\n    rasterize,\n    join(out, 'png')\n  );\n  return { pngs: Object.keys(manifest.entries).length, failures };\n};\n"]}

package/dist/node/check.d.ts

@@ -0,0 +1,40 @@
+import type { ReactNode } from 'react';
+import type { Composition } from '@elastic/isomer-sdk';
+import type { StudioConfig, StudioTheme } from '../config.js';
+import type { StudioSurface } from '../model/describe_runtime.js';
+export type CheckStatus = 'passed' | 'failed' | 'skipped';
+/** What one result checked: a primitive's icon, an example's props, or one surface. */
+export type CheckName = StudioSurface | 'icon' | 'png' | 'props';
+export interface CheckResult {
+    /** A primitive's type, or `app:<id>` for a Studio app's checks. */
+    primitive: string;
+    /** Absent for checks on the primitive itself, such as `icon`. */
+    example?: string | undefined;
+    check: CheckName;
+    status: CheckStatus;
+    message?: string | undefined;
+}
+export interface CheckReport {
+    title: string;
+    /** How many apps the config lists; `check` never loads them. */
+    apps: number;
+    results: CheckResult[];
+    passed: number;
+    failed: number;
+    skipped: number;
+}
+export interface CheckOptions {
+    /** `react-dom/server`'s `renderToString`, from the config's React. */
+    renderToString: (node: ReactNode) => string;
+    /** Limits the surfaces rendered; defaults to every surface the runtime has. */
+    surfaces?: readonly StudioSurface[] | undefined;
+    /** Rasterizes each composition as the `png` check; absent skips it. */
+    rasterizePng?: ((composition: Composition) => Promise<unknown>) | undefined;
+    theme?: StudioTheme | undefined;
+}
+/**
+ * Validates and renders every example of every primitive, composed as the Studio composes it, on every surface
+ * the runtime has. Surfaces the runtime or a primitive lacks are skipped, not failed.
+ */
+export declare const checkStudio: (config: StudioConfig, { renderToString, surfaces: only, rasterizePng, theme, }: CheckOptions) => Promise<CheckReport>;
+//# sourceMappingURL=check.d.ts.map

package/dist/node/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/node/check.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAEV,WAAW,EAEZ,MAAM,qBAAqB,CAAC;AAI7B,OAAO,KAAK,EAAE,YAAY,EAAiB,WAAW,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK/D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D,uFAAuF;AACvF,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;AAEjE,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,cAAc,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAAC;IAC5C,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,SAAS,CAAC;IAChD,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC;IAC5E,KAAK,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACjC;AA2FD;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,YAAY,EACpB,0DAKG,YAAY,KACd,OAAO,CAAC,WAAW,CAiGrB,CAAC"}

package/dist/node/check.js

@@ -0,0 +1,162 @@
+/*
+ * 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 { formatValidationError } from '@elastic/isomer-sdk';
+import { assertPackIconsValid } from '@elastic/isomer-sdk/testing';
+import { composeExample, composeOf } from '../model/compose_example.js';
+import { runtimeSurfaces } from '../model/describe_runtime.js';
+import { readExamples } from '../model/read_examples.js';
+import { slackLimitProblems } from '../model/slack_limits.js';
+const PASSED = { status: 'passed' };
+const describeError = (error) => error instanceof Error ? error.message : String(error);
+const fromProblems = (problems) => problems.length ? { status: 'failed', message: problems.join('\n') } : PASSED;
+const attempt = (check) => {
+    try {
+        return fromProblems(check());
+    }
+    catch (error) {
+        return { status: 'failed', message: describeError(error) };
+    }
+};
+const attemptAsync = async (check) => {
+    try {
+        await check();
+        return PASSED;
+    }
+    catch (error) {
+        return { status: 'failed', message: describeError(error) };
+    }
+};
+/** Renders `composition` on `surface`, returning what Slack would refuse; a render that throws fails. */
+const renderSurface = (runtime, surface, composition, renderToString) => {
+    const { surfaces } = runtime;
+    switch (surface) {
+        case 'react':
+            renderToString(surfaces.react.render(composition, { wrapper: true }));
+            return [];
+        case 'html':
+            surfaces.html.render(composition);
+            return [];
+        case 'markdown':
+            surfaces.markdown.render(composition);
+            return [];
+        case 'text':
+            surfaces.text.render(composition);
+            return [];
+        case 'slack':
+            return slackLimitProblems(surfaces.slack.render(composition));
+        case 'snapshot':
+            surfaces.snapshot?.render(composition);
+            return [];
+    }
+};
+const iconOutcome = (pack, { type, icon }) => {
+    const found = pack.icons?.[type] ?? icon;
+    if (!found) {
+        return { status: 'failed', message: `\`${type}\` has no icon.` };
+    }
+    return attempt(() => {
+        assertPackIconsValid({ icons: { [type]: found }, primitives: [] });
+        return [];
+    });
+};
+const summarize = (title, apps, results) => {
+    const count = (status) => results.filter((result) => result.status === status).length;
+    return {
+        title,
+        apps,
+        results,
+        passed: count('passed'),
+        failed: count('failed'),
+        skipped: count('skipped'),
+    };
+};
+/**
+ * Validates and renders every example of every primitive, composed as the Studio composes it, on every surface
+ * the runtime has. Surfaces the runtime or a primitive lacks are skipped, not failed.
+ */
+export const checkStudio = async (config, { renderToString, surfaces: only, rasterizePng, theme = 'light', }) => {
+    const { runtime, apps = [], title = 'Isomer Studio' } = config;
+    const compose = composeOf(config);
+    const { support } = runtime.getCapabilities();
+    const available = runtimeSurfaces(runtime);
+    const surfaces = only
+        ? only.filter((surface) => available.includes(surface))
+        : available;
+    const results = apps.flatMap(({ id, icon }) => icon
+        ? [
+            {
+                primitive: `app:${id}`,
+                check: 'icon',
+                ...attempt(() => {
+                    assertPackIconsValid({ icons: { [id]: icon }, primitives: [] });
+                    return [];
+                }),
+            },
+        ]
+        : []);
+    for (const pack of runtime.packs) {
+        for (const definition of pack.primitives) {
+            const { type: primitive } = definition;
+            results.push({
+                primitive,
+                check: 'icon',
+                ...iconOutcome(pack, definition),
+            });
+            for (const { name: example, node } of readExamples(definition)) {
+                const skipAll = (message) => [...surfaces, ...(rasterizePng ? ['png'] : [])].forEach((check) => results.push({
+                    primitive,
+                    example,
+                    check,
+                    status: 'skipped',
+                    message,
+                }));
+                let composition;
+                try {
+                    composition = composeExample(compose, [node], theme);
+                }
+                catch (error) {
+                    results.push({
+                        primitive,
+                        example,
+                        check: 'props',
+                        status: 'failed',
+                        message: `\`compose\` threw: ${describeError(error)}`,
+                    });
+                    skipAll('The example could not be composed.');
+                    continue;
+                }
+                const validation = runtime.validate(composition);
+                const props = fromProblems(validation.errors.map(formatValidationError));
+                results.push({ primitive, example, check: 'props', ...props });
+                if (props.status === 'failed') {
+                    skipAll('The composition is invalid.');
+                    continue;
+                }
+                for (const surface of surfaces) {
+                    const outcome = support[primitive]?.[surface] === 'native'
+                        ? attempt(() => renderSurface(runtime, surface, composition, renderToString))
+                        : {
+                            status: 'skipped',
+                            message: `\`${primitive}\` has no ${surface} renderer.`,
+                        };
+                    results.push({ primitive, example, check: surface, ...outcome });
+                }
+                if (rasterizePng) {
+                    const outcome = available.includes('snapshot')
+                        ? await attemptAsync(() => rasterizePng(composition))
+                        : {
+                            status: 'skipped',
+                            message: 'The runtime has no snapshot surface.',
+                        };
+                    results.push({ primitive, example, check: 'png', ...outcome });
+                }
+            }
+        }
+    }
+    return summarize(title, apps.length, results);
+};
+//# sourceMappingURL=check.js.map

package/dist/node/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../../src/node/check.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { ReactNode } from 'react';\nimport type {\n  AnyPrimitiveDefinition,\n  Composition,\n  PrimitivePack,\n} from '@elastic/isomer-sdk';\nimport { formatValidationError } from '@elastic/isomer-sdk';\nimport { assertPackIconsValid } from '@elastic/isomer-sdk/testing';\n\nimport type { StudioConfig, StudioRuntime, StudioTheme } from '../config';\nimport { composeExample, composeOf } from '../model/compose_example';\nimport type { StudioSurface } from '../model/describe_runtime';\nimport { runtimeSurfaces } from '../model/describe_runtime';\nimport { readExamples } from '../model/read_examples';\nimport { slackLimitProblems } from '../model/slack_limits';\n\nexport type CheckStatus = 'passed' | 'failed' | 'skipped';\n\n/** What one result checked: a primitive's icon, an example's props, or one surface. */\nexport type CheckName = StudioSurface | 'icon' | 'png' | 'props';\n\nexport interface CheckResult {\n  /** A primitive's type, or `app:<id>` for a Studio app's checks. */\n  primitive: string;\n  /** Absent for checks on the primitive itself, such as `icon`. */\n  example?: string | undefined;\n  check: CheckName;\n  status: CheckStatus;\n  message?: string | undefined;\n}\n\nexport interface CheckReport {\n  title: string;\n  /** How many apps the config lists; `check` never loads them. */\n  apps: number;\n  results: CheckResult[];\n  passed: number;\n  failed: number;\n  skipped: number;\n}\n\nexport interface CheckOptions {\n  /** `react-dom/server`'s `renderToString`, from the config's React. */\n  renderToString: (node: ReactNode) => string;\n  /** Limits the surfaces rendered; defaults to every surface the runtime has. */\n  surfaces?: readonly StudioSurface[] | undefined;\n  /** Rasterizes each composition as the `png` check; absent skips it. */\n  rasterizePng?: ((composition: Composition) => Promise<unknown>) | undefined;\n  theme?: StudioTheme | undefined;\n}\n\ntype Outcome = Pick<CheckResult, 'message' | 'status'>;\n\nconst PASSED: Outcome = { status: 'passed' };\n\nconst describeError = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nconst fromProblems = (problems: readonly string[]): Outcome =>\n  problems.length ? { status: 'failed', message: problems.join('\\n') } : PASSED;\n\nconst attempt = (check: () => readonly string[]): Outcome => {\n  try {\n    return fromProblems(check());\n  } catch (error) {\n    return { status: 'failed', message: describeError(error) };\n  }\n};\n\nconst attemptAsync = async (\n  check: () => Promise<unknown>\n): Promise<Outcome> => {\n  try {\n    await check();\n    return PASSED;\n  } catch (error) {\n    return { status: 'failed', message: describeError(error) };\n  }\n};\n\n/** Renders `composition` on `surface`, returning what Slack would refuse; a render that throws fails. */\nconst renderSurface = (\n  runtime: StudioRuntime,\n  surface: StudioSurface,\n  composition: Composition,\n  renderToString: CheckOptions['renderToString']\n): readonly string[] => {\n  const { surfaces } = runtime;\n  switch (surface) {\n    case 'react':\n      renderToString(surfaces.react.render(composition, { wrapper: true }));\n      return [];\n    case 'html':\n      surfaces.html.render(composition);\n      return [];\n    case 'markdown':\n      surfaces.markdown.render(composition);\n      return [];\n    case 'text':\n      surfaces.text.render(composition);\n      return [];\n    case 'slack':\n      return slackLimitProblems(surfaces.slack.render(composition));\n    case 'snapshot':\n      surfaces.snapshot?.render(composition);\n      return [];\n  }\n};\n\nconst iconOutcome = (\n  pack: PrimitivePack<never>,\n  { type, icon }: AnyPrimitiveDefinition\n): Outcome => {\n  const found = pack.icons?.[type] ?? icon;\n  if (!found) {\n    return { status: 'failed', message: `\\`${type}\\` has no icon.` };\n  }\n  return attempt(() => {\n    assertPackIconsValid({ icons: { [type]: found }, primitives: [] });\n    return [];\n  });\n};\n\nconst summarize = (\n  title: string,\n  apps: number,\n  results: CheckResult[]\n): CheckReport => {\n  const count = (status: CheckStatus) =>\n    results.filter((result) => result.status === status).length;\n  return {\n    title,\n    apps,\n    results,\n    passed: count('passed'),\n    failed: count('failed'),\n    skipped: count('skipped'),\n  };\n};\n\n/**\n * Validates and renders every example of every primitive, composed as the Studio composes it, on every surface\n * the runtime has. Surfaces the runtime or a primitive lacks are skipped, not failed.\n */\nexport const checkStudio = async (\n  config: StudioConfig,\n  {\n    renderToString,\n    surfaces: only,\n    rasterizePng,\n    theme = 'light',\n  }: CheckOptions\n): Promise<CheckReport> => {\n  const { runtime, apps = [], title = 'Isomer Studio' } = config;\n  const compose = composeOf(config);\n  const { support } = runtime.getCapabilities();\n  const available = runtimeSurfaces(runtime);\n  const surfaces = only\n    ? only.filter((surface) => available.includes(surface))\n    : available;\n  const results: CheckResult[] = apps.flatMap(({ id, icon }) =>\n    icon\n      ? [\n          {\n            primitive: `app:${id}`,\n            check: 'icon' as const,\n            ...attempt(() => {\n              assertPackIconsValid({ icons: { [id]: icon }, primitives: [] });\n              return [];\n            }),\n          },\n        ]\n      : []\n  );\n\n  for (const pack of runtime.packs) {\n    for (const definition of pack.primitives) {\n      const { type: primitive } = definition;\n      results.push({\n        primitive,\n        check: 'icon',\n        ...iconOutcome(pack, definition),\n      });\n\n      for (const { name: example, node } of readExamples(definition)) {\n        const skipAll = (message: string) =>\n          [...surfaces, ...(rasterizePng ? (['png'] as const) : [])].forEach(\n            (check) =>\n              results.push({\n                primitive,\n                example,\n                check,\n                status: 'skipped',\n                message,\n              })\n          );\n\n        let composition: Composition;\n        try {\n          composition = composeExample(compose, [node], theme);\n        } catch (error) {\n          results.push({\n            primitive,\n            example,\n            check: 'props',\n            status: 'failed',\n            message: `\\`compose\\` threw: ${describeError(error)}`,\n          });\n          skipAll('The example could not be composed.');\n          continue;\n        }\n\n        const validation = runtime.validate(composition);\n        const props = fromProblems(\n          validation.errors.map(formatValidationError)\n        );\n        results.push({ primitive, example, check: 'props', ...props });\n        if (props.status === 'failed') {\n          skipAll('The composition is invalid.');\n          continue;\n        }\n\n        for (const surface of surfaces) {\n          const outcome: Outcome =\n            support[primitive]?.[surface] === 'native'\n              ? attempt(() =>\n                  renderSurface(runtime, surface, composition, renderToString)\n                )\n              : {\n                  status: 'skipped',\n                  message: `\\`${primitive}\\` has no ${surface} renderer.`,\n                };\n          results.push({ primitive, example, check: surface, ...outcome });\n        }\n\n        if (rasterizePng) {\n          const outcome: Outcome = available.includes('snapshot')\n            ? await attemptAsync(() => rasterizePng(composition))\n            : {\n                status: 'skipped',\n                message: 'The runtime has no snapshot surface.',\n              };\n          results.push({ primitive, example, check: 'png', ...outcome });\n        }\n      }\n    }\n  }\n\n  return summarize(title, apps.length, results);\n};\n"]}

package/dist/node/dev_bundle.d.ts

@@ -0,0 +1,21 @@
+import type { Server } from 'node:http';
+import type { EnvironmentModuleNode, InlineConfig, Plugin } from 'vite';
+/** The URL the dev page loads the entry from. */
+export declare const DEV_ENTRY_URL = "/@id/virtual:isomer-studio/app";
+/** `modules` and every module that imports one of them, transitively. */
+export declare const withImporters: <T extends {
+    importers: Iterable<T>;
+}>(modules: Iterable<T>) => Set<T>;
+/** Receives the server-side modules a change invalidates, when they include the config or a file it reloads with. */
+export type ConfigChangeHandler = (stale: ReadonlySet<EnvironmentModuleNode>) => Promise<void>;
+/** Vite's counterpart to the static build's `projectResolution`. */
+export declare const projectResolutionPlugin: (configPath: string) => Plugin;
+/** Vite options for `isomer-studio dev`: HMR over `server`, React Fast Refresh, and `onConfigChange` before the browser receives an update that re-runs the config. */
+export declare const devViteConfig: ({ configPath, server, onConfigChange, reloadsWith, }: {
+    configPath: string;
+    server: Server;
+    onConfigChange: ConfigChangeHandler;
+    /** Server-side entries other than the config, such as its `imageFonts` module, whose changes also re-run it. */
+    reloadsWith?: (() => Iterable<string>) | undefined;
+}) => InlineConfig;
+//# sourceMappingURL=dev_bundle.d.ts.map

package/dist/node/dev_bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev_bundle.d.ts","sourceRoot":"","sources":["../../src/node/dev_bundle.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAmBxE,iDAAiD;AACjD,eAAO,MAAM,aAAa,mCAAkB,CAAC;AAE7C,yEAAyE;AACzE,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS;IAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAA;CAAE,EAChE,SAAS,QAAQ,CAAC,CAAC,CAAC,KACnB,GAAG,CAAC,CAAC,CAUP,CAAC;AAEF,qHAAqH;AACrH,MAAM,MAAM,mBAAmB,GAAG,CAChC,KAAK,EAAE,WAAW,CAAC,qBAAqB,CAAC,KACtC,OAAO,CAAC,IAAI,CAAC,CAAC;AA4BnB,oEAAoE;AACpE,eAAO,MAAM,uBAAuB,GAAI,YAAY,MAAM,KAAG,MAgC5D,CAAC;AAEF,uKAAuK;AACvK,eAAO,MAAM,aAAa,GAAI,sDAK3B;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,mBAAmB,CAAC;IACpC,gHAAgH;IAChH,WAAW,CAAC,EAAE,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACpD,KAAG,YAuCH,CAAC"}

package/dist/node/dev_bundle.js

@@ -0,0 +1,121 @@
+/*
+ * 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 { dirname, join } from 'node:path';
+import react from '@vitejs/plugin-react';
+import { normalizePath, searchForWorkspaceRoot } from 'vite';
+import { appEntry, browserModule, PACKAGE_DIR, RUNS_FROM_SOURCE, } from './app_bundle.js';
+import { installDirectory, isStudioSpecifier, projectDirectory, sharedResolveDir, } from './project_resolution.js';
+const ENTRY = 'virtual:isomer-studio/app';
+const RESOLVED_ENTRY = `\0${ENTRY}`;
+/** The URL the dev page loads the entry from. */
+export const DEV_ENTRY_URL = `/@id/${ENTRY}`;
+/** `modules` and every module that imports one of them, transitively. */
+export const withImporters = (modules) => {
+    const found = new Set();
+    const pending = [...modules];
+    for (let next = pending.pop(); next; next = pending.pop()) {
+        if (!found.has(next)) {
+            found.add(next);
+            pending.push(...next.importers);
+        }
+    }
+    return found;
+};
+const studioEntry = (configPath, onConfigChange, reloadsWith) => {
+    const configFile = normalizePath(configPath);
+    return {
+        name: 'isomer-studio-entry',
+        resolveId: (id) => (id === ENTRY ? RESOLVED_ENTRY : undefined),
+        load: (id) => id === RESOLVED_ENTRY ? appEntry(configPath, 'dev') : undefined,
+        hotUpdate: async function ({ modules }) {
+            if (this.environment.name !== 'ssr') {
+                return;
+            }
+            const stale = withImporters(modules);
+            const roots = new Set([configFile, ...reloadsWith()]);
+            if (![...stale].some(({ file }) => file !== null && roots.has(file))) {
+                return;
+            }
+            await onConfigChange(stale);
+            return [];
+        },
+    };
+};
+/** Vite's counterpart to the static build's `projectResolution`. */
+export const projectResolutionPlugin = (configPath) => {
+    const projectDir = projectDirectory(configPath);
+    const parentIn = (dir) => join(dir, 'package.json');
+    return {
+        name: 'isomer-studio-project-resolution',
+        enforce: 'pre',
+        resolveId: async function (source, importer, options) {
+            const shared = sharedResolveDir(source, importer, projectDir);
+            if (shared !== undefined) {
+                const resolved = await this.resolve(source, parentIn(shared), {
+                    ...options,
+                    skipSelf: true,
+                });
+                if (resolved) {
+                    return resolved;
+                }
+            }
+            if (!isStudioSpecifier(source)) {
+                return undefined;
+            }
+            return ((await this.resolve(source, importer, {
+                ...options,
+                skipSelf: true,
+            })) ??
+                this.resolve(source, parentIn(PACKAGE_DIR), {
+                    ...options,
+                    skipSelf: true,
+                }));
+        },
+    };
+};
+/** Vite options for `isomer-studio dev`: HMR over `server`, React Fast Refresh, and `onConfigChange` before the browser receives an update that re-runs the config. */
+export const devViteConfig = ({ configPath, server, onConfigChange, reloadsWith = () => [], }) => {
+    const root = dirname(configPath);
+    return {
+        configFile: false,
+        root,
+        appType: 'custom',
+        clearScreen: false,
+        logLevel: 'info',
+        server: {
+            middlewareMode: true,
+            hmr: { server },
+            fs: {
+                allow: [
+                    searchForWorkspaceRoot(root),
+                    PACKAGE_DIR,
+                    installDirectory(PACKAGE_DIR),
+                ],
+            },
+        },
+        resolve: { dedupe: ['react', 'react-dom'] },
+        define: { global: 'globalThis' },
+        // The dependency scanner crawls these when `optimizeDeps.entries` is unset; the virtual entry itself is not on disk.
+        build: {
+            rolldownOptions: {
+                input: [configPath, browserModule('mount'), browserModule('dev_host')],
+            },
+        },
+        optimizeDeps: {
+            // The scanner ignores tsconfig, so it misses the Emotion JSX runtime the Studio's own `.tsx` compiles to.
+            include: RUNS_FROM_SOURCE
+                ? ['@elastic/isomer-studio > @emotion/react/jsx-dev-runtime']
+                : [],
+        },
+        plugins: [
+            projectResolutionPlugin(configPath),
+            studioEntry(configPath, onConfigChange, reloadsWith),
+            react(),
+        ],
+    };
+};
+//# sourceMappingURL=dev_bundle.js.map

package/dist/node/dev_bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev_bundle.js","sourceRoot":"","sources":["../../src/node/dev_bundle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C,OAAO,KAAK,MAAM,sBAAsB,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,MAAM,CAAC;AAE7D,OAAO,EACL,QAAQ,EACR,aAAa,EACb,WAAW,EACX,gBAAgB,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,KAAK,GAAG,2BAA2B,CAAC;AAC1C,MAAM,cAAc,GAAG,KAAK,KAAK,EAAE,CAAC;AAEpC,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,QAAQ,KAAK,EAAE,CAAC;AAE7C,yEAAyE;AACzE,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,OAAoB,EACZ,EAAE;IACV,MAAM,KAAK,GAAG,IAAI,GAAG,EAAK,CAAC;IAC3B,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC;IAC7B,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAOF,MAAM,WAAW,GAAG,CAClB,UAAkB,EAClB,cAAmC,EACnC,WAAmC,EAC3B,EAAE;IACV,MAAM,UAAU,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CACX,EAAE,KAAK,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QACjE,SAAS,EAAE,KAAK,WAAW,EAAE,OAAO,EAAE;YACpC,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBACpC,OAAO;YACT,CAAC;YACD,MAAM,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACrE,OAAO;YACT,CAAC;YACD,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,UAAkB,EAAU,EAAE;IACpE,MAAM,UAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC5D,OAAO;QACL,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,KAAK;QACd,SAAS,EAAE,KAAK,WAAW,MAAM,EAAE,QAAQ,EAAE,OAAO;YAClD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;YAC9D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE;oBAC5D,GAAG,OAAO;oBACV,QAAQ,EAAE,IAAI;iBACf,CAAC,CAAC;gBACH,IAAI,QAAQ,EAAE,CAAC;oBACb,OAAO,QAAQ,CAAC;gBAClB,CAAC;YACH,CAAC;YACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,OAAO,CACL,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE;gBACpC,GAAG,OAAO;gBACV,QAAQ,EAAE,IAAI;aACf,CAAC,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE;oBAC1C,GAAG,OAAO;oBACV,QAAQ,EAAE,IAAI;iBACf,CAAC,CACH,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,uKAAuK;AACvK,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,EAC5B,UAAU,EACV,MAAM,EACN,cAAc,EACd,WAAW,GAAG,GAAG,EAAE,CAAC,EAAE,GAOvB,EAAgB,EAAE;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,OAAO;QACL,UAAU,EAAE,KAAK;QACjB,IAAI;QACJ,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,KAAK;QAClB,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE;YACN,cAAc,EAAE,IAAI;YACpB,GAAG,EAAE,EAAE,MAAM,EAAE;YACf,EAAE,EAAE;gBACF,KAAK,EAAE;oBACL,sBAAsB,CAAC,IAAI,CAAC;oBAC5B,WAAW;oBACX,gBAAgB,CAAC,WAAW,CAAC;iBAC9B;aACF;SACF;QACD,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE;QAC3C,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;QAChC,qHAAqH;QACrH,KAAK,EAAE;YACL,eAAe,EAAE;gBACf,KAAK,EAAE,CAAC,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;aACvE;SACF;QACD,YAAY,EAAE;YACZ,0GAA0G;YAC1G,OAAO,EAAE,gBAAgB;gBACvB,CAAC,CAAC,CAAC,yDAAyD,CAAC;gBAC7D,CAAC,CAAC,EAAE;SACP;QACD,OAAO,EAAE;YACP,uBAAuB,CAAC,UAAU,CAAC;YACnC,WAAW,CAAC,UAAU,EAAE,cAAc,EAAE,WAAW,CAAC;YACpD,KAAK,EAAE;SACR;KACF,CAAC;AACJ,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 { Server } from 'node:http';\nimport { dirname, join } from 'node:path';\n\nimport react from '@vitejs/plugin-react';\nimport type { EnvironmentModuleNode, InlineConfig, Plugin } from 'vite';\nimport { normalizePath, searchForWorkspaceRoot } from 'vite';\n\nimport {\n  appEntry,\n  browserModule,\n  PACKAGE_DIR,\n  RUNS_FROM_SOURCE,\n} from './app_bundle';\nimport {\n  installDirectory,\n  isStudioSpecifier,\n  projectDirectory,\n  sharedResolveDir,\n} from './project_resolution';\n\nconst ENTRY = 'virtual:isomer-studio/app';\nconst RESOLVED_ENTRY = `\\0${ENTRY}`;\n\n/** The URL the dev page loads the entry from. */\nexport const DEV_ENTRY_URL = `/@id/${ENTRY}`;\n\n/** `modules` and every module that imports one of them, transitively. */\nexport const withImporters = <T extends { importers: Iterable<T> }>(\n  modules: Iterable<T>\n): Set<T> => {\n  const found = new Set<T>();\n  const pending = [...modules];\n  for (let next = pending.pop(); next; next = pending.pop()) {\n    if (!found.has(next)) {\n      found.add(next);\n      pending.push(...next.importers);\n    }\n  }\n  return found;\n};\n\n/** Receives the server-side modules a change invalidates, when they include the config or a file it reloads with. */\nexport type ConfigChangeHandler = (\n  stale: ReadonlySet<EnvironmentModuleNode>\n) => Promise<void>;\n\nconst studioEntry = (\n  configPath: string,\n  onConfigChange: ConfigChangeHandler,\n  reloadsWith: () => Iterable<string>\n): Plugin => {\n  const configFile = normalizePath(configPath);\n  return {\n    name: 'isomer-studio-entry',\n    resolveId: (id) => (id === ENTRY ? RESOLVED_ENTRY : undefined),\n    load: (id) =>\n      id === RESOLVED_ENTRY ? appEntry(configPath, 'dev') : undefined,\n    hotUpdate: async function ({ modules }) {\n      if (this.environment.name !== 'ssr') {\n        return;\n      }\n      const stale = withImporters(modules);\n      const roots = new Set([configFile, ...reloadsWith()]);\n      if (![...stale].some(({ file }) => file !== null && roots.has(file))) {\n        return;\n      }\n      await onConfigChange(stale);\n      return [];\n    },\n  };\n};\n\n/** Vite's counterpart to the static build's `projectResolution`. */\nexport const projectResolutionPlugin = (configPath: string): Plugin => {\n  const projectDir = projectDirectory(configPath);\n  const parentIn = (dir: string) => join(dir, 'package.json');\n  return {\n    name: 'isomer-studio-project-resolution',\n    enforce: 'pre',\n    resolveId: async function (source, importer, options) {\n      const shared = sharedResolveDir(source, importer, projectDir);\n      if (shared !== undefined) {\n        const resolved = await this.resolve(source, parentIn(shared), {\n          ...options,\n          skipSelf: true,\n        });\n        if (resolved) {\n          return resolved;\n        }\n      }\n      if (!isStudioSpecifier(source)) {\n        return undefined;\n      }\n      return (\n        (await this.resolve(source, importer, {\n          ...options,\n          skipSelf: true,\n        })) ??\n        this.resolve(source, parentIn(PACKAGE_DIR), {\n          ...options,\n          skipSelf: true,\n        })\n      );\n    },\n  };\n};\n\n/** Vite options for `isomer-studio dev`: HMR over `server`, React Fast Refresh, and `onConfigChange` before the browser receives an update that re-runs the config. */\nexport const devViteConfig = ({\n  configPath,\n  server,\n  onConfigChange,\n  reloadsWith = () => [],\n}: {\n  configPath: string;\n  server: Server;\n  onConfigChange: ConfigChangeHandler;\n  /** Server-side entries other than the config, such as its `imageFonts` module, whose changes also re-run it. */\n  reloadsWith?: (() => Iterable<string>) | undefined;\n}): InlineConfig => {\n  const root = dirname(configPath);\n  return {\n    configFile: false,\n    root,\n    appType: 'custom',\n    clearScreen: false,\n    logLevel: 'info',\n    server: {\n      middlewareMode: true,\n      hmr: { server },\n      fs: {\n        allow: [\n          searchForWorkspaceRoot(root),\n          PACKAGE_DIR,\n          installDirectory(PACKAGE_DIR),\n        ],\n      },\n    },\n    resolve: { dedupe: ['react', 'react-dom'] },\n    define: { global: 'globalThis' },\n    // The dependency scanner crawls these when `optimizeDeps.entries` is unset; the virtual entry itself is not on disk.\n    build: {\n      rolldownOptions: {\n        input: [configPath, browserModule('mount'), browserModule('dev_host')],\n      },\n    },\n    optimizeDeps: {\n      // The scanner ignores tsconfig, so it misses the Emotion JSX runtime the Studio's own `.tsx` compiles to.\n      include: RUNS_FROM_SOURCE\n        ? ['@elastic/isomer-studio > @emotion/react/jsx-dev-runtime']\n        : [],\n    },\n    plugins: [\n      projectResolutionPlugin(configPath),\n      studioEntry(configPath, onConfigChange, reloadsWith),\n      react(),\n    ],\n  };\n};\n"]}

package/dist/node/dev_server.d.ts

@@ -0,0 +1,16 @@
+import type { ConfigLoader } from './load_config.js';
+/** Whether a `Host` header names the loopback listener, which a DNS-rebinding page's own hostname does not. */
+export declare const isLoopbackHost: (host: string | undefined) => boolean;
+export interface DevServerOptions {
+    configPath: string;
+    port: number;
+    loader?: ConfigLoader | undefined;
+    log?: ((line: string) => void) | undefined;
+}
+export interface DevServer {
+    url: string;
+    close: () => Promise<void>;
+}
+/** Serves the Studio for `configPath` with hot updates, re-running the Node-side config whenever its modules change. */
+export declare const startDevServer: ({ configPath: givenConfigPath, port, loader, log, }: DevServerOptions) => Promise<DevServer>;
+//# sourceMappingURL=dev_server.d.ts.map

package/dist/node/dev_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev_server.d.ts","sourceRoot":"","sources":["../../src/node/dev_server.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAyDlD,+GAA+G;AAC/G,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,OASzD,CAAC;AAyBF,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC5C;AAOD,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED,wHAAwH;AACxH,eAAO,MAAM,cAAc,GAAU,qDAKlC,gBAAgB,KAAG,OAAO,CAAC,SAAS,CAiPtC,CAAC"}