@oddkin/workbench 0.0.0-stage → 1.0.0-beta.0

package/dist/node/inputs.d.ts

@@ -0,0 +1,24 @@
+import { type DocsContent, type ResolvedWorkbenchConfig } from '../config/index.js';
+import type { JsonObject, LibraryInput, TokenInspectionLike } from '../data/types.js';
+import { DiagnosticList } from '../internal/diagnostics.js';
+import { type InstalledPackage } from './packages.js';
+export declare const DOCS_FILES: readonly ['oddkin.docs.ts', 'oddkin.docs.mts', 'oddkin.docs.js', 'oddkin.docs.mjs', 'oddkin.docs.json'];
+export interface WorkbenchInputs {
+    readonly libraries: readonly LibraryInput[];
+    /** The documented packages and their runtime dependencies: what preview frames load. */
+    readonly graph: readonly InstalledPackage[];
+    readonly docs?: DocsContent;
+    readonly tokens?: TokenInspectionLike;
+    /** Theme Studio's baseline: `themeStudio.themeConfig` as its JSON model. */
+    readonly theme?: {
+        readonly config: JsonObject;
+        readonly source: string;
+    };
+    /** Files read as data; a change to one rebuilds the data. */
+    readonly dataFiles: readonly string[];
+    /** Authored content files that were read or attempted (watched with the configuration). */
+    readonly contentFiles: readonly string[];
+}
+/** Read every input of the Workbench data for the configuration at `root`. */
+export declare function loadInputs(root: string, config: ResolvedWorkbenchConfig, out: DiagnosticList): Promise<WorkbenchInputs>;
+//# sourceMappingURL=inputs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../src/node/inputs.ts"],"names":[],"mappings":"AAOA,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAEjG,OAAO,KAAK,EAEV,UAAU,EACV,YAAY,EACZ,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,cAAc,EAAY,MAAM,4BAA4B,CAAC;AAGtE,OAAO,EAA6C,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjG,eAAO,MAAM,UAAU,YACrB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,CACV,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAC5C,wFAAwF;IACxF,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,CAAC;IACtC,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,2FAA2F;IAC3F,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAuJD,8EAA8E;AAC9E,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,uBAAuB,EAC/B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,eAAe,CAAC,CA2F1B"}

package/dist/node/inputs.js

