@elastic/isomer-studio 0.0.0 → 0.4.0

package/dist/node/load_config.js

@@ -0,0 +1,246 @@
+/*
+ * 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 { randomUUID } from 'node:crypto';
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import * as nodeModule from 'node:module';
+import { createRequire } from 'node:module';
+import { dirname, join, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { register as registerCommonJs } from 'tsx/cjs/api';
+import { register as registerEsm } from 'tsx/esm/api';
+import { appProblems } from '../model/app_problems.js';
+import { featuredProblems, runtimePrimitiveTypes } from '../model/featured.js';
+import { PACKAGE_DIR, RUNS_FROM_SOURCE } from './app_bundle.js';
+import { projectDirectory } from './project_resolution.js';
+import { patchRequire, resolveSync } from './resolve_hooks.js';
+export const DEFAULT_CONFIG_NAMES = [
+    'isomer-studio.config.ts',
+    'isomer-studio.config.tsx',
+    'isomer-studio.config.js',
+];
+/** The first default config name that exists in `cwd`. */
+export const findDefaultConfig = (cwd) => DEFAULT_CONFIG_NAMES.map((name) => resolve(cwd, name)).find((path) => existsSync(path));
+/** `config` against `cwd`, or the first default name that exists there. */
+export const resolveConfigPath = (cwd, config) => {
+    if (config !== undefined) {
+        const path = resolve(cwd, config);
+        if (!existsSync(path)) {
+            throw new Error(`No Studio config at ${path}.`);
+        }
+        return path;
+    }
+    const found = findDefaultConfig(cwd);
+    if (found === undefined) {
+        throw new Error(`No Studio config in ${cwd}. Run \`npx @elastic/isomer-studio init\` to create one, or pass --config.`);
+    }
+    return found;
+};
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const isStudioConfig = (value) => isRecord(value) &&
+    isRecord(value.runtime) &&
+    isRecord(value.runtime.surfaces);
+/** The default export, unwrapping the extra `default` a CommonJS build adds. */
+const defaultExport = (namespace) => {
+    const outer = isRecord(namespace) ? namespace.default : undefined;
+    return isRecord(outer) && !isStudioConfig(outer) ? outer.default : outer;
+};
+const reactDirectory = (from) => {
+    try {
+        return dirname(realpathSync(createRequire(from).resolve('react/package.json')));
+    }
+    catch {
+        return undefined;
+    }
+};
+/** The installed entry of `@elastic/isomer-runtime` as seen from `configPath`; its `exports` hide `package.json`. */
+const runtimeEntry = (configPath) => {
+    try {
+        return createRequire(configPath).resolve('@elastic/isomer-runtime');
+    }
+    catch {
+        return undefined;
+    }
+};
+/** Throws unless the config resolves React 18, which EUI needs, and `@elastic/isomer-runtime` resolves the same copy. */
+export const assertSingleReact = (configPath) => {
+    const configReact = reactDirectory(configPath);
+    if (configReact === undefined) {
+        throw new Error(`React is not installed where the Studio config is: ${configPath}. Install react@18 and react-dom@18.`);
+    }
+    const { version } = JSON.parse(readFileSync(join(configReact, 'package.json'), 'utf8'));
+    if (typeof version !== 'string' || !version.startsWith('18.')) {
+        throw new Error(`Isomer Studio needs React 18, which EUI requires; ${configPath} resolves React ${String(version)}.`);
+    }
+    const entry = runtimeEntry(configPath);
+    const runtimeReact = entry === undefined ? undefined : reactDirectory(entry);
+    if (runtimeReact !== undefined && runtimeReact !== configReact) {
+        throw new Error([
+            'The Studio config and @elastic/isomer-runtime resolve different copies of React:',
+            `  config:  ${configReact}`,
+            `  runtime: ${runtimeReact}`,
+            'Install one React for both, for example by deduplicating your lockfile.',
+        ].join('\n'));
+    }
+};
+/** Packages an app must share with the Studio for EUI's theme context and Emotion's cache to reach it. */
+const SHARED_WITH_APPS = ['@elastic/eui', '@emotion/react'];
+/** `@elastic/eui`'s peers, which pnpm must resolve alike for the config and the Studio to share one EUI. */
+const EUI_PEERS = [
+    'react',
+    'react-dom',
+    '@emotion/react',
+    '@emotion/css',
+    '@elastic/eui-theme-borealis',
+    '@elastic/datemath',
+    'moment',
+];
+const packageDirectory = (name, from) => {
+    try {
+        return dirname(realpathSync(createRequire(from).resolve(`${name}/package.json`)));
+    }
+    catch {
+        return undefined;
+    }
+};
+const studioVersions = (studioDir) => {
+    const { dependencies = {}, peerDependencies = {} } = JSON.parse(readFileSync(join(studioDir, 'package.json'), 'utf8'));
+    return { ...peerDependencies, ...dependencies };
+};
+/** Throws when the config would load a different EUI or Emotion from the Studio's, which its apps share; one it cannot resolve at all is fine. */
+export const assertSingleEui = (configPath, studioDir = PACKAGE_DIR) => {
+    const studioPackage = join(studioDir, 'package.json');
+    const mismatched = SHARED_WITH_APPS.map((name) => ({
+        name,
+        config: packageDirectory(name, configPath),
+        studio: packageDirectory(name, studioPackage),
+    })).filter(({ config, studio }) => config !== undefined && config !== studio);
+    if (!mismatched.length) {
+        return;
+    }
+    const versions = studioVersions(studioDir);
+    const wanted = ['@elastic/eui', ...EUI_PEERS].map((name) => versions[name] === undefined ? name : `${name}@${versions[name]}`);
+    throw new Error([
+        'The Studio config and @elastic/isomer-studio resolve different copies of packages that Studio apps share:',
+        ...mismatched.flatMap(({ name, config, studio }) => [
+            `  ${name}`,
+            `    config: ${config}`,
+            `    studio: ${studio ?? '(not installed)'}`,
+        ]),
+        `Install the Studio's versions beside the config, then deduplicate your lockfile: ${wanted.join(', ')}.`,
+    ].join('\n'));
+};
+/** The `tsconfig.json` nearest the config, which `tsx` applies to the files it includes. */
+export const nearestTsconfig = (configPath) => {
+    for (let dir = dirname(configPath);; dir = dirname(dir)) {
+        const candidate = join(dir, 'tsconfig.json');
+        if (existsSync(candidate)) {
+            return candidate;
+        }
+        if (dirname(dir) === dir) {
+            return undefined;
+        }
+    }
+};
+/** Registers `tsx`'s CommonJS and ESM hooks under one namespace, as `tsImport` does; the CommonJS hook reads `TSX_TSCONFIG_PATH` as it registers. */
+const registerTsx = (tsconfig) => {
+    const previous = process.env.TSX_TSCONFIG_PATH;
+    if (tsconfig !== undefined) {
+        process.env.TSX_TSCONFIG_PATH = tsconfig;
+    }
+    try {
+        const namespace = randomUUID();
+        registerCommonJs({ namespace });
+        return registerEsm({
+            namespace,
+            ...(tsconfig === undefined ? {} : { tsconfig }),
+        }).import;
+    }
+    finally {
+        if (previous === undefined) {
+            delete process.env.TSX_TSCONFIG_PATH;
+        }
+        else {
+            process.env.TSX_TSCONFIG_PATH = previous;
+        }
+    }
+};
+/** The Studio config a module namespace default-exports, or an error naming `configPath`. */
+export const studioConfigFrom = (namespace, configPath) => {
+    const config = defaultExport(namespace);
+    if (!isStudioConfig(config)) {
+        throw new Error(`${configPath} must default-export defineStudioConfig({ runtime, ... }).`);
+    }
+    const problems = appProblems(config.apps);
+    if (problems.length) {
+        throw new Error([
+            `${configPath} has invalid apps:`,
+            ...problems.map((line) => `  ${line}`),
+        ].join('\n'));
+    }
+    const featured = featuredProblems(config.featured, runtimePrimitiveTypes(config.runtime));
+    if (featured.length) {
+        throw new Error([
+            `${configPath} has invalid featured primitives:`,
+            ...featured.map((line) => `  ${line}`),
+        ].join('\n'));
+    }
+    if (config.apps?.length) {
+        assertSingleEui(configPath);
+    }
+    return config;
+};
+let registeredProject;
+/** Applies the Studio's module resolution to every later `import` in this process; a process serves one project. */
+export const registerProjectResolution = (configPath) => {
+    const projectDir = projectDirectory(configPath);
+    if (registeredProject !== undefined) {
+        if (registeredProject !== projectDir) {
+            throw new Error(`Module resolution is registered for ${registeredProject}, not ${projectDir}.`);
+        }
+        return;
+    }
+    registeredProject = projectDir;
+    const data = { projectDir, studioDir: PACKAGE_DIR };
+    // Node 22.15 and later; before it, `register` covers `import` and `patchRequire` covers `require`.
+    const { registerHooks } = nodeModule;
+    if (registerHooks) {
+        registerHooks({ resolve: resolveSync(data) });
+        return;
+    }
+    nodeModule.register(`./resolve_hooks${RUNS_FROM_SOURCE ? '.ts' : '.js'}`, import.meta.url, { data });
+    patchRequire(data);
+};
+/**
+ * Imports the config and the modules it names into one module graph, compiled with the config's nearest `tsconfig.json`.
+ * Each `tsx` namespace is a separate graph, so a package both import would otherwise load twice.
+ */
+export const createStudioImporter = (configPath, { loader = 'tsx' } = {}) => {
+    if (loader === 'none') {
+        return (path) => import(pathToFileURL(path).href);
+    }
+    let scoped;
+    return (path) => {
+        scoped ??= registerTsx(nearestTsconfig(configPath));
+        return scoped(pathToFileURL(path).href, import.meta.url);
+    };
+};
+/** Imports the config's default export in Node; `tsx` compiles TypeScript and leaves resolution to Node. */
+export const loadStudioConfig = async (configPath, { loader, importModule = createStudioImporter(configPath, { loader }), } = {}) => {
+    assertSingleReact(configPath);
+    return studioConfigFrom(await importModule(configPath), configPath);
+};
+const isRenderToString = (value) => typeof value === 'function';
+/** `react-dom/server`'s `renderToString`, from the config's own React. */
+export const loadRenderToString = (configPath) => {
+    const server = createRequire(configPath)('react-dom/server');
+    const renderToString = isRecord(server) ? server.renderToString : undefined;
+    if (!isRenderToString(renderToString)) {
+        throw new Error('react-dom/server has no renderToString.');
+    }
+    return renderToString;
+};
+//# sourceMappingURL=load_config.js.map

