@elastic/isomer-studio 0.0.0 → 0.4.0

package/dist/node/dev_server.js

@@ -0,0 +1,291 @@
+/*
+ * 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 { readFile } from 'node:fs/promises';
+import { createServer } from 'node:http';
+import { extname, join, normalize } from 'node:path';
+import { transform } from 'esbuild';
+import { createServer as createViteServer, createServerModuleRunner, } from 'vite';
+import { describeTransformError, JSX_TRANSFORM_OPTIONS, } from '../model/jsx_transform.js';
+import { APP_DIR, renderIndexHtml } from './app_bundle.js';
+import { DEV_ENTRY_URL, devViteConfig } from './dev_bundle.js';
+import { assertSingleReact, createStudioImporter, loadStudioConfig, studioConfigFrom, } from './load_config.js';
+import { createRenderers, imageFontsOf } from './rasterize.js';
+const HOST = '127.0.0.1';
+const MAX_BODY_BYTES = 256 * 1024;
+/** A whole deck's compositions. */
+const MAX_PDF_BODY_BYTES = 8 * 1024 * 1024;
+const ASSETS_DIR = join(APP_DIR, 'assets');
+const CONTENT_TYPES = {
+    '.css': 'text/css; charset=utf-8',
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.png': 'image/png',
+    '.svg': 'image/svg+xml',
+    '.ttf': 'font/ttf',
+    '.wasm': 'application/wasm',
+    '.woff': 'font/woff',
+    '.woff2': 'font/woff2',
+};
+const readBody = (request, maxBytes = MAX_BODY_BYTES) => new Promise((resolve, reject) => {
+    const chunks = [];
+    let size = 0;
+    request.on('data', (chunk) => {
+        size += chunk.length;
+        if (size > maxBytes) {
+            reject(new Error(`Request body is over ${maxBytes} bytes.`));
+            request.destroy();
+            return;
+        }
+        chunks.push(chunk);
+    });
+    request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
+    request.on('error', reject);
+});
+const sendText = (response, status, text) => {
+    response.writeHead(status, { 'content-type': 'text/plain; charset=utf-8' });
+    response.end(text);
+};
+const LOOPBACK_HOSTNAMES = new Set(['127.0.0.1', 'localhost', '[::1]']);
+/** Whether a `Host` header names the loopback listener, which a DNS-rebinding page's own hostname does not. */
+export const isLoopbackHost = (host) => {
+    if (host === undefined) {
+        return false;
+    }
+    try {
+        return LOOPBACK_HOSTNAMES.has(new URL(`http://${host}`).hostname);
+    }
+    catch {
+        return false;
+    }
+};
+/** Shape only: the snapshot surface validates the rest and draws what it can. */
+const isComposition = (value) => typeof value === 'object' &&
+    value !== null &&
+    'type' in value &&
+    typeof value.type === 'string';
+const isPdfRequest = (value) => typeof value === 'object' &&
+    value !== null &&
+    'compositions' in value &&
+    Array.isArray(value.compositions) &&
+    value.compositions.length > 0 &&
+    value.compositions.every(isComposition) &&
+    (!('title' in value) ||
+        value.title === undefined ||
+        typeof value.title === 'string');
+const describeError = (error) => error instanceof Error ? error.message : String(error);
+/** Serves the Studio for `configPath` with hot updates, re-running the Node-side config whenever its modules change. */
+export const startDevServer = async ({ configPath: givenConfigPath, port, loader, log = (line) => process.stdout.write(`${line}\n`), }) => {
+    // Vite's module ids and serving allow list compare real paths.
+    const configPath = realpathSync(givenConfigPath);
+    if (!existsSync(join(APP_DIR, 'index.html'))) {
+        throw new Error(`The Studio's app assets are missing from ${APP_DIR}. In the Isomer repository, run \`pnpm build\` once.`);
+    }
+    assertSingleReact(configPath);
+    if (loader === 'none') {
+        log('PNGs render with the config as loaded now: Node caches a plain import(), so restart dev to pick up config or pack changes.');
+    }
+    const server = createServer();
+    const fontFiles = new Set();
+    const vite = await createViteServer(devViteConfig({
+        configPath,
+        server,
+        onConfigChange: (stale) => reloadConfig(stale),
+        reloadsWith: () => fontFiles,
+    }));
+    const runner = loader === 'none'
+        ? undefined
+        : createServerModuleRunner(vite.environments.ssr, { hmr: false });
+    const importModule = createStudioImporter(configPath, { loader });
+    const importConfig = async () => {
+        const config = runner
+            ? studioConfigFrom(await runner.import(configPath), configPath)
+            : await loadStudioConfig(configPath, { importModule });
+        const fonts = imageFontsOf(config, configPath, async (path) => {
+            if (!runner) {
+                return importModule(path);
+            }
+            const namespace = await runner.import(path);
+            const node = await vite.environments.ssr.moduleGraph.getModuleByUrl(path);
+            fontFiles.clear();
+            if (node?.file) {
+                fontFiles.add(node.file);
+            }
+            return namespace;
+        });
+        return { config, renderers: createRenderers(config.runtime, fonts) };
+    };
+    let loaded = importConfig();
+    const reloadConfig = async (stale) => {
+        if (!runner) {
+            return;
+        }
+        const { evaluatedModules } = runner;
+        stale.forEach(({ id }) => {
+            const node = id === null ? undefined : evaluatedModules.getModuleById(id);
+            if (node) {
+                evaluatedModules.invalidateModule(node);
+            }
+        });
+        const previous = loaded;
+        loaded = previous.then(importConfig).catch((error) => {
+            log(`Could not reload the Studio config: ${describeError(error)}`);
+            return previous;
+        });
+        await loaded;
+    };
+    const close = async () => {
+        await runner?.close();
+        await vite.close();
+    };
+    try {
+        await loaded;
+    }
+    catch (error) {
+        await close();
+        throw error;
+    }
+    const png = async (request, response) => {
+        const { renderers } = await loaded;
+        if (!renderers) {
+            sendText(response, 404, 'The runtime has no snapshot surface.');
+            return;
+        }
+        try {
+            const composition = JSON.parse(await readBody(request));
+            if (!isComposition(composition)) {
+                sendText(response, 400, 'Not a composition.');
+                return;
+            }
+            const image = await renderers.png(composition);
+            response.writeHead(200, {
+                'content-type': 'image/png',
+                'cache-control': 'no-store',
+            });
+            response.end(image);
+        }
+        catch (error) {
+            sendText(response, 400, describeError(error));
+        }
+    };
+    const pdf = async (request, response) => {
+        const { renderers } = await loaded;
+        if (!renderers) {
+            sendText(response, 404, 'The runtime has no snapshot surface.');
+            return;
+        }
+        try {
+            const body = JSON.parse(await readBody(request, MAX_PDF_BODY_BYTES));
+            if (!isPdfRequest(body)) {
+                sendText(response, 400, 'Not one or more compositions.');
+                return;
+            }
+            const { title, compositions } = body;
+            const document = await renderers.pdf(compositions, { title });
+            response.writeHead(200, {
+                'content-type': 'application/pdf',
+                'cache-control': 'no-store',
+            });
+            response.end(document);
+        }
+        catch (error) {
+            sendText(response, 400, describeError(error));
+        }
+    };
+    const transformJsx = async (request, response) => {
+        try {
+            const { code } = await transform(await readBody(request), JSX_TRANSFORM_OPTIONS);
+            response.writeHead(200, {
+                'content-type': 'text/javascript; charset=utf-8',
+            });
+            response.end(code);
+        }
+        catch (error) {
+            sendText(response, 400, describeTransformError(error));
+        }
+    };
+    const serveAsset = async (pathname, response) => {
+        const relativePath = normalize(pathname.slice('/assets/'.length));
+        const file = relativePath.startsWith('..')
+            ? undefined
+            : await readFile(join(ASSETS_DIR, relativePath)).catch(() => undefined);
+        if (!file) {
+            sendText(response, 404, 'Not found');
+            return;
+        }
+        response.writeHead(200, {
+            'content-type': CONTENT_TYPES[extname(pathname)] ?? 'application/octet-stream',
+            'cache-control': 'no-store',
+        });
+        response.end(file);
+    };
+    const serveIndex = async (url, response) => {
+        try {
+            const { config } = await loaded;
+            const html = await vite.transformIndexHtml(url, renderIndexHtml({
+                base: '/',
+                title: config.title,
+                entry: DEV_ENTRY_URL,
+            }));
+            response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });
+            response.end(html);
+        }
+        catch (error) {
+            sendText(response, 500, describeError(error));
+        }
+    };
+    server.on('request', (request, response) => {
+        if (!isLoopbackHost(request.headers.host)) {
+            sendText(response, 403, 'Forbidden host');
+            return;
+        }
+        const url = request.url ?? '/';
+        const { pathname } = new URL(url, `http://${HOST}`);
+        if (request.method === 'POST' && pathname === '/transform') {
+            void transformJsx(request, response);
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/png') {
+            void png(request, response);
+            return;
+        }
+        if (request.method === 'POST' && pathname === '/pdf') {
+            void pdf(request, response);
+            return;
+        }
+        if (pathname === '/' || pathname === '/index.html') {
+            void serveIndex(url, response);
+            return;
+        }
+        if (pathname.startsWith('/assets/')) {
+            void serveAsset(pathname, response);
+            return;
+        }
+        vite.middlewares(request, response, () => sendText(response, 404, 'Not found'));
+    });
+    await new Promise((resolve, reject) => {
+        server.once('error', (error) => reject(error.code === 'EADDRINUSE'
+            ? new Error(`Port ${port} is in use; pass --port.`)
+            : error));
+        server.listen(port, HOST, () => resolve());
+    }).catch(async (error) => {
+        await close();
+        throw error;
+    });
+    const address = server.address();
+    const boundPort = typeof address === 'object' && address !== null ? address.port : port;
+    return {
+        url: `http://${HOST}:${boundPort}/`,
+        close: async () => {
+            await close();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+};
+//# sourceMappingURL=dev_server.js.map

package/dist/node/dev_server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev_server.js","sourceRoot":"","sources":["../../src/node/dev_server.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 { readFile } from 'node:fs/promises';\nimport type { IncomingMessage, Server, ServerResponse } from 'node:http';\nimport { createServer } from 'node:http';\nimport { extname, join, normalize } from 'node:path';\n\nimport type { Composition } from '@elastic/isomer-sdk';\nimport { transform } from 'esbuild';\nimport {\n  createServer as createViteServer,\n  createServerModuleRunner,\n} from 'vite';\n\nimport type { StudioConfig } from '../config';\nimport {\n  describeTransformError,\n  JSX_TRANSFORM_OPTIONS,\n} from '../model/jsx_transform';\n\nimport { APP_DIR, renderIndexHtml } from './app_bundle';\nimport type { ConfigChangeHandler } from './dev_bundle';\nimport { DEV_ENTRY_URL, devViteConfig } from './dev_bundle';\nimport type { ConfigLoader } from './load_config';\nimport {\n  assertSingleReact,\n  createStudioImporter,\n  loadStudioConfig,\n  studioConfigFrom,\n} from './load_config';\nimport type { NodeRenderers } from './rasterize';\nimport { createRenderers, imageFontsOf } from './rasterize';\n\nconst HOST = '127.0.0.1';\nconst MAX_BODY_BYTES = 256 * 1024;\n/** A whole deck's compositions. */\nconst MAX_PDF_BODY_BYTES = 8 * 1024 * 1024;\nconst ASSETS_DIR = join(APP_DIR, 'assets');\n\nconst CONTENT_TYPES: Readonly<Record<string, string>> = {\n  '.css': 'text/css; charset=utf-8',\n  '.html': 'text/html; charset=utf-8',\n  '.js': 'text/javascript; charset=utf-8',\n  '.json': 'application/json; charset=utf-8',\n  '.map': 'application/json; charset=utf-8',\n  '.png': 'image/png',\n  '.svg': 'image/svg+xml',\n  '.ttf': 'font/ttf',\n  '.wasm': 'application/wasm',\n  '.woff': 'font/woff',\n  '.woff2': 'font/woff2',\n};\n\nconst readBody = (\n  request: IncomingMessage,\n  maxBytes = MAX_BODY_BYTES\n): Promise<string> =>\n  new Promise((resolve, reject) => {\n    const chunks: Buffer[] = [];\n    let size = 0;\n    request.on('data', (chunk: Buffer) => {\n      size += chunk.length;\n      if (size > maxBytes) {\n        reject(new Error(`Request body is over ${maxBytes} bytes.`));\n        request.destroy();\n        return;\n      }\n      chunks.push(chunk);\n    });\n    request.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));\n    request.on('error', reject);\n  });\n\nconst sendText = (response: ServerResponse, status: number, text: string) => {\n  response.writeHead(status, { 'content-type': 'text/plain; charset=utf-8' });\n  response.end(text);\n};\n\nconst LOOPBACK_HOSTNAMES = new Set(['127.0.0.1', 'localhost', '[::1]']);\n\n/** Whether a `Host` header names the loopback listener, which a DNS-rebinding page's own hostname does not. */\nexport const isLoopbackHost = (host: string | undefined): boolean => {\n  if (host === undefined) {\n    return false;\n  }\n  try {\n    return LOOPBACK_HOSTNAMES.has(new URL(`http://${host}`).hostname);\n  } catch {\n    return false;\n  }\n};\n\n/** Shape only: the snapshot surface validates the rest and draws what it can. */\nconst isComposition = (value: unknown): value is Composition =>\n  typeof value === 'object' &&\n  value !== null &&\n  'type' in value &&\n  typeof value.type === 'string';\n\nconst isPdfRequest = (\n  value: unknown\n): value is { title?: string; compositions: Composition[] } =>\n  typeof value === 'object' &&\n  value !== null &&\n  'compositions' in value &&\n  Array.isArray(value.compositions) &&\n  value.compositions.length > 0 &&\n  value.compositions.every(isComposition) &&\n  (!('title' in value) ||\n    value.title === undefined ||\n    typeof value.title === 'string');\n\nconst describeError = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n\nexport interface DevServerOptions {\n  configPath: string;\n  port: number;\n  loader?: ConfigLoader | undefined;\n  log?: ((line: string) => void) | undefined;\n}\n\ninterface LoadedConfig {\n  config: StudioConfig;\n  renderers: NodeRenderers | undefined;\n}\n\nexport interface DevServer {\n  url: string;\n  close: () => Promise<void>;\n}\n\n/** Serves the Studio for `configPath` with hot updates, re-running the Node-side config whenever its modules change. */\nexport const startDevServer = async ({\n  configPath: givenConfigPath,\n  port,\n  loader,\n  log = (line) => process.stdout.write(`${line}\\n`),\n}: DevServerOptions): Promise<DevServer> => {\n  // Vite's module ids and serving allow list compare real paths.\n  const configPath = realpathSync(givenConfigPath);\n  if (!existsSync(join(APP_DIR, 'index.html'))) {\n    throw new Error(\n      `The Studio's app assets are missing from ${APP_DIR}. In the Isomer repository, run \\`pnpm build\\` once.`\n    );\n  }\n  assertSingleReact(configPath);\n  if (loader === 'none') {\n    log(\n      'PNGs render with the config as loaded now: Node caches a plain import(), so restart dev to pick up config or pack changes.'\n    );\n  }\n\n  const server: Server = createServer();\n  const fontFiles = new Set<string>();\n  const vite = await createViteServer(\n    devViteConfig({\n      configPath,\n      server,\n      onConfigChange: (stale) => reloadConfig(stale),\n      reloadsWith: () => fontFiles,\n    })\n  );\n  const runner =\n    loader === 'none'\n      ? undefined\n      : createServerModuleRunner(vite.environments.ssr, { hmr: false });\n\n  const importModule = createStudioImporter(configPath, { loader });\n  const importConfig = async (): Promise<LoadedConfig> => {\n    const config = runner\n      ? studioConfigFrom(await runner.import(configPath), configPath)\n      : await loadStudioConfig(configPath, { importModule });\n    const fonts = imageFontsOf(config, configPath, async (path) => {\n      if (!runner) {\n        return importModule(path);\n      }\n      const namespace: unknown = await runner.import(path);\n      const node = await vite.environments.ssr.moduleGraph.getModuleByUrl(path);\n      fontFiles.clear();\n      if (node?.file) {\n        fontFiles.add(node.file);\n      }\n      return namespace;\n    });\n    return { config, renderers: createRenderers(config.runtime, fonts) };\n  };\n\n  let loaded = importConfig();\n\n  const reloadConfig: ConfigChangeHandler = async (stale) => {\n    if (!runner) {\n      return;\n    }\n    const { evaluatedModules } = runner;\n    stale.forEach(({ id }) => {\n      const node = id === null ? undefined : evaluatedModules.getModuleById(id);\n      if (node) {\n        evaluatedModules.invalidateModule(node);\n      }\n    });\n    const previous = loaded;\n    loaded = previous.then(importConfig).catch((error: unknown) => {\n      log(`Could not reload the Studio config: ${describeError(error)}`);\n      return previous;\n    });\n    await loaded;\n  };\n\n  const close = async () => {\n    await runner?.close();\n    await vite.close();\n  };\n\n  try {\n    await loaded;\n  } catch (error) {\n    await close();\n    throw error;\n  }\n\n  const png = async (request: IncomingMessage, response: ServerResponse) => {\n    const { renderers } = await loaded;\n    if (!renderers) {\n      sendText(response, 404, 'The runtime has no snapshot surface.');\n      return;\n    }\n    try {\n      const composition: unknown = JSON.parse(await readBody(request));\n      if (!isComposition(composition)) {\n        sendText(response, 400, 'Not a composition.');\n        return;\n      }\n      const image = await renderers.png(composition);\n      response.writeHead(200, {\n        'content-type': 'image/png',\n        'cache-control': 'no-store',\n      });\n      response.end(image);\n    } catch (error) {\n      sendText(response, 400, describeError(error));\n    }\n  };\n\n  const pdf = async (request: IncomingMessage, response: ServerResponse) => {\n    const { renderers } = await loaded;\n    if (!renderers) {\n      sendText(response, 404, 'The runtime has no snapshot surface.');\n      return;\n    }\n    try {\n      const body: unknown = JSON.parse(\n        await readBody(request, MAX_PDF_BODY_BYTES)\n      );\n      if (!isPdfRequest(body)) {\n        sendText(response, 400, 'Not one or more compositions.');\n        return;\n      }\n      const { title, compositions } = body;\n      const document = await renderers.pdf(compositions, { title });\n      response.writeHead(200, {\n        'content-type': 'application/pdf',\n        'cache-control': 'no-store',\n      });\n      response.end(document);\n    } catch (error) {\n      sendText(response, 400, describeError(error));\n    }\n  };\n\n  const transformJsx = async (\n    request: IncomingMessage,\n    response: ServerResponse\n  ) => {\n    try {\n      const { code } = await transform(\n        await readBody(request),\n        JSX_TRANSFORM_OPTIONS\n      );\n      response.writeHead(200, {\n        'content-type': 'text/javascript; charset=utf-8',\n      });\n      response.end(code);\n    } catch (error) {\n      sendText(response, 400, describeTransformError(error));\n    }\n  };\n\n  const serveAsset = async (pathname: string, response: ServerResponse) => {\n    const relativePath = normalize(pathname.slice('/assets/'.length));\n    const file = relativePath.startsWith('..')\n      ? undefined\n      : await readFile(join(ASSETS_DIR, relativePath)).catch(() => undefined);\n    if (!file) {\n      sendText(response, 404, 'Not found');\n      return;\n    }\n    response.writeHead(200, {\n      'content-type':\n        CONTENT_TYPES[extname(pathname)] ?? 'application/octet-stream',\n      'cache-control': 'no-store',\n    });\n    response.end(file);\n  };\n\n  const serveIndex = async (url: string, response: ServerResponse) => {\n    try {\n      const { config } = await loaded;\n      const html = await vite.transformIndexHtml(\n        url,\n        renderIndexHtml({\n          base: '/',\n          title: config.title,\n          entry: DEV_ENTRY_URL,\n        })\n      );\n      response.writeHead(200, { 'content-type': 'text/html; charset=utf-8' });\n      response.end(html);\n    } catch (error) {\n      sendText(response, 500, describeError(error));\n    }\n  };\n\n  server.on('request', (request: IncomingMessage, response: ServerResponse) => {\n    if (!isLoopbackHost(request.headers.host)) {\n      sendText(response, 403, 'Forbidden host');\n      return;\n    }\n    const url = request.url ?? '/';\n    const { pathname } = new URL(url, `http://${HOST}`);\n    if (request.method === 'POST' && pathname === '/transform') {\n      void transformJsx(request, response);\n      return;\n    }\n    if (request.method === 'POST' && pathname === '/png') {\n      void png(request, response);\n      return;\n    }\n    if (request.method === 'POST' && pathname === '/pdf') {\n      void pdf(request, response);\n      return;\n    }\n    if (pathname === '/' || pathname === '/index.html') {\n      void serveIndex(url, response);\n      return;\n    }\n    if (pathname.startsWith('/assets/')) {\n      void serveAsset(pathname, response);\n      return;\n    }\n    vite.middlewares(request, response, () =>\n      sendText(response, 404, 'Not found')\n    );\n  });\n\n  await new Promise<void>((resolve, reject) => {\n    server.once('error', (error: NodeJS.ErrnoException) =>\n      reject(\n        error.code === 'EADDRINUSE'\n          ? new Error(`Port ${port} is in use; pass --port.`)\n          : error\n      )\n    );\n    server.listen(port, HOST, () => resolve());\n  }).catch(async (error: unknown) => {\n    await close();\n    throw error;\n  });\n\n  const address = server.address();\n  const boundPort =\n    typeof address === 'object' && address !== null ? address.port : port;\n  return {\n    url: `http://${HOST}:${boundPort}/`,\n    close: async () => {\n      await close();\n      await new Promise<void>((resolve) => server.close(() => resolve()));\n    },\n  };\n};\n"]}

package/dist/node/init_config.d.ts

@@ -0,0 +1,30 @@
+import type { ConfigLoader } from './load_config.js';
+/** The module whose exports name the project's packs: its source index, else its manifest's root entry. */
+export declare const packEntry: (projectDir: string) => string;
+/** Structural, since a pack carries no brand: what `definePrimitivePack` returns. */
+export declare const isPrimitivePack: (value: unknown) => boolean;
+/** A pack a module exports, and where a config reaches it. */
+export type PackImport = {
+    from: 'named';
+    name: string;
+} | {
+    from: 'default';
+}
+/** A property of a default-exported object, as a CommonJS module exposes its packs. */
+ | {
+    from: 'defaultObject';
+    name: string;
+};
+/** Each distinct pack `namespace` exports, once, so an alias or a CommonJS mirror of a named export is not registered twice. */
+export declare const packImports: (namespace: unknown) => PackImport[];
+/** The config `init` writes: the packs `entry` exports, each under a local name no other import takes. */
+export declare const initConfigSource: ({ entry, imports, title, }: {
+    entry: string;
+    imports: readonly PackImport[];
+    title?: string | undefined;
+}) => string;
+/** Writes a config into `projectDir` naming the packs its entry exports, `.ts` beside a `tsconfig.json` and `.js` otherwise, and returns its path. */
+export declare const writeInitConfig: (projectDir: string, { loader }?: {
+    loader?: ConfigLoader | undefined;
+}) => Promise<string>;
+//# sourceMappingURL=init_config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init_config.d.ts","sourceRoot":"","sources":["../../src/node/init_config.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAiDlD,2GAA2G;AAC3G,eAAO,MAAM,SAAS,GAAI,YAAY,MAAM,KAAG,MAY9C,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,OAKV,CAAC;AAYxC,8DAA8D;AAC9D,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE;AACrB,uFAAuF;GACrF;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,gIAAgI;AAChI,eAAO,MAAM,WAAW,GAAI,WAAW,OAAO,KAAG,UAAU,EAwB1D,CAAC;AAOF,0GAA0G;AAC1G,eAAO,MAAM,gBAAgB,GAAI,4BAI9B;IACD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,KAAG,MAkDH,CAAC;AAEF,sJAAsJ;AACtJ,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,EAClB,aAAY;IAAE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAAO,KACrD,OAAO,CAAC,MAAM,CA8BhB,CAAC"}

package/dist/node/init_config.js

@@ -0,0 +1,158 @@
+/*
+ * 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, readFileSync, writeFileSync } from 'node:fs';
+import { join, relative, sep } from 'node:path';
+import { createStudioImporter, findDefaultConfig } from './load_config.js';
+/** Tried before the manifest's entries, so a pack runs from source without a build. */
+const SOURCE_ENTRIES = ['src/index', 'index'].flatMap((base) => ['tsx', 'ts', 'jsx', 'js'].map((extension) => `${base}.${extension}`));
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const readManifest = (projectDir) => {
+    const path = join(projectDir, 'package.json');
+    if (!existsSync(path)) {
+        throw new Error(`No package.json in ${projectDir}: run init in a pack's package directory.`);
+    }
+    const manifest = JSON.parse(readFileSync(path, 'utf8'));
+    return isRecord(manifest) ? manifest : {};
+};
+/** Conditions `init` follows in a manifest's `exports`, nested ones included; `types` names no runnable file. */
+const CONDITIONS = ['import', 'module', 'require', 'node', 'default'];
+/** The file an `exports` value names for the package root. */
+const exportTarget = (target) => {
+    if (typeof target === 'string') {
+        return target;
+    }
+    const candidates = Array.isArray(target)
+        ? target
+        : isRecord(target)
+            ? '.' in target
+                ? [target['.']]
+                : CONDITIONS.map((condition) => target[condition])
+            : [];
+    return candidates
+        .map(exportTarget)
+        .find((path) => path !== undefined);
+};
+/** The module whose exports name the project's packs: its source index, else its manifest's root entry. */
+export const packEntry = (projectDir) => {
+    const { exports, module, main } = readManifest(projectDir);
+    const found = [...SOURCE_ENTRIES, exportTarget(exports), module, main]
+        .filter((path) => typeof path === 'string')
+        .map((path) => join(projectDir, path))
+        .find((path) => existsSync(path));
+    if (found === undefined) {
+        throw new Error(`No pack entry in ${projectDir}: add src/index.ts, or point package.json "main" at the module that exports the pack.`);
+    }
+    return found;
+};
+/** Structural, since a pack carries no brand: what `definePrimitivePack` returns. */
+export const isPrimitivePack = (value) => isRecord(value) &&
+    typeof value.id === 'string' &&
+    Array.isArray(value.primitives) &&
+    isRecord(value.types) &&
+    typeof value.types.has === 'function';
+/** A single-quoted string literal. */
+const quote = (value) => `'${value.replace(/[\\']/g, (char) => `\\${char}`).replace(/\n/g, '\\n')}'`;
+/** `path` from `fromDir`, as an import specifier. */
+const specifierFrom = (fromDir, path) => {
+    const inside = relative(fromDir, path).split(sep).join('/');
+    return inside.startsWith('.') ? inside : `./${inside}`;
+};
+/** Each distinct pack `namespace` exports, once, so an alias or a CommonJS mirror of a named export is not registered twice. */
+export const packImports = (namespace) => {
+    const exports = isRecord(namespace) ? namespace : {};
+    const { default: fallback } = exports;
+    const seen = new Set();
+    const found = [];
+    const take = (value, pack) => {
+        if (isPrimitivePack(value) && !seen.has(value)) {
+            seen.add(value);
+            found.push(pack);
+        }
+    };
+    Object.entries(exports).forEach(([name, value]) => {
+        if (name !== 'default') {
+            take(value, { from: 'named', name });
+        }
+    });
+    if (isPrimitivePack(fallback)) {
+        take(fallback, { from: 'default' });
+    }
+    else if (isRecord(fallback)) {
+        Object.entries(fallback).forEach(([name, value]) => take(value, { from: 'defaultObject', name }));
+    }
+    return found;
+};
+/** The names the config's own imports take. */
+const HELPERS = ['createIsomerRuntime', 'defineStudioConfig'];
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+/** The config `init` writes: the packs `entry` exports, each under a local name no other import takes. */
+export const initConfigSource = ({ entry, imports, title, }) => {
+    const taken = new Set(HELPERS);
+    const local = (wanted) => {
+        let name = wanted;
+        for (let suffix = 2; taken.has(name); suffix += 1) {
+            name = `${wanted}${suffix}`;
+        }
+        taken.add(name);
+        return name;
+    };
+    // Named packs keep their own names where they can, so they are claimed first.
+    const named = new Map(imports.flatMap((pack) => pack.from === 'named' ? [[pack.name, local(pack.name)]] : []));
+    const defaultName = local(imports.some(({ from }) => from === 'default') ? 'pack' : 'entry');
+    const packs = imports.map((pack) => {
+        switch (pack.from) {
+            case 'named':
+                return named.get(pack.name);
+            case 'default':
+                return defaultName;
+            case 'defaultObject':
+                return IDENTIFIER.test(pack.name)
+                    ? `${defaultName}.${pack.name}`
+                    : `${defaultName}[${quote(pack.name)}]`;
+        }
+    });
+    const specifiers = [...named].map(([name, as]) => name === as ? name : `${name} as ${as}`);
+    const bindings = [
+        ...(imports.some(({ from }) => from !== 'named') ? [defaultName] : []),
+        ...(specifiers.length ? [`{ ${specifiers.join(', ')} }`] : []),
+    ];
+    return [
+        "import { createIsomerRuntime } from '@elastic/isomer-runtime';",
+        "import { defineStudioConfig } from '@elastic/isomer-studio';",
+        '',
+        `import ${bindings.join(', ')} from ${quote(entry)};`,
+        '',
+        'export default defineStudioConfig({',
+        ...(title === undefined ? [] : [`  title: ${quote(title)},`]),
+        `  runtime: createIsomerRuntime({ packs: [${packs.join(', ')}] }),`,
+        '});',
+        '',
+    ].join('\n');
+};
+/** Writes a config into `projectDir` naming the packs its entry exports, `.ts` beside a `tsconfig.json` and `.js` otherwise, and returns its path. */
+export const writeInitConfig = async (projectDir, { loader } = {}) => {
+    const existing = findDefaultConfig(projectDir);
+    if (existing !== undefined) {
+        throw new Error(`${existing} already exists.`);
+    }
+    const entry = packEntry(projectDir);
+    const imports = packImports(await createStudioImporter(entry, { loader })(entry));
+    if (!imports.length) {
+        throw new Error(`${specifierFrom(projectDir, entry)} exports no primitive pack.`);
+    }
+    const typed = existsSync(join(projectDir, 'tsconfig.json'));
+    const specifier = specifierFrom(projectDir, entry);
+    const configPath = join(projectDir, typed ? 'isomer-studio.config.ts' : 'isomer-studio.config.js');
+    const { name } = readManifest(projectDir);
+    writeFileSync(configPath, initConfigSource({
+        entry: typed ? specifier.replace(/\.tsx?$/, '') : specifier,
+        imports,
+        title: typeof name === 'string' ? name : undefined,
+    }));
+    return configPath;
+};
+//# sourceMappingURL=init_config.js.map

package/dist/node/init_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init_config.js","sourceRoot":"","sources":["../../src/node/init_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 { existsSync, readFileSync, writeFileSync } from 'node:fs';\nimport { join, relative, sep } from 'node:path';\n\nimport type { ConfigLoader } from './load_config';\nimport { createStudioImporter, findDefaultConfig } from './load_config';\n\n/** Tried before the manifest's entries, so a pack runs from source without a build. */\nconst SOURCE_ENTRIES = ['src/index', 'index'].flatMap((base) =>\n  ['tsx', 'ts', 'jsx', 'js'].map((extension) => `${base}.${extension}`)\n);\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null;\n\ninterface Manifest {\n  name?: unknown;\n  exports?: unknown;\n  module?: unknown;\n  main?: unknown;\n}\n\nconst readManifest = (projectDir: string): Manifest => {\n  const path = join(projectDir, 'package.json');\n  if (!existsSync(path)) {\n    throw new Error(\n      `No package.json in ${projectDir}: run init in a pack's package directory.`\n    );\n  }\n  const manifest: unknown = JSON.parse(readFileSync(path, 'utf8'));\n  return isRecord(manifest) ? manifest : {};\n};\n\n/** Conditions `init` follows in a manifest's `exports`, nested ones included; `types` names no runnable file. */\nconst CONDITIONS = ['import', 'module', 'require', 'node', 'default'] as const;\n\n/** The file an `exports` value names for the package root. */\nconst exportTarget = (target: unknown): string | undefined => {\n  if (typeof target === 'string') {\n    return target;\n  }\n  const candidates = Array.isArray(target)\n    ? target\n    : isRecord(target)\n      ? '.' in target\n        ? [target['.']]\n        : CONDITIONS.map((condition) => target[condition])\n      : [];\n  return candidates\n    .map(exportTarget)\n    .find((path): path is string => path !== undefined);\n};\n\n/** The module whose exports name the project's packs: its source index, else its manifest's root entry. */\nexport const packEntry = (projectDir: string): string => {\n  const { exports, module, main } = readManifest(projectDir);\n  const found = [...SOURCE_ENTRIES, exportTarget(exports), module, main]\n    .filter((path): path is string => typeof path === 'string')\n    .map((path) => join(projectDir, path))\n    .find((path) => existsSync(path));\n  if (found === undefined) {\n    throw new Error(\n      `No pack entry in ${projectDir}: add src/index.ts, or point package.json \"main\" at the module that exports the pack.`\n    );\n  }\n  return found;\n};\n\n/** Structural, since a pack carries no brand: what `definePrimitivePack` returns. */\nexport const isPrimitivePack = (value: unknown): boolean =>\n  isRecord(value) &&\n  typeof value.id === 'string' &&\n  Array.isArray(value.primitives) &&\n  isRecord(value.types) &&\n  typeof value.types.has === 'function';\n\n/** A single-quoted string literal. */\nconst quote = (value: string): string =>\n  `'${value.replace(/[\\\\']/g, (char) => `\\\\${char}`).replace(/\\n/g, '\\\\n')}'`;\n\n/** `path` from `fromDir`, as an import specifier. */\nconst specifierFrom = (fromDir: string, path: string): string => {\n  const inside = relative(fromDir, path).split(sep).join('/');\n  return inside.startsWith('.') ? inside : `./${inside}`;\n};\n\n/** A pack a module exports, and where a config reaches it. */\nexport type PackImport =\n  | { from: 'named'; name: string }\n  | { from: 'default' }\n  /** A property of a default-exported object, as a CommonJS module exposes its packs. */\n  | { from: 'defaultObject'; name: string };\n\n/** Each distinct pack `namespace` exports, once, so an alias or a CommonJS mirror of a named export is not registered twice. */\nexport const packImports = (namespace: unknown): PackImport[] => {\n  const exports = isRecord(namespace) ? namespace : {};\n  const { default: fallback } = exports;\n  const seen = new Set<unknown>();\n  const found: PackImport[] = [];\n  const take = (value: unknown, pack: PackImport) => {\n    if (isPrimitivePack(value) && !seen.has(value)) {\n      seen.add(value);\n      found.push(pack);\n    }\n  };\n  Object.entries(exports).forEach(([name, value]) => {\n    if (name !== 'default') {\n      take(value, { from: 'named', name });\n    }\n  });\n  if (isPrimitivePack(fallback)) {\n    take(fallback, { from: 'default' });\n  } else if (isRecord(fallback)) {\n    Object.entries(fallback).forEach(([name, value]) =>\n      take(value, { from: 'defaultObject', name })\n    );\n  }\n  return found;\n};\n\n/** The names the config's own imports take. */\nconst HELPERS = ['createIsomerRuntime', 'defineStudioConfig'];\n\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/;\n\n/** The config `init` writes: the packs `entry` exports, each under a local name no other import takes. */\nexport const initConfigSource = ({\n  entry,\n  imports,\n  title,\n}: {\n  entry: string;\n  imports: readonly PackImport[];\n  title?: string | undefined;\n}): string => {\n  const taken = new Set(HELPERS);\n  const local = (wanted: string): string => {\n    let name = wanted;\n    for (let suffix = 2; taken.has(name); suffix += 1) {\n      name = `${wanted}${suffix}`;\n    }\n    taken.add(name);\n    return name;\n  };\n  // Named packs keep their own names where they can, so they are claimed first.\n  const named = new Map(\n    imports.flatMap((pack) =>\n      pack.from === 'named' ? [[pack.name, local(pack.name)] as const] : []\n    )\n  );\n  const defaultName = local(\n    imports.some(({ from }) => from === 'default') ? 'pack' : 'entry'\n  );\n  const packs = imports.map((pack) => {\n    switch (pack.from) {\n      case 'named':\n        return named.get(pack.name);\n      case 'default':\n        return defaultName;\n      case 'defaultObject':\n        return IDENTIFIER.test(pack.name)\n          ? `${defaultName}.${pack.name}`\n          : `${defaultName}[${quote(pack.name)}]`;\n    }\n  });\n  const specifiers = [...named].map(([name, as]) =>\n    name === as ? name : `${name} as ${as}`\n  );\n  const bindings = [\n    ...(imports.some(({ from }) => from !== 'named') ? [defaultName] : []),\n    ...(specifiers.length ? [`{ ${specifiers.join(', ')} }`] : []),\n  ];\n  return [\n    \"import { createIsomerRuntime } from '@elastic/isomer-runtime';\",\n    \"import { defineStudioConfig } from '@elastic/isomer-studio';\",\n    '',\n    `import ${bindings.join(', ')} from ${quote(entry)};`,\n    '',\n    'export default defineStudioConfig({',\n    ...(title === undefined ? [] : [`  title: ${quote(title)},`]),\n    `  runtime: createIsomerRuntime({ packs: [${packs.join(', ')}] }),`,\n    '});',\n    '',\n  ].join('\\n');\n};\n\n/** Writes a config into `projectDir` naming the packs its entry exports, `.ts` beside a `tsconfig.json` and `.js` otherwise, and returns its path. */\nexport const writeInitConfig = async (\n  projectDir: string,\n  { loader }: { loader?: ConfigLoader | undefined } = {}\n): Promise<string> => {\n  const existing = findDefaultConfig(projectDir);\n  if (existing !== undefined) {\n    throw new Error(`${existing} already exists.`);\n  }\n  const entry = packEntry(projectDir);\n  const imports = packImports(\n    await createStudioImporter(entry, { loader })(entry)\n  );\n  if (!imports.length) {\n    throw new Error(\n      `${specifierFrom(projectDir, entry)} exports no primitive pack.`\n    );\n  }\n  const typed = existsSync(join(projectDir, 'tsconfig.json'));\n  const specifier = specifierFrom(projectDir, entry);\n  const configPath = join(\n    projectDir,\n    typed ? 'isomer-studio.config.ts' : 'isomer-studio.config.js'\n  );\n  const { name } = readManifest(projectDir);\n  writeFileSync(\n    configPath,\n    initConfigSource({\n      entry: typed ? specifier.replace(/\\.tsx?$/, '') : specifier,\n      imports,\n      title: typeof name === 'string' ? name : undefined,\n    })\n  );\n  return configPath;\n};\n"]}

package/dist/node/load_config.d.ts

@@ -0,0 +1,34 @@
+import type { ReactNode } from 'react';
+import type { StudioConfig } from '../config.js';
+export type ConfigLoader = 'none' | 'tsx';
+export declare const DEFAULT_CONFIG_NAMES: readonly ["isomer-studio.config.ts", "isomer-studio.config.tsx", "isomer-studio.config.js"];
+/** The first default config name that exists in `cwd`. */
+export declare const findDefaultConfig: (cwd: string) => string | undefined;
+/** `config` against `cwd`, or the first default name that exists there. */
+export declare const resolveConfigPath: (cwd: string, config?: string) => string;
+/** Throws unless the config resolves React 18, which EUI needs, and `@elastic/isomer-runtime` resolves the same copy. */
+export declare const assertSingleReact: (configPath: string) => void;
+/** 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 declare const assertSingleEui: (configPath: string, studioDir?: string) => void;
+/** The `tsconfig.json` nearest the config, which `tsx` applies to the files it includes. */
+export declare const nearestTsconfig: (configPath: string) => string | undefined;
+/** The Studio config a module namespace default-exports, or an error naming `configPath`. */
+export declare const studioConfigFrom: (namespace: unknown, configPath: string) => StudioConfig;
+/** Applies the Studio's module resolution to every later `import` in this process; a process serves one project. */
+export declare const registerProjectResolution: (configPath: string) => void;
+export type StudioModuleImporter = (path: string) => Promise<unknown>;
+/**
+ * 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 declare const createStudioImporter: (configPath: string, { loader }?: {
+    loader?: ConfigLoader | undefined;
+}) => StudioModuleImporter;
+/** Imports the config's default export in Node; `tsx` compiles TypeScript and leaves resolution to Node. */
+export declare const loadStudioConfig: (configPath: string, { loader, importModule, }?: {
+    loader?: ConfigLoader | undefined;
+    importModule?: StudioModuleImporter | undefined;
+}) => Promise<StudioConfig>;
+/** `react-dom/server`'s `renderToString`, from the config's own React. */
+export declare const loadRenderToString: (configPath: string) => ((node: ReactNode) => string);
+//# sourceMappingURL=load_config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load_config.d.ts","sourceRoot":"","sources":["../../src/node/load_config.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAS9C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1C,eAAO,MAAM,oBAAoB,6FAIvB,CAAC;AAEX,0DAA0D;AAC1D,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,SAGtD,CAAC;AAEJ,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,EAAE,SAAS,MAAM,KAAG,MAehE,CAAC;AAmCF,yHAAyH;AACzH,eAAO,MAAM,iBAAiB,GAAI,YAAY,MAAM,KAAG,IA2BtD,CAAC;AAoCF,kJAAkJ;AAClJ,eAAO,MAAM,eAAe,GAC1B,YAAY,MAAM,EAClB,YAAW,MAAoB,KAC9B,IAyBF,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,eAAe,GAAI,YAAY,MAAM,KAAG,MAAM,GAAG,SAU7D,CAAC;AAwBF,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,GAC3B,WAAW,OAAO,EAClB,YAAY,MAAM,KACjB,YAgCF,CAAC;AAIF,oHAAoH;AACpH,eAAO,MAAM,yBAAyB,GAAI,YAAY,MAAM,KAAG,IAyB9D,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,MAAM,EAClB,aAAoB;IAAE,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAA;CAAO,KAC7D,oBASF,CAAC;AAEF,4GAA4G;AAC5G,eAAO,MAAM,gBAAgB,GAC3B,YAAY,MAAM,EAClB,4BAGG;IACD,MAAM,CAAC,EAAE,YAAY,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CAC5C,KACL,OAAO,CAAC,YAAY,CAGtB,CAAC;AAMF,0EAA0E;AAC1E,eAAO,MAAM,kBAAkB,GAC7B,YAAY,MAAM,KACjB,CAAC,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,CAO9B,CAAC"}