@@ -0,0 +1,259 @@
+/**
+ * Read what the Workbench documents: each library package's published CEM and enrichment, the
+ * token inspection its foundations reference, and authored content (`oddkin.docs.*`).
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { extname, isAbsolute, join, relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { DOCS_SCHEMA } from '../config/index.js';
+import { resolveExport } from '../data/import-map.js';
+import { toExamplesJSON } from '../examples/index.js';
+import { DiagnosticList, isObject } from '../internal/diagnostics.js';
+import { loadDefault, loadFailure } from './config.js';
+import { findPackageDir, packageGraph, readPackage } from './packages.js';
+export const DOCS_FILES = [
+    'oddkin.docs.ts',
+    'oddkin.docs.mts',
+    'oddkin.docs.js',
+    'oddkin.docs.mjs',
+    'oddkin.docs.json',
+];
+const inside = (file, dir) => {
+    const rel = relative(dir, file);
+    return rel !== '' && !rel.startsWith('..') && !isAbsolute(rel);
+};
+function readJson(file, out, code) {
+    try {
+        return JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (error) {
+        out.error(code, `${file}: ${error instanceof Error ? error.message : String(error)}`);
+        return undefined;
+    }
+}
+/** The token inspections the libraries' foundations reference, in order. */
+function inspectionSources(libraries) {
+    const found = new Map();
+    for (const library of libraries) {
+        for (const foundation of Object.values(library.metadata?.foundations ?? {})) {
+            const generation = foundation
+                .generation;
+            const source = generation?.value?.source;
+            if (!isObject(source))
+                continue;
+            const { package: name, export: subpath } = source;
+            if (typeof name === 'string' && typeof subpath === 'string')
+                found.set(`${name}#${subpath}`, { package: name, export: subpath });
+        }
+    }
+    return [...found.values()];
+}
+async function loadContent(root, config, out) {
+    const files = config.content.files
+        ? config.content.files.map((file) => resolve(root, file))
+        : DOCS_FILES.map((name) => join(root, name))
+            .filter((file) => existsSync(file))
+            .slice(0, 1);
+    const pages = {};
+    const aliases = {};
+    let locale;
+    const loaded = [];
+    for (const file of files) {
+        if (!existsSync(file)) {
+            out.error('node.content.missing', `Content file ${file} does not exist.`, '/content/files');
+            continue;
+        }
+        if (extname(file) === '.md') {
+            out.warn('node.content.unsupported', `${file}: Markdown content is not read yet; use oddkin.docs.ts or JSON.`, '/content/files');
+            continue;
+        }
+        let value;
+        try {
+            value = await loadDefault(file);
+        }
+        catch (error) {
+            out.error('node.content.load', loadFailure(file, error), '/content/files');
+            continue;
+        }
+        if (!isObject(value) || !isObject(value['pages'])) {
+            out.error('node.content.invalid', `${file}: authored content must be an object with "pages" (use defineDocs).`, '/content/files');
+            continue;
+        }
+        loaded.push(file);
+        const content = value;
+        for (const [id, page] of Object.entries(content.pages)) {
+            if (id in pages)
+                out.warn('node.content.duplicate', `${file} describes page "${id}" again; the first file's content is kept.`, `/pages/${id}`);
+            else
+                pages[id] = page;
+        }
+        for (const [from, to] of Object.entries(content.aliases ?? {}))
+            aliases[from] ??= to;
+        locale ??= content.locale;
+    }
+    if (loaded.length === 0)
+        return { files };
+    return {
+        docs: {
+            schema: DOCS_SCHEMA,
+            ...(locale ? { locale } : {}),
+            ...(Object.keys(aliases).length ? { aliases } : {}),
+            pages,
+        },
+        files,
+    };
+}
+/**
+ * The example sets (`defineExamples` modules) the metadata names, as data. Example modules are
+ * trusted project code; a package that does not ship them (a published build without sources)
+ * keeps its examples listed without values.
+ */
+async function loadExampleSets(dir, metadata, out, dataFiles) {
+    const files = new Set();
+    for (const example of Object.values(metadata?.examples ?? {})) {
+        const file = example.file;
+        if (typeof file === 'string' && file)
+            files.add(file);
+    }
+    const sets = [];
+    for (const file of files) {
+        const path = resolve(dir, file);
+        if (!inside(path, dir) || !existsSync(path))
+            continue;
+        dataFiles.push(path);
+        let value;
+        try {
+            value = await loadDefault(path);
+        }
+        catch (error) {
+            out.warn('node.examples.load', loadFailure(path, error), '/examples');
+            continue;
+        }
+        if (!isObject(value) ||
+            typeof value['component'] !== 'string' ||
+            !isObject(value['examples'])) {
+            out.warn('node.examples.invalid', `${path}: the default export is not an example set (use defineExamples).`, '/examples');
+            continue;
+        }
+        sets.push(toExamplesJSON(value));
+    }
+    return sets;
+}
+/** Read every input of the Workbench data for the configuration at `root`. */
+export async function loadInputs(root, config, out) {
+    const graph = packageGraph(config.library.packages, root, out);
+    const byName = new Map();
+    for (const pkg of graph)
+        if (!byName.has(pkg.name))
+            byName.set(pkg.name, pkg);
+    const explicitCem = (config.library.cem ?? []).map((file) => resolve(root, file));
+    const dataFiles = [];
+    const libraries = [];
+    for (const name of config.library.packages) {
+        const pkg = byName.get(name);
+        if (!pkg)
+            continue;
+        const declared = pkg.manifest.customElements;
+        const cemFile = declared
+            ? join(pkg.dir, declared)
+            : explicitCem.find((file) => inside(file, pkg.dir));
+        let cem;
+        if (cemFile && existsSync(cemFile)) {
+            cem = readJson(cemFile, out, 'node.cem.invalid');
+            dataFiles.push(cemFile);
+        }
+        else {
+            out.warn('node.cem.missing', cemFile
+                ? `${name}: its Custom Elements Manifest ${cemFile} does not exist; build the package first.`
+                : `${name} declares no Custom Elements Manifest; add "customElements" to its package.json or list the file in library.cem.`, `/library/packages/${name}`);
+        }
+        const metadataPath = resolveExport(pkg.manifest, './oddkin.metadata.json');
+        const metadataFile = metadataPath ? join(pkg.dir, metadataPath) : undefined;
+        let metadata;
+        if (metadataFile && existsSync(metadataFile)) {
+            metadata = readJson(metadataFile, out, 'node.metadata.invalid');
+            dataFiles.push(metadataFile);
+        }
+        const examples = await loadExampleSets(pkg.dir, metadata, out, dataFiles);
+        libraries.push({
+            name,
+            version: pkg.version,
+            ...(cem ? { cem } : {}),
+            ...(metadata ? { metadata } : {}),
+            ...(examples.length ? { examples } : {}),
+        });
+    }
+    for (const file of explicitCem) {
+        if (!graph.some((pkg) => inside(file, pkg.dir)))
+            out.warn('node.cem.unattributed', `library.cem lists ${file}, which is not inside any documented package; it is ignored.`, '/library/cem');
+    }
+    let tokens;
+    const sources = inspectionSources(libraries);
+    if (sources.length > 1) {
+        out.warn('node.tokens.sources', `Foundations reference ${sources.length} token inspections; ${sources[0]?.package}${(sources[0]?.export ?? '').slice(1)} is used.`, '/foundations');
+    }
+    const source = sources[0];
+    if (source) {
+        const dir = byName.get(source.package)?.dir ?? findPackageDir(source.package, root);
+        const path = dir ? resolveExport(readPackage(dir).manifest, source.export) : undefined;
+        const file = dir && path ? join(dir, path) : undefined;
+        if (file && existsSync(file)) {
+            const value = readJson(file, out, 'node.tokens.invalid');
+            if (isObject(value) && Array.isArray(value['tokens']))
+                tokens = value;
+            dataFiles.push(file);
+        }
+        else {
+            out.warn('node.tokens.missing', `The token inspection ${source.package}${source.export.slice(1)} that the foundations reference was not found.`, '/foundations');
+        }
+    }
+    const theme = await loadThemeConfig(root, config, graph, out, dataFiles);
+    const content = await loadContent(root, config, out);
+    return {
+        ...(theme ? { theme } : {}),
+        libraries,
+        graph,
+        ...(content.docs ? { docs: content.docs } : {}),
+        ...(tokens ? { tokens } : {}),
+        dataFiles,
+        contentFiles: content.files,
+    };
+}
+/**
+ * `themeStudio.themeConfig` as the JSON-compatible model, loaded with the project's own
+ * `@oddkin/tokens/node` `loadConfig()` (theming-and-styling.md ?9): the CLI and Theme Studio
+ * start from the same model. JS and TS configurations are trusted project code.
+ */
+async function loadThemeConfig(root, config, graph, out, dataFiles) {
+    const source = config.themeStudio.themeConfig;
+    if (!source)
+        return undefined;
+    const file = resolve(root, source);
+    const path = '/themeStudio/themeConfig';
+    if (!existsSync(file)) {
+        out.warn('node.themeStudio.config', `themeStudio.themeConfig: ${file} does not exist.`, path);
+        return undefined;
+    }
+    dataFiles.push(file);
+    const dir = graph.find((pkg) => pkg.name === '@oddkin/tokens')?.dir ??
+        findPackageDir('@oddkin/tokens', root);
+    const entry = dir ? resolveExport(readPackage(dir).manifest, './node') : undefined;
+    if (!dir || !entry) {
+        out.warn('node.themeStudio.loader', 'themeStudio.themeConfig needs @oddkin/tokens (its ./node export) installed to load the configuration.', path);
+        return undefined;
+    }
+    try {
+        const tokens = (await import(pathToFileURL(join(dir, entry)).href));
+        const result = await tokens.loadConfig(file);
+        for (const d of result.diagnostics)
+            out.warn('node.themeStudio.config', `${source}${d.path ?? ''}: ${d.message ?? ''}`, path);
+        if (!isObject(result.config))
+            return undefined;
+        return { config: result.config, source };
+    }
+    catch (error) {
+        out.warn('node.themeStudio.config', `themeStudio.themeConfig: ${error instanceof Error ? error.message : String(error)}`, path);
+        return undefined;
+    }
+}
+//# sourceMappingURL=inputs.js.map

