@design.estate/wcctools 5.1.0 → 6.0.0

package/dist_shell/index.html

@@ -0,0 +1,21 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>wcctools</title>
+    <link rel="icon" href="data:," />
+    <link rel="preconnect" href="https://assetbroker.lossless.one/" crossorigin>
+    <link rel="stylesheet" href="https://assetbroker.lossless.one/fonts/fonts.css">
+    <style>
+      body {
+        margin: 0px;
+        background: #0a0a0a;
+      }
+    </style>
+    <script type="module" src="/wcctools/bundle.js"></script>
+  </head>
+  <body>
+    <wcc-shell preview-path="/wcctools-preview"></wcc-shell>
+  </body>
+</html>

package/dist_ts/00_commitinfo_data.d.ts

@@ -0,0 +1,8 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export declare const commitinfo: {
+    name: string;
+    version: string;
+    description: string;
+};

package/dist_ts/00_commitinfo_data.js

@@ -0,0 +1,9 @@
+/**
+ * autocreated commitinfo by @push.rocks/commitinfo
+ */
+export const commitinfo = {
+    name: '@design.estate/wcctools',
+    version: '6.0.0',
+    description: 'A set of web component tools for creating element catalogues, enabling the structured development and documentation of custom elements and pages.'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSx5QkFBeUI7SUFDL0IsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLG1KQUFtSjtDQUNqSyxDQUFBIn0=

package/dist_ts/classes.devapi.d.ts

@@ -0,0 +1,11 @@
+import * as plugins from './plugins.js';
+/**
+ * The typed API the shell reaches on `/wcctools/typedrequest`. Later features register their
+ * handlers on `typedrouter`.
+ */
+export declare class WccDevApi {
+    readonly typedrouter: plugins.typedrequest.TypedRouter<import("@api.global/typedrequest-interfaces").ITypedRequest>;
+    private serverInfo;
+    constructor();
+    setServerInfo(infoArg: plugins.interfaces.IWccDevServerInfo): void;
+}

package/dist_ts/classes.devapi.js

@@ -0,0 +1,21 @@
+import * as plugins from './plugins.js';
+/**
+ * The typed API the shell reaches on `/wcctools/typedrequest`. Later features register their
+ * handlers on `typedrouter`.
+ */
+export class WccDevApi {
+    typedrouter = new plugins.typedrequest.TypedRouter();
+    serverInfo = null;
+    constructor() {
+        this.typedrouter.addTypedHandler(new plugins.typedrequest.TypedHandler('getDevServerInfo', async () => {
+            if (!this.serverInfo) {
+                throw new Error('The dev server has not started.');
+            }
+            return { ...this.serverInfo };
+        }));
+    }
+    setServerInfo(infoArg) {
+        this.serverInfo = { ...infoArg };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kZXZhcGkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLmRldmFwaS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4Qzs7O0dBR0c7QUFDSCxNQUFNLE9BQU8sU0FBUztJQUNKLFdBQVcsR0FBRyxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsV0FBVyxFQUFFLENBQUM7SUFDN0QsVUFBVSxHQUFnRCxJQUFJLENBQUM7SUFFdkU7UUFDRSxJQUFJLENBQUMsV0FBVyxDQUFDLGVBQWUsQ0FDOUIsSUFBSSxPQUFPLENBQUMsWUFBWSxDQUFDLFlBQVksQ0FBMkMsa0JBQWtCLEVBQUUsS0FBSyxJQUFJLEVBQUU7WUFDN0csSUFBSSxDQUFDLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztnQkFDckIsTUFBTSxJQUFJLEtBQUssQ0FBQyxpQ0FBaUMsQ0FBQyxDQUFDO1lBQ3JELENBQUM7WUFDRCxPQUFPLEVBQUUsR0FBRyxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7UUFDaEMsQ0FBQyxDQUFDLENBQ0gsQ0FBQztJQUNKLENBQUM7SUFFTSxhQUFhLENBQUMsT0FBNkM7UUFDaEUsSUFBSSxDQUFDLFVBQVUsR0FBRyxFQUFFLEdBQUcsT0FBTyxFQUFFLENBQUM7SUFDbkMsQ0FBQztDQUNGIn0=

package/dist_ts/classes.devserver.d.ts

@@ -0,0 +1,49 @@
+import { WccDevApi } from './classes.devapi.js';
+export interface IWccDevServerOptions {
+    /** Port to listen on; overrides the tswatch configuration. 0 picks a free port. */
+    port?: number;
+}
+export interface IWccDevServerAddress {
+    port: number;
+    /** The shell's address. */
+    url: string;
+}
+/**
+ * `wcctools dev`: bundles the catalog of the current project with tswatch, as its
+ * `@git.zone/tswatch` configuration (or the `element` preset) describes, and serves on one port:
+ *
+ * - the shell on `/wcctools/` (`/` redirects there) and its routes `/wcctools-route/...`,
+ * - the typed API on `/wcctools/typedrequest`,
+ * - the catalog's preview document and bundle from the tswatch serve directory on every other
+ *   path, with live reload that reloads only the preview document.
+ *
+ * tswatch resolves its paths against the process's working directory, so the server serves the
+ * project the process runs in.
+ */
+export declare class WccDevServer {
+    private readonly options;
+    /** The typed API on `/wcctools/typedrequest`; register further handlers before `start()`. */
+    readonly api: WccDevApi;
+    private tsWatch;
+    private typedServer;
+    private readonly smartExit;
+    constructor(options?: IWccDevServerOptions);
+    start(): Promise<IWccDevServerAddress>;
+    /** Stops the server, then tswatch's bundling and watching. */
+    stop(): Promise<void>;
+    /**
+     * The shell: the prebuilt shell bundle and the typed API.
+     *
+     * Seam for side-effecting APIs (assistant, capture, standards fixes): before any handler with
+     * side effects is registered here, add a `websocketAdmission`/`requestAdmission` that accepts
+     * only the shell's own origin, and keep surface mode's strict authority validation.
+     */
+    private createShellSurface;
+    /**
+     * The preview: the catalog's own document and bundle from the tswatch serve directory, on
+     * the root paths it was written for. Its live reload client is injected into its document
+     * only, so a rebuilt bundle reloads the preview frame and never the shell.
+     */
+    private createPreviewSurface;
+    private readProjectName;
+}

package/dist_ts/classes.devserver.js

@@ -0,0 +1,142 @@
+import * as plugins from './plugins.js';
+import * as paths from './paths.js';
+import { commitinfo } from './00_commitinfo_data.js';
+import { WccDevApi } from './classes.devapi.js';
+import { loadShellContent, shellPathPrefix } from './shellcontent.js';
+/** tswatch's default port and serve directory, used when the configuration names none. */
+const defaultPort = 3002;
+const defaultServeDir = './dist_watch/';
+/** The development headers tswatch serves catalogs with: a cross-origin isolated document. */
+const securityHeaders = {
+    crossOriginOpenerPolicy: 'same-origin',
+    crossOriginEmbedderPolicy: 'require-corp',
+};
+const acceptAnyHostname = () => true;
+/**
+ * `wcctools dev`: bundles the catalog of the current project with tswatch, as its
+ * `@git.zone/tswatch` configuration (or the `element` preset) describes, and serves on one port:
+ *
+ * - the shell on `/wcctools/` (`/` redirects there) and its routes `/wcctools-route/...`,
+ * - the typed API on `/wcctools/typedrequest`,
+ * - the catalog's preview document and bundle from the tswatch serve directory on every other
+ *   path, with live reload that reloads only the preview document.
+ *
+ * tswatch resolves its paths against the process's working directory, so the server serves the
+ * project the process runs in.
+ */
+export class WccDevServer {
+    options;
+    /** The typed API on `/wcctools/typedrequest`; register further handlers before `start()`. */
+    api = new WccDevApi();
+    tsWatch = null;
+    typedServer = null;
+    smartExit = new plugins.smartexit.SmartExit({ silent: true });
+    constructor(options = {}) {
+        this.options = options;
+        this.smartExit.addCleanupFunction(() => this.stop());
+    }
+    async start() {
+        if (this.typedServer) {
+            throw new Error('wcctools: the dev server is already started.');
+        }
+        const cwd = process.cwd();
+        const configHandler = new plugins.tswatch.ConfigHandler(cwd);
+        const config = configHandler.loadConfig() ?? configHandler.getPreset('element');
+        const serveDir = plugins.path.resolve(cwd, config.server?.serveDir ?? defaultServeDir);
+        const port = this.options.port ?? config.server?.port ?? defaultPort;
+        // The preview surface watches the serve directory, which must exist before the first bundle
+        await plugins.fs.mkdir(serveDir, { recursive: true });
+        this.api.setServerInfo({
+            wcctoolsVersion: commitinfo.version,
+            projectName: await this.readProjectName(cwd),
+        });
+        const typedServer = new plugins.typedserver.TypedServer({
+            cors: false,
+            port,
+            surfaces: [
+                await this.createShellSurface(),
+                this.createPreviewSurface(serveDir),
+            ],
+        });
+        this.typedServer = typedServer;
+        // Bundling and watching stay tswatch's; its own server stays off
+        this.tsWatch = new plugins.tswatch.TsWatch({ ...config, server: { enabled: false } });
+        try {
+            await this.tsWatch.start();
+            await typedServer.start();
+        }
+        catch (error) {
+            await this.stop();
+            throw error;
+        }
+        const boundPort = typedServer.listeningPort ?? port;
+        return { port: boundPort, url: `http://localhost:${boundPort}${shellPathPrefix}/` };
+    }
+    /** Stops the server, then tswatch's bundling and watching. */
+    async stop() {
+        const typedServer = this.typedServer;
+        const tsWatch = this.tsWatch;
+        this.typedServer = null;
+        this.tsWatch = null;
+        this.smartExit.deregister();
+        await typedServer?.stop();
+        await tsWatch?.stop();
+    }
+    /**
+     * The shell: the prebuilt shell bundle and the typed API.
+     *
+     * Seam for side-effecting APIs (assistant, capture, standards fixes): before any handler with
+     * side effects is registered here, add a `websocketAdmission`/`requestAdmission` that accepts
+     * only the shell's own origin, and keep surface mode's strict authority validation.
+     */
+    async createShellSurface() {
+        return {
+            name: 'shell',
+            match: {
+                hostnameResolver: acceptAnyHostname,
+                pathPrefixes: [shellPathPrefix, '/wcctools-route'],
+            },
+            bundledContent: await loadShellContent(paths.distShellDir),
+            spaFallback: true,
+            httpTypedRouter: this.api.typedrouter,
+            typedRequestPath: `${shellPathPrefix}/typedrequest`,
+            noCache: true,
+            securityHeaders,
+        };
+    }
+    /**
+     * The preview: the catalog's own document and bundle from the tswatch serve directory, on
+     * the root paths it was written for. Its live reload client is injected into its document
+     * only, so a rebuilt bundle reloads the preview frame and never the shell.
+     */
+    createPreviewSurface(serveDirArg) {
+        return {
+            name: 'preview',
+            match: {
+                hostnameResolver: acceptAnyHostname,
+                pathPrefixes: ['/'],
+            },
+            serveDir: serveDirArg,
+            spaFallback: true,
+            injectReload: true,
+            watch: true,
+            // Lets the reload client get pushed changes instead of polling
+            websocketTypedRouter: new plugins.typedrequest.TypedRouter(),
+            // As tswatch serves catalogs
+            cors: true,
+            httpHandler: async (contextArg) => {
+                if (contextArg.path === '/' && (contextArg.method === 'GET' || contextArg.method === 'HEAD')) {
+                    return new Response(null, { status: 302, headers: { Location: `${shellPathPrefix}/` } });
+                }
+                return null;
+            },
+            noCache: true,
+            securityHeaders,
+        };
+    }
+    async readProjectName(cwdArg) {
+        const packageJson = JSON.parse(await plugins.fs.readFile(plugins.path.join(cwdArg, 'package.json'), 'utf8'));
+        return packageJson.name ?? plugins.path.basename(cwdArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kZXZzZXJ2ZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9jbGFzc2VzLmRldnNlcnZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEtBQUssS0FBSyxNQUFNLFlBQVksQ0FBQztBQUNwQyxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDckQsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ2hELE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxlQUFlLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQWF0RSwwRkFBMEY7QUFDMUYsTUFBTSxXQUFXLEdBQUcsSUFBSSxDQUFDO0FBQ3pCLE1BQU0sZUFBZSxHQUFHLGVBQWUsQ0FBQztBQUV4Qyw4RkFBOEY7QUFDOUYsTUFBTSxlQUFlLEdBQXlDO0lBQzVELHVCQUF1QixFQUFFLGFBQWE7SUFDdEMseUJBQXlCLEVBQUUsY0FBYztDQUMxQyxDQUFDO0FBRUYsTUFBTSxpQkFBaUIsR0FBRyxHQUFHLEVBQUUsQ0FBQyxJQUFJLENBQUM7QUFFckM7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLE9BQU8sWUFBWTtJQU9NO0lBTjdCLDZGQUE2RjtJQUM3RSxHQUFHLEdBQUcsSUFBSSxTQUFTLEVBQUUsQ0FBQztJQUM5QixPQUFPLEdBQW1DLElBQUksQ0FBQztJQUMvQyxXQUFXLEdBQTJDLElBQUksQ0FBQztJQUNsRCxTQUFTLEdBQUcsSUFBSSxPQUFPLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxFQUFFLE1BQU0sRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBRS9FLFlBQTZCLFVBQWdDLEVBQUU7UUFBbEMsWUFBTyxHQUFQLE9BQU8sQ0FBMkI7UUFDN0QsSUFBSSxDQUFDLFNBQVMsQ0FBQyxrQkFBa0IsQ0FBQyxHQUFHLEVBQUUsQ0FBQyxJQUFJLENBQUMs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

package/dist_ts/cli.d.ts

@@ -0,0 +1,6 @@
+import * as plugins from './plugins.js';
+/**
+ * Registers the wcctools commands on the given console.
+ */
+export declare const registerCommands: (out: plugins.smartconsole.SmartConsole) => void;
+export declare const runCli: () => Promise<void>;

package/dist_ts/cli.js

@@ -0,0 +1,45 @@
+import * as plugins from './plugins.js';
+import { commitinfo } from './00_commitinfo_data.js';
+import { WccDevServer } from './classes.devserver.js';
+/**
+ * Registers the wcctools commands on the given console.
+ */
+export const registerCommands = (out) => {
+    out.cli.configure({
+        name: 'wcctools',
+        version: commitinfo.version,
+        description: 'Develop a web component catalog in the wcctools shell',
+    });
+    out.cli.command({
+        name: 'dev',
+        description: 'Bundle the catalog with live reload and serve it in the wcctools shell',
+        options: {
+            port: {
+                type: 'number',
+                description: 'Port to listen on (0 picks a free port); overrides the tswatch configuration',
+            },
+        },
+    }, async ({ options }) => {
+        const devServer = new WccDevServer({ port: options.port });
+        const address = await devServer.start();
+        await out.log(`wcctools dev: ${address.url}`);
+    });
+    out.cli.default({}, async () => {
+        await out.log(out.cli.renderHelp());
+    });
+};
+export const runCli = async () => {
+    const out = new plugins.smartconsole.SmartConsole();
+    try {
+        registerCommands(out);
+        await out.cli.run();
+    }
+    catch (error) {
+        await out.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    }
+    finally {
+        await out.dispose();
+    }
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvY2xpLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUNyRCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFdEQ7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLEdBQXNDLEVBQVEsRUFBRTtJQUMvRSxHQUFHLENBQUMsR0FBRyxDQUFDLFNBQVMsQ0FBQztRQUNoQixJQUFJLEVBQUUsVUFBVTtRQUNoQixPQUFPLEVBQUUsVUFBVSxDQUFDLE9BQU87UUFDM0IsV0FBVyxFQUFFLHVEQUF1RDtLQUNyRSxDQUFDLENBQUM7SUFFSCxHQUFHLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQztRQUNkLElBQUksRUFBRSxLQUFLO1FBQ1gsV0FBVyxFQUFFLHdFQUF3RTtRQUNyRixPQUFPLEVBQUU7WUFDUCxJQUFJLEVBQUU7Z0JBQ0osSUFBSSxFQUFFLFFBQVE7Z0JBQ2QsV0FBVyxFQUFFLDhFQUE4RTthQUM1RjtTQUNGO0tBQ0YsRUFBRSxLQUFLLEVBQUUsRUFBRSxPQUFPLEVBQUUsRUFBRSxFQUFFO1FBQ3ZCLE1BQU0sU0FBUyxHQUFHLElBQUksWUFBWSxDQUFDLEVBQUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDO1FBQzNELE1BQU0sT0FBTyxHQUFHLE1BQU0sU0FBUyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ3hDLE1BQU0sR0FBRyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsT0FBTyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUM7SUFDaEQsQ0FBQyxDQUFDLENBQUM7SUFFSCxHQUFHLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxFQUFFLEVBQUUsS0FBSyxJQUFJLEVBQUU7UUFDN0IsTUFBTSxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsVUFBVSxFQUFFLENBQUMsQ0FBQztJQUN0QyxDQUFDLENBQUMsQ0FBQztBQUNMLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxLQUFLLElBQUksRUFBRTtJQUMvQixNQUFNLEdBQUcsR0FBRyxJQUFJLE9BQU8sQ0FBQyxZQUFZLENBQUMsWUFBWSxFQUFFLENBQUM7SUFDcEQsSUFBSSxDQUFDO1FBQ0gsZ0JBQWdCLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDdEIsTUFBTSxHQUFHLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDO0lBQ3RCLENBQUM7SUFBQyxPQUFPLEtBQUssRUFBRSxDQUFDO1FBQ2YsTUFBTSxHQUFHLENBQUMsS0FBSyxDQUFDLEtBQUssWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1FBQ3hFLE9BQU8sQ0FBQyxRQUFRLEdBQUcsQ0FBQyxDQUFDO0lBQ3ZCLENBQUM7WUFBUyxDQUFDO1FBQ1QsTUFBTSxHQUFHLENBQUMsT0FBTyxFQUFFLENBQUM7SUFDdEIsQ0FBQztBQUNILENBQUMsQ0FBQyJ9

package/dist_ts/index.d.ts

@@ -0,0 +1,3 @@
+export { runCli } from './cli.js';
+export { WccDevServer, type IWccDevServerOptions, type IWccDevServerAddress } from './classes.devserver.js';
+export { WccDevApi } from './classes.devapi.js';

package/dist_ts/index.js

@@ -0,0 +1,4 @@
+export { runCli } from './cli.js';
+export { WccDevServer } from './classes.devserver.js';
+export { WccDevApi } from './classes.devapi.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sVUFBVSxDQUFDO0FBQ2xDLE9BQU8sRUFBRSxZQUFZLEVBQXdELE1BQU0sd0JBQXdCLENBQUM7QUFDNUcsT0FBTyxFQUFFLFNBQVMsRUFBRSxNQUFNLHFCQUFxQixDQUFDIn0=

package/dist_ts/paths.d.ts

@@ -0,0 +1,4 @@
+/** The root of the installed wcctools package. */
+export declare const packageDir: string;
+/** The prebuilt shell bundle the package ships. */
+export declare const distShellDir: string;

package/dist_ts/paths.js

@@ -0,0 +1,6 @@
+import * as plugins from './plugins.js';
+/** The root of the installed wcctools package. */
+export const packageDir = plugins.path.resolve(plugins.path.dirname(plugins.url.fileURLToPath(import.meta.url)), '..');
+/** The prebuilt shell bundle the package ships. */
+export const distShellDir = plugins.path.join(packageDir, 'dist_shell');
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9wYXRocy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUV4QyxrREFBa0Q7QUFDbEQsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUMsRUFBRSxJQUFJLENBQUMsQ0FBQztBQUV2SCxtREFBbUQ7QUFDbkQsTUFBTSxDQUFDLE1BQU0sWUFBWSxHQUFHLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFVBQVUsRUFBRSxZQUFZLENBQUMsQ0FBQyJ9

package/dist_ts/plugins.d.ts

@@ -0,0 +1,15 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as url from 'node:url';
+export { fs, path, url };
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedserver from '@api.global/typedserver';
+export { typedrequest, typedserver };
+import * as tswatch from '@git.zone/tswatch';
+export { tswatch };
+import * as smartconsole from '@push.rocks/smartconsole';
+import * as smartexit from '@push.rocks/smartexit';
+export { smartconsole, smartexit };
+import * as interfaces from '../dist_ts_interfaces/index.js';
+import * as shared from '../dist_ts_shared/index.js';
+export { interfaces, shared };

package/dist_ts/plugins.js

@@ -0,0 +1,21 @@
+// node native scope
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import * as url from 'node:url';
+export { fs, path, url };
+// @api.global scope
+import * as typedrequest from '@api.global/typedrequest';
+import * as typedserver from '@api.global/typedserver';
+export { typedrequest, typedserver };
+// @git.zone scope
+import * as tswatch from '@git.zone/tswatch';
+export { tswatch };
+// @push.rocks scope
+import * as smartconsole from '@push.rocks/smartconsole';
+import * as smartexit from '@push.rocks/smartexit';
+export { smartconsole, smartexit };
+// project scope
+import * as interfaces from '../dist_ts_interfaces/index.js';
+import * as shared from '../dist_ts_shared/index.js';
+export { interfaces, shared };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL3BsdWdpbnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDdkMsT0FBTyxLQUFLLElBQUksTUFBTSxXQUFXLENBQUM7QUFDbEMsT0FBTyxLQUFLLEdBQUcsTUFBTSxVQUFVLENBQUM7QUFFaEMsT0FBTyxFQUFFLEVBQUUsRUFBRSxJQUFJLEVBQUUsR0FBRyxFQUFFLENBQUM7QUFFekIsb0JBQW9CO0FBQ3BCLE9BQU8sS0FBSyxZQUFZLE1BQU0sMEJBQTBCLENBQUM7QUFDekQsT0FBTyxLQUFLLFdBQVcsTUFBTSx5QkFBeUIsQ0FBQztBQUV2RCxPQUFPLEVBQUUsWUFBWSxFQUFFLFdBQVcsRUFBRSxDQUFDO0FBRXJDLGtCQUFrQjtBQUNsQixPQUFPLEtBQUssT0FBTyxNQUFNLG1CQUFtQixDQUFDO0FBRTdDLE9BQU8sRUFBRSxPQUFPLEVBQUUsQ0FBQztBQUVuQixvQkFBb0I7QUFDcEIsT0FBTyxLQUFLLFlBQVksTUFBTSwwQkFBMEIsQ0FBQztBQUN6RCxPQUFPLEtBQUssU0FBUyxNQUFNLHVCQUF1QixDQUFDO0FBRW5ELE9BQU8sRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLENBQUM7QUFFbkMsZ0JBQWdCO0FBQ2hCLE9BQU8sS0FBSyxVQUFVLE1BQU0sMkJBQTJCLENBQUM7QUFDeEQsT0FBTyxLQUFLLE1BQU0sTUFBTSx1QkFBdUIsQ0FBQztBQUVoRCxPQUFPLEVBQUUsVUFBVSxFQUFFLE1BQU0sRUFBRSxDQUFDIn0=

package/dist_ts/shellcontent.d.ts

@@ -0,0 +1,9 @@
+import * as plugins from './plugins.js';
+/** The path below which the shell surface serves the shell bundle. */
+export declare const shellPathPrefix = "/wcctools";
+/**
+ * The prebuilt shell bundle as in-memory content of the shell surface. A surface serves files
+ * by their full request path, so every file is keyed below `wcctools/`; the shell page is
+ * also keyed as `index.html`, which the surface's SPA fallback answers `/wcctools-route/...` with.
+ */
+export declare const loadShellContent: (distShellDirArg: string) => Promise<plugins.typedserver.IBundledContentItem[]>;

package/dist_ts/shellcontent.js

@@ -0,0 +1,42 @@
+import * as plugins from './plugins.js';
+/** The path below which the shell surface serves the shell bundle. */
+export const shellPathPrefix = '/wcctools';
+const collectFiles = async (dirArg, relativeDirArg = '') => {
+    const entries = await plugins.fs.readdir(plugins.path.join(dirArg, relativeDirArg), { withFileTypes: true });
+    const files = [];
+    for (const entry of entries) {
+        const relativePath = relativeDirArg ? `${relativeDirArg}/${entry.name}` : entry.name;
+        if (entry.isDirectory()) {
+            files.push(...await collectFiles(dirArg, relativePath));
+        }
+        else if (entry.isFile()) {
+            files.push(relativePath);
+        }
+    }
+    return files;
+};
+/**
+ * The prebuilt shell bundle as in-memory content of the shell surface. A surface serves files
+ * by their full request path, so every file is keyed below `wcctools/`; the shell page is
+ * also keyed as `index.html`, which the surface's SPA fallback answers `/wcctools-route/...` with.
+ */
+export const loadShellContent = async (distShellDirArg) => {
+    const indexPath = plugins.path.join(distShellDirArg, 'index.html');
+    try {
+        await plugins.fs.access(indexPath);
+    }
+    catch {
+        throw new Error(`wcctools: the shell bundle is missing (${indexPath}); build the package with "pnpm build".`);
+    }
+    const prefix = shellPathPrefix.slice(1);
+    const content = [];
+    for (const relativePath of await collectFiles(distShellDirArg)) {
+        const contentBase64 = (await plugins.fs.readFile(plugins.path.join(distShellDirArg, relativePath))).toString('base64');
+        content.push({ path: `${prefix}/${relativePath}`, contentBase64 });
+        if (relativePath === 'index.html') {
+            content.push({ path: 'index.html', contentBase64 });
+        }
+    }
+    return content;
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hlbGxjb250ZW50LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvc2hlbGxjb250ZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBRXhDLHNFQUFzRTtBQUN0RSxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsV0FBVyxDQUFDO0FBRTNDLE1BQU0sWUFBWSxHQUFHLEtBQUssRUFBRSxNQUFjLEVBQUUsY0FBYyxHQUFHLEVBQUUsRUFBcUIsRUFBRTtJQUNwRixNQUFNLE9BQU8sR0FBRyxNQUFNLE9BQU8sQ0FBQyxFQUFFLENBQUMsT0FBTyxDQUFDLE9BQU8sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU0sRUFBRSxjQUFjLENBQUMsRUFBRSxFQUFFLGFBQWEsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQzdHLE1BQU0sS0FBSyxHQUFhLEVBQUUsQ0FBQztJQUMzQixLQUFLLE1BQU0sS0FBSyxJQUFJLE9BQU8sRUFBRSxDQUFDO1FBQzVCLE1BQU0sWUFBWSxHQUFHLGNBQWMsQ0FBQyxDQUFDLENBQUMsR0FBRyxjQUFjLElBQUksS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDO1FBQ3JGLElBQUksS0FBSyxDQUFDLFdBQVcsRUFBRSxFQUFFLENBQUM7WUFDeEIsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLE1BQU0sWUFBWSxDQUFDLE1BQU0sRUFBRSxZQUFZLENBQUMsQ0FBQyxDQUFDO1FBQzFELENBQUM7YUFBTSxJQUFJLEtBQUssQ0FBQyxNQUFNLEVBQUUsRUFBRSxDQUFDO1lBQzFCLEtBQUssQ0FBQyxJQUFJLENBQUMsWUFBWSxDQUFDLENBQUM7UUFDM0IsQ0FBQztJQUNILENBQUM7SUFDRCxPQUFPLEtBQUssQ0FBQztBQUNmLENBQUMsQ0FBQztBQUVGOzs7O0dBSUc7QUFDSCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxLQUFLLEVBQUUsZUFBdUIsRUFBc0QsRUFBRTtJQUNwSCxNQUFNLFNBQVMsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsWUFBWSxDQUFDLENBQUM7SUFDbkUsSUFBSSxDQUFDO1FBQ0gsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLE1BQU0sQ0FBQyxTQUFTLENBQUMsQ0FBQztJQUNyQyxDQUFDO0lBQUMsTUFBTSxDQUFDO1FBQ1AsTUFBTSxJQUFJLEtBQUssQ0FBQywwQ0FBMEMsU0FBUyx5Q0FBeUMsQ0FBQyxDQUFDO0lBQ2hILENBQUM7SUFDRCxNQUFNLE1BQU0sR0FBRyxlQUFlLENBQUMsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDO0lBQ3hDLE1BQU0sT0FBTyxHQUE4QyxFQUFFLENBQUM7SUFDOUQsS0FBSyxNQUFNLFlBQVksSUFBSSxNQUFNLFlBQVksQ0FBQyxlQUFlLENBQUMsRUFBRSxDQUFDO1FBQy9ELE1BQU0sYUFBYSxHQUFHLENBQUMsTUFBTSxPQUFPLENBQUMsRUFBRSxDQUFDLFFBQVEsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxlQUFlLEVBQUUsWUFBWSxDQUFDLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxRQUFRLENBQUMsQ0FBQztRQUN2SCxPQUFPLENBQUMsSUFBSSxDQUFDLEVBQUUsSUFBSSxFQUFFLEdBQUcsTUFBTSxJQUFJLFlBQVksRUFBRSxFQUFFLGFBQWEsRUFBRSxDQUFDLENBQUM7UUFDbkUsSUFBSSxZQUFZLEtBQUssWUFBWSxFQUFFLENBQUM7WUFDbEMsT0FBTyxDQUFDLElBQUksQ0FBQyxFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsYUFBYSxFQUFFLENBQUMsQ0FBQztRQUN0RCxDQUFDO0lBQ0gsQ0FBQztJQUNELE9BQU8sT0FBTyxDQUFDO0FBQ2pCLENBQUMsQ0FBQyJ9

package/dist_ts_interfaces/bridge.d.ts

@@ -0,0 +1,88 @@
+import type { IWccCatalogManifest } from './catalog.js';
+/**
+ * The bridge between the shell and the preview document. The preview runtime installs it as
+ * `window.wccPreview` in the preview document; the shell reaches it through the same-origin
+ * iframe. Every argument and result is plain, structured-cloneable data: values never carry
+ * objects of the other document's realm.
+ */
+export type TWccTheme = 'dark' | 'bright';
+/** One demo (or page) of the catalog. */
+export interface IWccSelection {
+    sectionName: string;
+    itemName: string;
+    /** 0-based; always 0 for a page. */
+    demoIndex: number;
+}
+/** What the preview shows instead of a demo. */
+export interface IWccEmptyState {
+    title: string;
+    detail: string;
+}
+export type TWccEmptyReason = 'nothing-selected' | 'no-demo' | 'ignored' | 'missing' | 'no-such-demo' | 'failed';
+export type TWccRenderOutcome = {
+    kind: 'rendered';
+    type: 'element' | 'page';
+} | {
+    kind: 'empty';
+    reason: TWccEmptyReason;
+    emptyState: IWccEmptyState;
+};
+export type TWccPropertyKind = 'String' | 'Number' | 'Boolean' | 'Enum' | 'Object' | 'Array';
+/** A scalar property value the properties panel can show and set directly. */
+export type TWccPropertyScalar = string | number | boolean | null;
+export interface IWccPropertyDescriptor {
+    name: string;
+    kind: TWccPropertyKind;
+    /** The values of an `Enum` property. */
+    enumValues?: string[];
+    /** The current value of a String, Number, Boolean or Enum property. */
+    value?: TWccPropertyScalar;
+    /** The current value of an Object or Array property, as formatted JSON. */
+    json?: string;
+}
+export type TWccPropertyListing = {
+    kind: 'properties';
+    elementName: string;
+    properties: IWccPropertyDescriptor[];
+} | {
+    kind: 'unavailable';
+    reason: string;
+};
+export type TWccPropertyEditResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: string;
+};
+export interface IWccRenderedEvent {
+    type: 'rendered';
+    selection: IWccSelection | null;
+    outcome: TWccRenderOutcome;
+}
+export type TWccPreviewEvent = IWccRenderedEvent;
+export interface IWccPreviewBridge {
+    getManifest(): IWccCatalogManifest;
+    /** The selection rendered last, or null before the first render. */
+    getSelection(): IWccSelection | null;
+    getTheme(): TWccTheme;
+    /** Render a demo or page into the preview document, without reloading it. */
+    render(selectionArg: IWccSelection): Promise<TWccRenderOutcome>;
+    setTheme(themeArg: TWccTheme): Promise<void>;
+    /** The editable properties of the selected element's rendered instance, once it has rendered. */
+    getProperties(): Promise<TWccPropertyListing>;
+    setProperty(nameArg: string, valueArg: TWccPropertyScalar): TWccPropertyEditResult;
+    /** Parse JSON in the preview document and assign it to an Object or Array property. */
+    setPropertyJson(nameArg: string, jsonArg: string): TWccPropertyEditResult;
+    /** The rendered instance of the selected element, for same-origin tooling. */
+    findRenderedInstance(): HTMLElement | null;
+    subscribe(listenerArg: (eventArg: TWccPreviewEvent) => void): () => void;
+}
+/** The message a preview document posts to its parent once its bridge is installed. */
+export interface IWccPreviewReadyMessage {
+    type: 'wcctools-preview-ready';
+}
+declare global {
+    interface Window {
+        wccPreview?: IWccPreviewBridge;
+    }
+}

package/dist_ts_interfaces/bridge.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnJpZGdlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHNfaW50ZXJmYWNlcy9icmlkZ2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IiJ9

package/dist_ts_interfaces/catalog.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The data-only description of a catalog that the preview runtime hands to the shell.
+ * Element classes and template factories stay in the preview document.
+ */
+/** How the entries of a section are rendered: element demos or page factories. */
+export type TWccSectionType = 'elements' | 'pages';
+/** A navigable catalog entry. */
+export interface IWccManifestEntry {
+    name: string;
+    /** The registered tag of an element; null for pages and unregistered element classes. */
+    tagName: string | null;
+    /** Number of demos (always 1 for a page). */
+    demoCount: number;
+    demoGroups: string[];
+}
+/** A registered element without a usable demo; listed, never navigable. */
+export interface IWccManifestEntryWithoutDemo {
+    name: string;
+    tagName: string | null;
+}
+export interface IWccManifestSection {
+    name: string;
+    type: TWccSectionType;
+    icon?: string;
+    collapsed?: boolean;
+    /** Classified, filtered and sorted as the section configures it. */
+    entries: IWccManifestEntry[];
+    entriesWithoutDemo: IWccManifestEntryWithoutDemo[];
+}
+export interface IWccCatalogManifest {
+    sections: IWccManifestSection[];
+}

package/dist_ts_interfaces/catalog.js

@@ -0,0 +1,6 @@
+/**
+ * The data-only description of a catalog that the preview runtime hands to the shell.
+ * Element classes and template factories stay in the preview document.
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2F0YWxvZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvY2F0YWxvZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0cifQ==

package/dist_ts_interfaces/index.d.ts

@@ -0,0 +1,3 @@
+export * from './catalog.js';
+export * from './bridge.js';
+export * from './requests.js';

package/dist_ts_interfaces/index.js

@@ -0,0 +1,4 @@
+export * from './catalog.js';
+export * from './bridge.js';
+export * from './requests.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDO0FBQzdCLGNBQWMsYUFBYSxDQUFDO0FBQzVCLGNBQWMsZUFBZSxDQUFDIn0=

package/dist_ts_interfaces/plugins.d.ts

@@ -0,0 +1,2 @@
+import * as typedrequestInterfaces from '@api.global/typedrequest-interfaces';
+export { typedrequestInterfaces };

package/dist_ts_interfaces/plugins.js

@@ -0,0 +1,3 @@
+import * as typedrequestInterfaces from '@api.global/typedrequest-interfaces';
+export { typedrequestInterfaces };
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2lucy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3RzX2ludGVyZmFjZXMvcGx1Z2lucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssc0JBQXNCLE1BQU0scUNBQXFDLENBQUM7QUFFOUUsT0FBTyxFQUFFLHNCQUFzQixFQUFFLENBQUMifQ==

package/dist_ts_interfaces/requests.d.ts

@@ -0,0 +1,15 @@
+import * as plugins from './plugins.js';
+/**
+ * Typed requests the shell sends to the `wcctools dev` server on `/wcctools/typedrequest`.
+ */
+export interface IWccDevServerInfo {
+    /** Version of the wcctools package that serves the shell. */
+    wcctoolsVersion: string;
+    /** Name of the served project's package. */
+    projectName: string;
+}
+export interface IReq_GetDevServerInfo extends plugins.typedrequestInterfaces.implementsTR<plugins.typedrequestInterfaces.ITypedRequest, IReq_GetDevServerInfo> {
+    method: 'getDevServerInfo';
+    request: {};
+    response: IWccDevServerInfo;
+}

package/dist_ts_interfaces/requests.js

@@ -0,0 +1,2 @@
+import * as plugins from './plugins.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVxdWVzdHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90c19pbnRlcmZhY2VzL3JlcXVlc3RzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDIn0=

package/dist_ts_shared/index.d.ts

@@ -0,0 +1 @@
+export * from './previewroute.js';

package/dist_ts_shared/index.js

@@ -0,0 +1,2 @@
+export * from './previewroute.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90c19zaGFyZWQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsY0FBYyxtQkFBbUIsQ0FBQyJ9