package/dist/node/load_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load_config.js","sourceRoot":"","sources":["../../src/node/load_config.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 { randomUUID } from 'node:crypto';\nimport { existsSync, readFileSync, realpathSync } from 'node:fs';\nimport * as nodeModule from 'node:module';\nimport { createRequire } from 'node:module';\nimport { dirname, join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport type { ReactNode } from 'react';\nimport { register as registerCommonJs } from 'tsx/cjs/api';\nimport type { ScopedImport } from 'tsx/esm/api';\nimport { register as registerEsm } from 'tsx/esm/api';\n\nimport type { StudioConfig } from '../config';\nimport { appProblems } from '../model/app_problems';\nimport { featuredProblems, runtimePrimitiveTypes } from '../model/featured';\n\nimport { PACKAGE_DIR, RUNS_FROM_SOURCE } from './app_bundle';\nimport { projectDirectory } from './project_resolution';\nimport type { ResolveHooksData } from './resolve_hooks';\nimport { patchRequire, resolveSync } from './resolve_hooks';\n\nexport type ConfigLoader = 'none' | 'tsx';\n\nexport const DEFAULT_CONFIG_NAMES = [\n  'isomer-studio.config.ts',\n  'isomer-studio.config.tsx',\n  'isomer-studio.config.js',\n] as const;\n\n/** The first default config name that exists in `cwd`. */\nexport const findDefaultConfig = (cwd: string): string | undefined =>\n  DEFAULT_CONFIG_NAMES.map((name) => resolve(cwd, name)).find((path) =>\n    existsSync(path)\n  );\n\n/** `config` against `cwd`, or the first default name that exists there. */\nexport const resolveConfigPath = (cwd: string, config?: string): string => {\n  if (config !== undefined) {\n    const path = resolve(cwd, config);\n    if (!existsSync(path)) {\n      throw new Error(`No Studio config at ${path}.`);\n    }\n    return path;\n  }\n  const found = findDefaultConfig(cwd);\n  if (found === undefined) {\n    throw new Error(\n      `No Studio config in ${cwd}. Run \\`npx @elastic/isomer-studio init\\` to create one, or pass --config.`\n    );\n  }\n  return found;\n};\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null;\n\nconst isStudioConfig = (value: unknown): value is StudioConfig =>\n  isRecord(value) &&\n  isRecord(value.runtime) &&\n  isRecord(value.runtime.surfaces);\n\n/** The default export, unwrapping the extra `default` a CommonJS build adds. */\nconst defaultExport = (namespace: unknown): unknown => {\n  const outer = isRecord(namespace) ? namespace.default : undefined;\n  return isRecord(outer) && !isStudioConfig(outer) ? outer.default : outer;\n};\n\nconst reactDirectory = (from: string): string | undefined => {\n  try {\n    return dirname(\n      realpathSync(createRequire(from).resolve('react/package.json'))\n    );\n  } catch {\n    return undefined;\n  }\n};\n\n/** The installed entry of `@elastic/isomer-runtime` as seen from `configPath`; its `exports` hide `package.json`. */\nconst runtimeEntry = (configPath: string): string | undefined => {\n  try {\n    return createRequire(configPath).resolve('@elastic/isomer-runtime');\n  } catch {\n    return undefined;\n  }\n};\n\n/** Throws unless the config resolves React 18, which EUI needs, and `@elastic/isomer-runtime` resolves the same copy. */\nexport const assertSingleReact = (configPath: string): void => {\n  const configReact = reactDirectory(configPath);\n  if (configReact === undefined) {\n    throw new Error(\n      `React is not installed where the Studio config is: ${configPath}. Install react@18 and react-dom@18.`\n    );\n  }\n  const { version } = JSON.parse(\n    readFileSync(join(configReact, 'package.json'), 'utf8')\n  ) as { version?: unknown };\n  if (typeof version !== 'string' || !version.startsWith('18.')) {\n    throw new Error(\n      `Isomer Studio needs React 18, which EUI requires; ${configPath} resolves React ${String(version)}.`\n    );\n  }\n  const entry = runtimeEntry(configPath);\n  const runtimeReact = entry === undefined ? undefined : reactDirectory(entry);\n  if (runtimeReact !== undefined && runtimeReact !== configReact) {\n    throw new Error(\n      [\n        'The Studio config and @elastic/isomer-runtime resolve different copies of React:',\n        `  config:  ${configReact}`,\n        `  runtime: ${runtimeReact}`,\n        'Install one React for both, for example by deduplicating your lockfile.',\n      ].join('\\n')\n    );\n  }\n};\n\n/** Packages an app must share with the Studio for EUI's theme context and Emotion's cache to reach it. */\nconst SHARED_WITH_APPS = ['@elastic/eui', '@emotion/react'] as const;\n\n/** `@elastic/eui`'s peers, which pnpm must resolve alike for the config and the Studio to share one EUI. */\nconst EUI_PEERS = [\n  'react',\n  'react-dom',\n  '@emotion/react',\n  '@emotion/css',\n  '@elastic/eui-theme-borealis',\n  '@elastic/datemath',\n  'moment',\n] as const;\n\nconst packageDirectory = (name: string, from: string): string | undefined => {\n  try {\n    return dirname(\n      realpathSync(createRequire(from).resolve(`${name}/package.json`))\n    );\n  } catch {\n    return undefined;\n  }\n};\n\nconst studioVersions = (studioDir: string): Record<string, string> => {\n  const { dependencies = {}, peerDependencies = {} } = JSON.parse(\n    readFileSync(join(studioDir, 'package.json'), 'utf8')\n  ) as {\n    dependencies?: Record<string, string>;\n    peerDependencies?: Record<string, string>;\n  };\n  return { ...peerDependencies, ...dependencies };\n};\n\n/** Throws when the config would load a different EUI or Emotion from the Studio's, which its apps share; one it cannot resolve at all is fine. */\nexport const assertSingleEui = (\n  configPath: string,\n  studioDir: string = PACKAGE_DIR\n): void => {\n  const studioPackage = join(studioDir, 'package.json');\n  const mismatched = SHARED_WITH_APPS.map((name) => ({\n    name,\n    config: packageDirectory(name, configPath),\n    studio: packageDirectory(name, studioPackage),\n  })).filter(({ config, studio }) => config !== undefined && config !== studio);\n  if (!mismatched.length) {\n    return;\n  }\n  const versions = studioVersions(studioDir);\n  const wanted = ['@elastic/eui', ...EUI_PEERS].map((name) =>\n    versions[name] === undefined ? name : `${name}@${versions[name]}`\n  );\n  throw new Error(\n    [\n      'The Studio config and @elastic/isomer-studio resolve different copies of packages that Studio apps share:',\n      ...mismatched.flatMap(({ name, config, studio }) => [\n        `  ${name}`,\n        `    config: ${config}`,\n        `    studio: ${studio ?? '(not installed)'}`,\n      ]),\n      `Install the Studio's versions beside the config, then deduplicate your lockfile: ${wanted.join(', ')}.`,\n    ].join('\\n')\n  );\n};\n\n/** The `tsconfig.json` nearest the config, which `tsx` applies to the files it includes. */\nexport const nearestTsconfig = (configPath: string): string | undefined => {\n  for (let dir = dirname(configPath); ; dir = dirname(dir)) {\n    const candidate = join(dir, 'tsconfig.json');\n    if (existsSync(candidate)) {\n      return candidate;\n    }\n    if (dirname(dir) === dir) {\n      return undefined;\n    }\n  }\n};\n\n/** Registers `tsx`'s CommonJS and ESM hooks under one namespace, as `tsImport` does; the CommonJS hook reads `TSX_TSCONFIG_PATH` as it registers. */\nconst registerTsx = (tsconfig: string | undefined): ScopedImport => {\n  const previous = process.env.TSX_TSCONFIG_PATH;\n  if (tsconfig !== undefined) {\n    process.env.TSX_TSCONFIG_PATH = tsconfig;\n  }\n  try {\n    const namespace = randomUUID();\n    registerCommonJs({ namespace });\n    return registerEsm({\n      namespace,\n      ...(tsconfig === undefined ? {} : { tsconfig }),\n    }).import;\n  } finally {\n    if (previous === undefined) {\n      delete process.env.TSX_TSCONFIG_PATH;\n    } else {\n      process.env.TSX_TSCONFIG_PATH = previous;\n    }\n  }\n};\n\n/** The Studio config a module namespace default-exports, or an error naming `configPath`. */\nexport const studioConfigFrom = (\n  namespace: unknown,\n  configPath: string\n): StudioConfig => {\n  const config = defaultExport(namespace);\n  if (!isStudioConfig(config)) {\n    throw new Error(\n      `${configPath} must default-export defineStudioConfig({ runtime, ... }).`\n    );\n  }\n  const problems = appProblems(config.apps);\n  if (problems.length) {\n    throw new Error(\n      [\n        `${configPath} has invalid apps:`,\n        ...problems.map((line) => `  ${line}`),\n      ].join('\\n')\n    );\n  }\n  const featured = featuredProblems(\n    config.featured,\n    runtimePrimitiveTypes(config.runtime)\n  );\n  if (featured.length) {\n    throw new Error(\n      [\n        `${configPath} has invalid featured primitives:`,\n        ...featured.map((line) => `  ${line}`),\n      ].join('\\n')\n    );\n  }\n  if (config.apps?.length) {\n    assertSingleEui(configPath);\n  }\n  return config;\n};\n\nlet registeredProject: string | undefined;\n\n/** Applies the Studio's module resolution to every later `import` in this process; a process serves one project. */\nexport const registerProjectResolution = (configPath: string): void => {\n  const projectDir = projectDirectory(configPath);\n  if (registeredProject !== undefined) {\n    if (registeredProject !== projectDir) {\n      throw new Error(\n        `Module resolution is registered for ${registeredProject}, not ${projectDir}.`\n      );\n    }\n    return;\n  }\n  registeredProject = projectDir;\n  const data: ResolveHooksData = { projectDir, studioDir: PACKAGE_DIR };\n  // Node 22.15 and later; before it, `register` covers `import` and `patchRequire` covers `require`.\n  const { registerHooks }: { registerHooks?: typeof nodeModule.registerHooks } =\n    nodeModule;\n  if (registerHooks) {\n    registerHooks({ resolve: resolveSync(data) });\n    return;\n  }\n  nodeModule.register(\n    `./resolve_hooks${RUNS_FROM_SOURCE ? '.ts' : '.js'}`,\n    import.meta.url,\n    { data }\n  );\n  patchRequire(data);\n};\n\nexport type StudioModuleImporter = (path: string) => Promise<unknown>;\n\n/**\n * Imports the config and the modules it names into one module graph, compiled with the config's nearest `tsconfig.json`.\n * Each `tsx` namespace is a separate graph, so a package both import would otherwise load twice.\n */\nexport const createStudioImporter = (\n  configPath: string,\n  { loader = 'tsx' }: { loader?: ConfigLoader | undefined } = {}\n): StudioModuleImporter => {\n  if (loader === 'none') {\n    return (path) => import(pathToFileURL(path).href);\n  }\n  let scoped: ScopedImport | undefined;\n  return (path) => {\n    scoped ??= registerTsx(nearestTsconfig(configPath));\n    return scoped(pathToFileURL(path).href, import.meta.url);\n  };\n};\n\n/** Imports the config's default export in Node; `tsx` compiles TypeScript and leaves resolution to Node. */\nexport const loadStudioConfig = async (\n  configPath: string,\n  {\n    loader,\n    importModule = createStudioImporter(configPath, { loader }),\n  }: {\n    loader?: ConfigLoader | undefined;\n    importModule?: StudioModuleImporter | undefined;\n  } = {}\n): Promise<StudioConfig> => {\n  assertSingleReact(configPath);\n  return studioConfigFrom(await importModule(configPath), configPath);\n};\n\nconst isRenderToString = (\n  value: unknown\n): value is (node: ReactNode) => string => typeof value === 'function';\n\n/** `react-dom/server`'s `renderToString`, from the config's own React. */\nexport const loadRenderToString = (\n  configPath: string\n): ((node: ReactNode) => string) => {\n  const server: unknown = createRequire(configPath)('react-dom/server');\n  const renderToString = isRecord(server) ? server.renderToString : undefined;\n  if (!isRenderToString(renderToString)) {\n    throw new Error('react-dom/server has no renderToString.');\n  }\n  return renderToString;\n};\n"]}

package/dist/node/project_resolution.d.ts

@@ -0,0 +1,17 @@
+/** Packages a project and the Studio must load one copy of: imported from outside the project, they resolve from it. */
+export declare const SHARED_PACKAGES: readonly ["react", "react-dom", "@elastic/isomer-sdk", "zod"];
+/** Packages a config may import without installing: when the project lacks them, they resolve from the Studio's install. */
+export declare const STUDIO_PACKAGES: readonly ["@elastic/isomer-runtime", "@elastic/isomer-studio"];
+/** The package a bare specifier names, or `undefined` for a relative, absolute or URL specifier. */
+export declare const packageNameOf: (specifier: string) => string | undefined;
+export declare const isSharedSpecifier: (specifier: string) => boolean;
+export declare const isStudioSpecifier: (specifier: string) => boolean;
+/** Whether `path` is `dir` or inside it. */
+export declare const isInside: (dir: string, path: string) => boolean;
+/** The real directory of the `package.json` nearest `path`, else `path`'s directory. */
+export declare const projectDirectory: (path: string) => string;
+/** The `node_modules` directory the Studio is installed in, which also holds what it depends on. */
+export declare const installDirectory: (studioDir: string) => string;
+/** Where a resolver should look for `specifier` first, imported from `importer`: the project for a shared package from outside it, otherwise `undefined`. */
+export declare const sharedResolveDir: (specifier: string, importer: string | undefined, projectDir: string) => string | undefined;
+//# sourceMappingURL=project_resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"project_resolution.d.ts","sourceRoot":"","sources":["../../src/node/project_resolution.ts"],"names":[],"mappings":"AAUA,wHAAwH;AACxH,eAAO,MAAM,eAAe,+DAKlB,CAAC;AAEX,4HAA4H;AAC5H,eAAO,MAAM,eAAe,gEAGlB,CAAC;AAEX,oGAAoG;AACpG,eAAO,MAAM,aAAa,GAAI,WAAW,MAAM,KAAG,MAAM,GAAG,SAM1D,CAAC;AAOF,eAAO,MAAM,iBAAiB,cALyB,MAAM,YAKN,CAAC;AAExD,eAAO,MAAM,iBAAiB,cAPyB,MAAM,YAON,CAAC;AAExD,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,EAAE,MAAM,MAAM,KAAG,OAGpD,CAAC;AAEF,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAO/C,CAAC;AAEF,oGAAoG;AACpG,eAAO,MAAM,gBAAgB,GAAI,WAAW,MAAM,KAAG,MAQpD,CAAC;AAEF,6JAA6J;AAC7J,eAAO,MAAM,gBAAgB,GAC3B,WAAW,MAAM,EACjB,UAAU,MAAM,GAAG,SAAS,EAC5B,YAAY,MAAM,KACjB,MAAM,GAAG,SAMG,CAAC"}

package/dist/node/project_resolution.js

@@ -0,0 +1,66 @@
+/*
+ * 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 { existsSync, realpathSync } from 'node:fs';
+import { basename, dirname, isAbsolute, join, relative } from 'node:path';
+/** Packages a project and the Studio must load one copy of: imported from outside the project, they resolve from it. */
+export const SHARED_PACKAGES = [
+    'react',
+    'react-dom',
+    '@elastic/isomer-sdk',
+    'zod',
+];
+/** Packages a config may import without installing: when the project lacks them, they resolve from the Studio's install. */
+export const STUDIO_PACKAGES = [
+    '@elastic/isomer-runtime',
+    '@elastic/isomer-studio',
+];
+/** The package a bare specifier names, or `undefined` for a relative, absolute or URL specifier. */
+export const packageNameOf = (specifier) => {
+    if (/^[./]|^[a-z][a-z\d+.-]*:/i.test(specifier) || isAbsolute(specifier)) {
+        return undefined;
+    }
+    const [scope = '', name] = specifier.split('/');
+    return scope.startsWith('@') ? `${scope}/${name ?? ''}` : scope;
+};
+const names = (list) => (specifier) => {
+    const name = packageNameOf(specifier);
+    return name !== undefined && list.includes(name);
+};
+export const isSharedSpecifier = names(SHARED_PACKAGES);
+export const isStudioSpecifier = names(STUDIO_PACKAGES);
+/** Whether `path` is `dir` or inside it. */
+export const isInside = (dir, path) => {
+    const inside = relative(dir, path);
+    return !inside.startsWith('..') && !isAbsolute(inside);
+};
+/** The real directory of the `package.json` nearest `path`, else `path`'s directory. */
+export const projectDirectory = (path) => {
+    for (let dir = dirname(path); dirname(dir) !== dir; dir = dirname(dir)) {
+        if (existsSync(join(dir, 'package.json'))) {
+            return realpathSync(dir);
+        }
+    }
+    return dirname(path);
+};
+/** The `node_modules` directory the Studio is installed in, which also holds what it depends on. */
+export const installDirectory = (studioDir) => {
+    const real = realpathSync(studioDir);
+    for (let dir = real; dirname(dir) !== dir; dir = dirname(dir)) {
+        if (basename(dir) === 'node_modules') {
+            return dir;
+        }
+    }
+    return real;
+};
+/** Where a resolver should look for `specifier` first, imported from `importer`: the project for a shared package from outside it, otherwise `undefined`. */
+export const sharedResolveDir = (specifier, importer, projectDir) => importer !== undefined &&
+    isAbsolute(importer) &&
+    isSharedSpecifier(specifier) &&
+    !isInside(projectDir, importer)
+    ? projectDir
+    : undefined;
+//# sourceMappingURL=project_resolution.js.map

package/dist/node/project_resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project_resolution.js","sourceRoot":"","sources":["../../src/node/project_resolution.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 { existsSync, realpathSync } from 'node:fs';\nimport { basename, dirname, isAbsolute, join, relative } from 'node:path';\n\n/** Packages a project and the Studio must load one copy of: imported from outside the project, they resolve from it. */\nexport const SHARED_PACKAGES = [\n  'react',\n  'react-dom',\n  '@elastic/isomer-sdk',\n  'zod',\n] as const;\n\n/** Packages a config may import without installing: when the project lacks them, they resolve from the Studio's install. */\nexport const STUDIO_PACKAGES = [\n  '@elastic/isomer-runtime',\n  '@elastic/isomer-studio',\n] as const;\n\n/** The package a bare specifier names, or `undefined` for a relative, absolute or URL specifier. */\nexport const packageNameOf = (specifier: string): string | undefined => {\n  if (/^[./]|^[a-z][a-z\\d+.-]*:/i.test(specifier) || isAbsolute(specifier)) {\n    return undefined;\n  }\n  const [scope = '', name] = specifier.split('/');\n  return scope.startsWith('@') ? `${scope}/${name ?? ''}` : scope;\n};\n\nconst names = (list: readonly string[]) => (specifier: string) => {\n  const name = packageNameOf(specifier);\n  return name !== undefined && list.includes(name);\n};\n\nexport const isSharedSpecifier = names(SHARED_PACKAGES);\n\nexport const isStudioSpecifier = names(STUDIO_PACKAGES);\n\n/** Whether `path` is `dir` or inside it. */\nexport const isInside = (dir: string, path: string): boolean => {\n  const inside = relative(dir, path);\n  return !inside.startsWith('..') && !isAbsolute(inside);\n};\n\n/** The real directory of the `package.json` nearest `path`, else `path`'s directory. */\nexport const projectDirectory = (path: string): string => {\n  for (let dir = dirname(path); dirname(dir) !== dir; dir = dirname(dir)) {\n    if (existsSync(join(dir, 'package.json'))) {\n      return realpathSync(dir);\n    }\n  }\n  return dirname(path);\n};\n\n/** The `node_modules` directory the Studio is installed in, which also holds what it depends on. */\nexport const installDirectory = (studioDir: string): string => {\n  const real = realpathSync(studioDir);\n  for (let dir = real; dirname(dir) !== dir; dir = dirname(dir)) {\n    if (basename(dir) === 'node_modules') {\n      return dir;\n    }\n  }\n  return real;\n};\n\n/** Where a resolver should look for `specifier` first, imported from `importer`: the project for a shared package from outside it, otherwise `undefined`. */\nexport const sharedResolveDir = (\n  specifier: string,\n  importer: string | undefined,\n  projectDir: string\n): string | undefined =>\n  importer !== undefined &&\n  isAbsolute(importer) &&\n  isSharedSpecifier(specifier) &&\n  !isInside(projectDir, importer)\n    ? projectDir\n    : undefined;\n"]}

package/dist/node/rasterize.d.ts

@@ -0,0 +1,23 @@
+import type { FontLoader } from '@elastic/isomer-image-takumi';
+import type { Composition } from '@elastic/isomer-sdk';
+import type { StudioConfig, StudioRuntime } from '../config.js';
+export type NodeRasterizer = (composition: Composition) => Promise<Buffer>;
+export type NodePdfWriter = (compositions: readonly Composition[], options?: {
+    title?: string | undefined;
+}) => Promise<Buffer>;
+export interface NodeRenderers {
+    png: NodeRasterizer;
+    pdf: NodePdfWriter;
+}
+/** Resolves the faces takumi draws text with. */
+export type ImageFonts = () => Promise<readonly FontLoader[]>;
+/** The config's `imageFonts` module, imported once on first use with `importModule`; `undefined` without one. */
+export declare const imageFontsOf: ({ imageFonts }: Pick<StudioConfig, "imageFonts">, configPath: string, importModule: (path: string) => Promise<unknown>) => ImageFonts | undefined;
+/**
+ * Draws with takumi, loaded on first use because it is native; `undefined` without a snapshot surface.
+ * Images take the frame's own geometry, as the Snapshot preview does. Without `fonts`, a PNG falls back to takumi's built-in face and a PDF can't draw text.
+ */
+export declare const createRenderers: (runtime: StudioRuntime, fonts?: ImageFonts) => NodeRenderers | undefined;
+/** {@link createRenderers}' PNGs alone. */
+export declare const createRasterizer: (runtime: StudioRuntime, fonts?: ImageFonts) => NodeRasterizer | undefined;
+//# sourceMappingURL=rasterize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rasterize.d.ts","sourceRoot":"","sources":["../../src/node/rasterize.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,8BAA8B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG7D,MAAM,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE3E,MAAM,MAAM,aAAa,GAAG,CAC1B,YAAY,EAAE,SAAS,WAAW,EAAE,EACpC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KACrC,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,cAAc,CAAC;IACpB,GAAG,EAAE,aAAa,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;AAiB9D,iHAAiH;AACjH,eAAO,MAAM,YAAY,GACvB,gBAAgB,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,EAChD,YAAY,MAAM,EAClB,cAAc,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC/C,UAAU,GAAG,SAqBf,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,aAAa,EACtB,QAAQ,UAAU,KACjB,aAAa,GAAG,SAsClB,CAAC;AAEF,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,GAC3B,SAAS,aAAa,EACtB,QAAQ,UAAU,KACjB,cAAc,GAAG,SAAiD,CAAC"}

package/dist/node/rasterize.js

@@ -0,0 +1,79 @@
+/*
+ * 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, resolve } from 'node:path';
+import { PNG_SCALE } from '../types.js';
+const fontsIn = (namespace) => {
+    const exported = typeof namespace === 'object' &&
+        namespace !== null &&
+        'default' in namespace
+        ? namespace.default
+        : undefined;
+    return Array.isArray(exported) ||
+        typeof exported !== 'object' ||
+        exported === null ||
+        !('default' in exported)
+        ? exported
+        : exported.default;
+};
+/** The config's `imageFonts` module, imported once on first use with `importModule`; `undefined` without one. */
+export const imageFontsOf = ({ imageFonts }, configPath, importModule) => {
+    if (imageFonts === undefined) {
+        return undefined;
+    }
+    const path = resolve(dirname(configPath), imageFonts);
+    let fonts;
+    return () => (fonts ??= importModule(path)
+        .then((namespace) => {
+        const exported = fontsIn(namespace);
+        if (!Array.isArray(exported)) {
+            throw new Error(`${imageFonts} must default-export an array of takumi font loaders.`);
+        }
+        return exported;
+    })
+        .catch((error) => {
+        fonts = undefined;
+        throw error;
+    }));
+};
+/**
+ * Draws with takumi, loaded on first use because it is native; `undefined` without a snapshot surface.
+ * Images take the frame's own geometry, as the Snapshot preview does. Without `fonts`, a PNG falls back to takumi's built-in face and a PDF can't draw text.
+ */
+export const createRenderers = (runtime, fonts) => {
+    const { snapshot } = runtime.surfaces;
+    if (!snapshot) {
+        return undefined;
+    }
+    let backend;
+    const loadBackend = () => (backend ??= Promise.all([
+        import('@elastic/isomer-image-takumi'),
+        fonts?.() ?? [],
+    ])
+        .then(([{ createTakumiImageBackend }, faces]) => createTakumiImageBackend({ fonts: faces }))
+        .catch((error) => {
+        backend = undefined;
+        throw error;
+    }));
+    return {
+        png: async (composition) => (await loadBackend()).png(snapshot.render(composition, { onValidationError: 'collect' }), { scale: PNG_SCALE }),
+        pdf: async (compositions, { title } = {}) => {
+            const takumi = await loadBackend();
+            const { renderPdf } = await import('@elastic/isomer-image-takumi');
+            const drawable = {
+                validate: (composition) => runtime.validate(composition),
+                surfaces: { snapshot },
+            };
+            const { pdf } = await renderPdf(drawable, compositions, takumi, {
+                ...(title === undefined ? {} : { metadata: { title } }),
+            });
+            return pdf;
+        },
+    };
+};
+/** {@link createRenderers}' PNGs alone. */
+export const createRasterizer = (runtime, fonts) => createRenderers(runtime, fonts)?.png;
+//# sourceMappingURL=rasterize.js.map

package/dist/node/rasterize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rasterize.js","sourceRoot":"","sources":["../../src/node/rasterize.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 { dirname, resolve } from 'node:path';\n\nimport type { FontLoader, TakumiBackend } from '@elastic/isomer-image-takumi';\nimport type { Composition } from '@elastic/isomer-sdk';\n\nimport type { StudioConfig, StudioRuntime } from '../config';\nimport { PNG_SCALE } from '../types';\n\nexport type NodeRasterizer = (composition: Composition) => Promise<Buffer>;\n\nexport type NodePdfWriter = (\n  compositions: readonly Composition[],\n  options?: { title?: string | undefined }\n) => Promise<Buffer>;\n\nexport interface NodeRenderers {\n  png: NodeRasterizer;\n  pdf: NodePdfWriter;\n}\n\n/** Resolves the faces takumi draws text with. */\nexport type ImageFonts = () => Promise<readonly FontLoader[]>;\n\nconst fontsIn = (namespace: unknown): unknown => {\n  const exported =\n    typeof namespace === 'object' &&\n    namespace !== null &&\n    'default' in namespace\n      ? namespace.default\n      : undefined;\n  return Array.isArray(exported) ||\n    typeof exported !== 'object' ||\n    exported === null ||\n    !('default' in exported)\n    ? exported\n    : exported.default;\n};\n\n/** The config's `imageFonts` module, imported once on first use with `importModule`; `undefined` without one. */\nexport const imageFontsOf = (\n  { imageFonts }: Pick<StudioConfig, 'imageFonts'>,\n  configPath: string,\n  importModule: (path: string) => Promise<unknown>\n): ImageFonts | undefined => {\n  if (imageFonts === undefined) {\n    return undefined;\n  }\n  const path = resolve(dirname(configPath), imageFonts);\n  let fonts: Promise<readonly FontLoader[]> | undefined;\n  return () =>\n    (fonts ??= importModule(path)\n      .then((namespace) => {\n        const exported = fontsIn(namespace);\n        if (!Array.isArray(exported)) {\n          throw new Error(\n            `${imageFonts} must default-export an array of takumi font loaders.`\n          );\n        }\n        return exported as readonly FontLoader[];\n      })\n      .catch((error: unknown) => {\n        fonts = undefined;\n        throw error;\n      }));\n};\n\n/**\n * Draws with takumi, loaded on first use because it is native; `undefined` without a snapshot surface.\n * Images take the frame's own geometry, as the Snapshot preview does. Without `fonts`, a PNG falls back to takumi's built-in face and a PDF can't draw text.\n */\nexport const createRenderers = (\n  runtime: StudioRuntime,\n  fonts?: ImageFonts\n): NodeRenderers | undefined => {\n  const { snapshot } = runtime.surfaces;\n  if (!snapshot) {\n    return undefined;\n  }\n  let backend: Promise<TakumiBackend> | undefined;\n  const loadBackend = () =>\n    (backend ??= Promise.all([\n      import('@elastic/isomer-image-takumi'),\n      fonts?.() ?? [],\n    ])\n      .then(([{ createTakumiImageBackend }, faces]) =>\n        createTakumiImageBackend({ fonts: faces })\n      )\n      .catch((error: unknown) => {\n        backend = undefined;\n        throw error;\n      }));\n\n  return {\n    png: async (composition) =>\n      (await loadBackend()).png(\n        snapshot.render(composition, { onValidationError: 'collect' }),\n        { scale: PNG_SCALE }\n      ),\n    pdf: async (compositions, { title } = {}) => {\n      const takumi = await loadBackend();\n      const { renderPdf } = await import('@elastic/isomer-image-takumi');\n      const drawable = {\n        validate: (composition: Composition) => runtime.validate(composition),\n        surfaces: { snapshot },\n      };\n      const { pdf } = await renderPdf(drawable, compositions, takumi, {\n        ...(title === undefined ? {} : { metadata: { title } }),\n      });\n      return pdf;\n    },\n  };\n};\n\n/** {@link createRenderers}' PNGs alone. */\nexport const createRasterizer = (\n  runtime: StudioRuntime,\n  fonts?: ImageFonts\n): NodeRasterizer | undefined => createRenderers(runtime, fonts)?.png;\n"]}

package/dist/node/report.d.ts

@@ -0,0 +1,8 @@
+import type { CheckReport } from './check.js';
+export type ReportFormat = 'json' | 'junit';
+/** One `testsuite` per primitive, one `testcase` per check. */
+export declare const toJunit: ({ title, results, failed, skipped, }: CheckReport) => string;
+export declare const formatReport: (report: CheckReport, format: ReportFormat) => string;
+/** Every failure, then the totals, for the terminal. */
+export declare const summarizeReport: ({ title, apps, results, passed, failed, skipped, }: CheckReport) => string;
+//# sourceMappingURL=report.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/node/report.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AA6B5C,+DAA+D;AAC/D,eAAO,MAAM,OAAO,GAAI,sCAKrB,WAAW,KAAG,MAmBhB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,QAAQ,WAAW,EACnB,QAAQ,YAAY,KACnB,MAC4E,CAAC;AAEhF,wDAAwD;AACxD,eAAO,MAAM,eAAe,GAAI,oDAO7B,WAAW,KAAG,MAUH,CAAC"}

package/dist/node/report.js

@@ -0,0 +1,57 @@
+/*
+ * 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.
+ */
+const XML_ESCAPES = {
+    '&': '&',
+    '<': '&lt;',
+    '>': '&gt;',
+    '"': '&quot;',
+    "'": '&apos;',
+};
+const escapeXml = (value) => value.replace(/[&<>"']/g, (char) => XML_ESCAPES[char] ?? char);
+const caseName = ({ example, check }) => example === undefined ? check : `${example} › ${check}`;
+const testCase = (result) => {
+    const { primitive, status, message = '' } = result;
+    const open = `    <testcase classname="${escapeXml(primitive)}" name="${escapeXml(caseName(result))}"`;
+    switch (status) {
+        case 'passed':
+            return `${open} />`;
+        case 'skipped':
+            return `${open}>\n      <skipped message="${escapeXml(message)}" />\n    </testcase>`;
+        case 'failed':
+            return `${open}>\n      <failure message="${escapeXml(message.split('\n')[0] ?? '')}">${escapeXml(message)}</failure>\n    </testcase>`;
+    }
+};
+/** One `testsuite` per primitive, one `testcase` per check. */
+export const toJunit = ({ title, results, failed, skipped, }) => {
+    const primitives = [...new Set(results.map(({ primitive }) => primitive))];
+    const suites = primitives.map((primitive) => {
+        const cases = results.filter((result) => result.primitive === primitive);
+        const count = (status) => cases.filter((result) => result.status === status).length;
+        return [
+            `  <testsuite name="${escapeXml(primitive)}" tests="${cases.length}" failures="${count('failed')}" skipped="${count('skipped')}">`,
+            ...cases.map(testCase),
+            '  </testsuite>',
+        ].join('\n');
+    });
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        `<testsuites name="${escapeXml(title)}" tests="${results.length}" failures="${failed}" skipped="${skipped}">`,
+        ...suites,
+        '</testsuites>',
+        '',
+    ].join('\n');
+};
+export const formatReport = (report, format) => format === 'junit' ? toJunit(report) : `${JSON.stringify(report, null, 2)}\n`;
+/** Every failure, then the totals, for the terminal. */
+export const summarizeReport = ({ title, apps, results, passed, failed, skipped, }) => [
+    ...results
+        .filter(({ status }) => status === 'failed')
+        .map((result) => `✗ ${result.primitive} › ${caseName(result)}\n  ${(result.message ?? '').split('\n').join('\n  ')}`),
+    `${title}: ${passed} passed, ${failed} failed, ${skipped} skipped.${apps ? ` ${apps} ${apps === 1 ? 'app' : 'apps'} listed.` : ''}`,
+    '',
+].join('\n');
+//# sourceMappingURL=report.js.map

package/dist/node/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/node/report.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 { CheckReport, CheckResult } from './check';\n\nexport type ReportFormat = 'json' | 'junit';\n\nconst XML_ESCAPES: Readonly<Record<string, string>> = {\n  '&': '&amp;',\n  '<': '&lt;',\n  '>': '&gt;',\n  '\"': '&quot;',\n  \"'\": '&apos;',\n};\n\nconst escapeXml = (value: string): string =>\n  value.replace(/[&<>\"']/g, (char) => XML_ESCAPES[char] ?? char);\n\nconst caseName = ({ example, check }: CheckResult): string =>\n  example === undefined ? check : `${example} › ${check}`;\n\nconst testCase = (result: CheckResult): string => {\n  const { primitive, status, message = '' } = result;\n  const open = `    <testcase classname=\"${escapeXml(primitive)}\" name=\"${escapeXml(caseName(result))}\"`;\n  switch (status) {\n    case 'passed':\n      return `${open} />`;\n    case 'skipped':\n      return `${open}>\\n      <skipped message=\"${escapeXml(message)}\" />\\n    </testcase>`;\n    case 'failed':\n      return `${open}>\\n      <failure message=\"${escapeXml(message.split('\\n')[0] ?? '')}\">${escapeXml(message)}</failure>\\n    </testcase>`;\n  }\n};\n\n/** One `testsuite` per primitive, one `testcase` per check. */\nexport const toJunit = ({\n  title,\n  results,\n  failed,\n  skipped,\n}: CheckReport): string => {\n  const primitives = [...new Set(results.map(({ primitive }) => primitive))];\n  const suites = primitives.map((primitive) => {\n    const cases = results.filter((result) => result.primitive === primitive);\n    const count = (status: CheckResult['status']) =>\n      cases.filter((result) => result.status === status).length;\n    return [\n      `  <testsuite name=\"${escapeXml(primitive)}\" tests=\"${cases.length}\" failures=\"${count('failed')}\" skipped=\"${count('skipped')}\">`,\n      ...cases.map(testCase),\n      '  </testsuite>',\n    ].join('\\n');\n  });\n  return [\n    '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n    `<testsuites name=\"${escapeXml(title)}\" tests=\"${results.length}\" failures=\"${failed}\" skipped=\"${skipped}\">`,\n    ...suites,\n    '</testsuites>',\n    '',\n  ].join('\\n');\n};\n\nexport const formatReport = (\n  report: CheckReport,\n  format: ReportFormat\n): string =>\n  format === 'junit' ? toJunit(report) : `${JSON.stringify(report, null, 2)}\\n`;\n\n/** Every failure, then the totals, for the terminal. */\nexport const summarizeReport = ({\n  title,\n  apps,\n  results,\n  passed,\n  failed,\n  skipped,\n}: CheckReport): string =>\n  [\n    ...results\n      .filter(({ status }) => status === 'failed')\n      .map(\n        (result) =>\n          `✗ ${result.primitive} › ${caseName(result)}\\n  ${(result.message ?? '').split('\\n').join('\\n  ')}`\n      ),\n    `${title}: ${passed} passed, ${failed} failed, ${skipped} skipped.${apps ? ` ${apps} ${apps === 1 ? 'app' : 'apps'} listed.` : ''}`,\n    '',\n  ].join('\\n');\n"]}

package/dist/node/resolve_hooks.d.ts

@@ -0,0 +1,16 @@
+import type { InitializeHook, ResolveHook, ResolveHookSync } from 'node:module';
+/** Node module hooks applying `sharedResolveDir` and the Studio fallback to every `import` and `require`. */
+export interface ResolveHooksData {
+    projectDir: string;
+    studioDir: string;
+}
+/** Where to resolve `specifier` from, in order; every parent but the last is passed over when it finds nothing. */
+export declare const parentsFor: (specifier: string, parentURL: string | undefined, { projectDir, studioDir }: ResolveHooksData) => (string | undefined)[];
+/** For `module.registerHooks`, which also sees `require`. */
+export declare const resolveSync: (data: ResolveHooksData) => ResolveHookSync;
+/** Applies {@link resolveSync} to `require` on a Node without `registerHooks`, wrapping the resolver as `tsx` does. */
+export declare const patchRequire: (hooksData: ResolveHooksData) => void;
+/** For `module.register`, on a Node without `registerHooks`. */
+export declare const initialize: InitializeHook<ResolveHooksData>;
+export declare const resolve: ResolveHook;
+//# sourceMappingURL=resolve_hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve_hooks.d.ts","sourceRoot":"","sources":["../../src/node/resolve_hooks.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EAEd,WAAW,EACX,eAAe,EAChB,MAAM,aAAa,CAAC;AAOrB,6GAA6G;AAC7G,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAKD,mHAAmH;AACnH,eAAO,MAAM,UAAU,GACrB,WAAW,MAAM,EACjB,WAAW,MAAM,GAAG,SAAS,EAC7B,2BAA2B,gBAAgB,KAC1C,CAAC,MAAM,GAAG,SAAS,CAAC,EAUtB,CAAC;AAeF,6DAA6D;AAC7D,eAAO,MAAM,WAAW,GACrB,MAAM,gBAAgB,KAAG,eA6BzB,CAAC;AAYJ,uHAAuH;AACvH,eAAO,MAAM,YAAY,GAAI,WAAW,gBAAgB,KAAG,IAyB1D,CAAC;AAIF,gEAAgE;AAChE,eAAO,MAAM,UAAU,EAAE,cAAc,CAAC,gBAAgB,CAEvD,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAiBrB,CAAC"}