package/dist/node/inputs.js.map

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

package/dist/node/packages.d.ts

@@ -0,0 +1,35 @@
+import type { PackageManifest } from '../data/import-map.js';
+import { DiagnosticList } from '../internal/diagnostics.js';
+export interface PackageJson extends PackageManifest {
+    readonly customElements?: string;
+    readonly dependencies?: Readonly<Record<string, string>>;
+    readonly peerDependencies?: Readonly<Record<string, string>>;
+    readonly peerDependenciesMeta?: Readonly<Record<string, {
+        readonly optional?: boolean;
+    }>>;
+}
+export interface InstalledPackage {
+    /** The name importers use (the `node_modules` path it was found under). */
+    readonly name: string;
+    readonly version: string;
+    /** Real path of the package root. */
+    readonly dir: string;
+    readonly manifest: PackageJson;
+}
+/** A package name that is safe to use as a path: `name` or `@scope/name`; no segment starts with a dot. */
+export declare const isPackageName: (name: string) => boolean;
+/** The real directory of package `name` as seen from `from`, or undefined. */
+export declare function findPackageDir(name: string, from: string): string | undefined;
+/** Read the package at `dir`; `name` is how importers refer to it. */
+export declare function readPackage(dir: string, name?: string): InstalledPackage;
+/**
+ * The packages reachable from `roots` (names looked up from `from`, or packages already read),
+ * breadth first in manifest order: each package's `dependencies`, then its other
+ * `peerDependencies`, looked up from that package's directory. A package installed twice
+ * appears twice; import maps keep the first copy and say so. Names in `skip` (Node-only
+ * dependencies of a browser document) are left out with their dependencies.
+ */
+export declare function packageGraph(roots: readonly (string | InstalledPackage)[], from: string, out: DiagnosticList, options?: {
+    readonly skip?: readonly string[];
+}): InstalledPackage[];
+//# sourceMappingURL=packages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"packages.d.ts","sourceRoot":"","sources":["../../src/node/packages.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,oBAAoB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC,CAAC;CAC3F;AAED,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qCAAqC;IACrC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;CAChC;AAID,2GAA2G;AAC3G,eAAO,MAAM,aAAa,SAAU,MAAM,KAAG,OAA0B,CAAC;AAExE,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAS7E;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAQxE;AASD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,EAC7C,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,cAAc,EACnB,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAO,GAClD,gBAAgB,EAAE,CAuDpB"}

package/dist/node/packages.js

@@ -0,0 +1,87 @@
+/**
+ * Package lookup as Node does it (`node_modules` directories up the tree), and the module graph
+ * a document needs: the packages it imports and, transitively, their runtime dependencies.
+ */
+import { existsSync, readFileSync, realpathSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { DiagnosticList } from '../internal/diagnostics.js';
+const NAME = /^(?:@[a-z0-9][\w.~-]*\/)?[a-z0-9][\w.~-]*$/i;
+/** A package name that is safe to use as a path: `name` or `@scope/name`; no segment starts with a dot. */
+export const isPackageName = (name) => NAME.test(name);
+/** The real directory of package `name` as seen from `from`, or undefined. */
+export function findPackageDir(name, from) {
+    if (!isPackageName(name))
+        return undefined;
+    for (let dir = from;;) {
+        const candidate = join(dir, 'node_modules', ...name.split('/'));
+        if (existsSync(join(candidate, 'package.json')))
+            return realpathSync(candidate);
+        const parent = dirname(dir);
+        if (parent === dir)
+            return undefined;
+        dir = parent;
+    }
+}
+/** Read the package at `dir`; `name` is how importers refer to it. */
+export function readPackage(dir, name) {
+    const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+    return {
+        name: name ?? manifest.name ?? '',
+        version: manifest.version ?? '0.0.0',
+        dir: realpathSync(dir),
+        manifest,
+    };
+}
+/**
+ * The packages reachable from `roots` (names looked up from `from`, or packages already read),
+ * breadth first in manifest order: each package's `dependencies`, then its other
+ * `peerDependencies`, looked up from that package's directory. A package installed twice
+ * appears twice; import maps keep the first copy and say so. Names in `skip` (Node-only
+ * dependencies of a browser document) are left out with their dependencies.
+ */
+export function packageGraph(roots, from, out, options = {}) {
+    const skip = new Set(options.skip ?? []);
+    const graph = [];
+    const seen = new Set();
+    const queue = roots.map((root) => typeof root === 'string' ? { name: root, from } : root);
+    const visit = (pkg) => {
+        if (seen.has(pkg.dir))
+            return;
+        seen.add(pkg.dir);
+        graph.push(pkg);
+        const dependencies = Object.keys(pkg.manifest.dependencies ?? {});
+        const peers = Object.keys(pkg.manifest.peerDependencies ?? {}).filter((peer) => !dependencies.includes(peer));
+        for (const name of dependencies)
+            queue.push({ name, from: pkg.dir, requiredBy: pkg.name });
+        for (const name of peers) {
+            const optional = pkg.manifest.peerDependenciesMeta?.[name]?.optional === true;
+            queue.push({ name, from: pkg.dir, requiredBy: pkg.name, optional });
+        }
+    };
+    for (let next = queue.shift(); next; next = queue.shift()) {
+        if ('dir' in next) {
+            visit(next);
+            continue;
+        }
+        if (skip.has(next.name))
+            continue;
+        const dir = findPackageDir(next.name, next.from);
+        if (!dir) {
+            if (next.optional)
+                continue;
+            if (next.requiredBy)
+                out.warn('node.package.missing', `${next.requiredBy} depends on ${next.name}, which is not installed; modules that import it fail to load.`, `/packages/${next.requiredBy}/dependencies/${next.name}`);
+            else
+                out.error('node.package.missing', `Package "${next.name}" is not installed (looked for node_modules/${next.name} from ${next.from} upwards).`, `/library/packages/${next.name}`);
+            continue;
+        }
+        try {
+            visit(readPackage(dir, next.name));
+        }
+        catch (error) {
+            out.error('node.package.unreadable', `${next.name}: package.json could not be read (${error instanceof Error ? error.message : String(error)}).`, `/packages/${next.name}`);
+        }
+    }
+    return graph;
+}
+//# sourceMappingURL=packages.js.map

package/dist/node/packages.js.map

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

package/dist/node/preload.d.ts

@@ -0,0 +1,10 @@
+import type { ImportMap } from '../data/import-map.js';
+/** Resolve `specifier` from the module at URL path `referrer`, as the browser does with `map`. */
+export declare function resolveModule(map: ImportMap, specifier: string, referrer: string): string | undefined;
+/**
+ * Every module `entry` (a bare specifier) imports statically, transitively, entry first.
+ * `packages` maps each served package root URL (`…/m/name@version/`) to its directory;
+ * modules that are not on disk are left out (loading them reports the error).
+ */
+export declare function preloadGraph(map: ImportMap, entry: string, packages: ReadonlyMap<string, string>): string[];
+//# sourceMappingURL=preload.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preload.d.ts","sourceRoot":"","sources":["../../src/node/preload.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAOvD,kGAAkG;AAClG,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,MAAM,EAAE,CAyBV"}

package/dist/node/preload.js

@@ -0,0 +1,61 @@
+/**
+ * The static module graph of a document's entry module, as `modulepreload` URLs: the browser
+ * fetches every module at once instead of discovering them one import level at a time.
+ * Dynamic `import()` targets are left out; documents load them only when they need them.
+ */
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const ORIGIN = 'http://workbench.invalid';
+/** `import … from '…'`, `import '…'`, and `export … from '…'` at the start of a statement. */
+const STATIC_IMPORT = /(?:^|[;}])\s*(?:import|export)\s*(?:[\w$*{}\s,]*?\bfrom\s*)?(['"])([^'"\n]+)\1/gm;
+/** Resolve `specifier` from the module at URL path `referrer`, as the browser does with `map`. */
+export function resolveModule(map, specifier, referrer) {
+    if (/^\.{0,2}\//.test(specifier))
+        return new URL(specifier, `${ORIGIN}${referrer}`).pathname;
+    if (/^[a-z][a-z0-9+.-]*:/i.test(specifier))
+        return undefined;
+    const exact = map.imports[specifier];
+    if (exact)
+        return exact;
+    const prefix = Object.keys(map.imports)
+        .filter((key) => key.endsWith('/') && specifier.startsWith(key))
+        .sort((a, b) => b.length - a.length)[0];
+    return prefix ? `${map.imports[prefix]}${specifier.slice(prefix.length)}` : undefined;
+}
+/**
+ * Every module `entry` (a bare specifier) imports statically, transitively, entry first.
+ * `packages` maps each served package root URL (`…/m/name@version/`) to its directory;
+ * modules that are not on disk are left out (loading them reports the error).
+ */
+export function preloadGraph(map, entry, packages) {
+    const roots = [...packages.keys()].sort((a, b) => b.length - a.length);
+    const read = (url) => {
+        const root = roots.find((prefix) => url.startsWith(prefix));
+        if (!root)
+            return undefined;
+        try {
+            return readFileSync(join(packages.get(root), url.slice(root.length)), 'utf8');
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const first = map.imports[entry];
+    const seen = new Set();
+    const queue = first ? [first] : [];
+    for (let url = queue.shift(); url; url = queue.shift()) {
+        if (seen.has(url))
+            continue;
+        const text = read(url);
+        if (text === undefined)
+            continue;
+        seen.add(url);
+        for (const match of text.matchAll(STATIC_IMPORT)) {
+            const target = resolveModule(map, match[2], url);
+            if (target && !seen.has(target))
+                queue.push(target);
+        }
+    }
+    return [...seen];
+}
+//# sourceMappingURL=preload.js.map

package/dist/node/preload.js.map

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

package/dist/node/server.d.ts

@@ -0,0 +1,42 @@
+import type { WorkbenchDiagnostic } from '../internal/diagnostics.js';
+import { type WorkbenchBuild } from './workbench.js';
+export declare const DEFAULT_PORT = 4175;
+export interface DevServerOptions {
+    /** A configuration file or the directory holding it. Default: the working directory. */
+    readonly config?: string;
+    /** Default 4175; 0 picks a free port. */
+    readonly port?: number;
+    /** Default `localhost`, bound to both loopback addresses and not reachable from other machines. */
+    readonly host?: string;
+    /** Watch the inputs and push updates. Default true. */
+    readonly watch?: boolean;
+    readonly log?: (line: string) => void;
+}
+/** What one rebuild changed, as sent to the shell (`event: update`). */
+export interface UpdateEvent {
+    /** False when the new configuration or data is invalid; the last valid data stays served. */
+    readonly ok: boolean;
+    readonly index: boolean;
+    /** Ids of pages whose data changed, appeared, or disappeared. */
+    readonly pages: readonly string[];
+    /** `name@version` of packages whose files (other than data inputs) changed. */
+    readonly modules: readonly string[];
+    /** The shell page changed (its import map or stylesheets): reload it. */
+    readonly shell: boolean;
+    readonly diagnostics: readonly WorkbenchDiagnostic[];
+}
+export interface DevServer {
+    /** `http://host:port<base>`. */
+    readonly url: string;
+    /** The build being served (the last valid one). */
+    readonly build: WorkbenchBuild;
+    /** Rebuild now, as a watched change does. */
+    rebuild(changed?: readonly string[]): Promise<UpdateEvent>;
+    close(): Promise<void>;
+}
+export declare class DevServerError extends Error {
+    readonly diagnostics: readonly WorkbenchDiagnostic[];
+    constructor(message: string, diagnostics: readonly WorkbenchDiagnostic[]);
+}
+export declare function startDevServer(options?: DevServerOptions): Promise<DevServer>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/node/server.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAItE,OAAO,EAA+C,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAElG,eAAO,MAAM,YAAY,OAAO,CAAC;AAEjC,MAAM,WAAW,gBAAgB;IAC/B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,mGAAmG;IACnG,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wEAAwE;AACxE,MAAM,WAAW,WAAW;IAC1B,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,yEAAyE;IACzE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACtD;AAED,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,6CAA6C;IAC7C,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC3D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE;IAFtD,YACE,OAAO,EAAE,MAAM,EACN,WAAW,EAAE,SAAS,mBAAmB,EAAE,EAIrD;CACF;AAgCD,wBAAsB,cAAc,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAmUvF"}