@pwfabric/cli 0.0.0-stage → 1.0.0-rc.1

package/dist/dev/overlay.js

@@ -0,0 +1,59 @@
+import { escapeHtml } from './shell.js';
+/** Server-Sent Events endpoint the page listens on. */
+export const EVENTS_PATH = '/_pwf/events';
+/** The current build's status as JSON. */
+export const STATUS_PATH = '/_pwf/status';
+/** Where the dev server serves the reload client's script. */
+export const RELOAD_PATH = '/_pwf/reload.js';
+/** The reload client's script: reloads the page when the server announces a new build. */
+export const RELOAD_JS = `(function () {
+  if (typeof EventSource === 'undefined') return
+  var es = new EventSource('${EVENTS_PATH}')
+  es.addEventListener('reload', function () { location.reload() })
+})()
+`;
+/**
+ * The reload client, as markup for a page. A script file on the dev server's
+ * own origin, not an inline script, so the app's Content Security Policy
+ * covers it with 'self' (and its event stream with connect-src 'self').
+ */
+export const RELOAD_CLIENT = `
+    <script src="${RELOAD_PATH}"></script>`;
+/** The page shown while the last build has errors. */
+export function overlayHtml(diagnostics, title = 'Build failed') {
+    const errors = diagnostics.filter((d) => d.severity === 'error');
+    const rest = diagnostics.length - errors.length;
+    const items = errors
+        .map((d) => `<li><code>${escapeHtml(d.code)}</code>${d.path ? ` <span class="path">${escapeHtml(d.path)}${d.line !== undefined ? `:${d.line}` : ''}</span>` : ''}<pre>${escapeHtml(d.message)}</pre></li>`)
+        .join('\n');
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${escapeHtml(title)} — pwf dev</title>
+    <style>
+      body { margin: 0; font: 14px/1.5 ui-sans-serif, system-ui, sans-serif; background: #1c1917; color: #fafaf9; }
+      main { max-width: 960px; margin: 0 auto; padding: 32px 16px; }
+      h1 { font-size: 20px; color: #fca5a5; margin: 0 0 4px; }
+      p { color: #d6d3d1; margin: 0 0 24px; }
+      ul { list-style: none; padding: 0; margin: 0; }
+      li { border-left: 3px solid #f87171; background: #292524; padding: 12px 16px; margin: 0 0 12px; border-radius: 4px; }
+      code { color: #fca5a5; font-weight: 600; }
+      .path { color: #a8a29e; margin-left: 8px; }
+      pre { white-space: pre-wrap; word-break: break-word; margin: 8px 0 0; font: 13px/1.5 ui-monospace, Menlo, Consolas, monospace; }
+    </style>
+  </head>
+  <body>
+    <main>
+      <h1>${escapeHtml(title)}</h1>
+      <p>${errors.length} error${errors.length === 1 ? '' : 's'}${rest > 0 ? `, ${rest} other finding${rest === 1 ? '' : 's'} in the terminal` : ''}. Fix the files and the page reloads.</p>
+      <ul>
+${items}
+      </ul>
+    </main>${RELOAD_CLIENT}
+  </body>
+</html>
+`;
+}
+//# sourceMappingURL=overlay.js.map

package/dist/dev/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../src/dev/overlay.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvC,uDAAuD;AACvD,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAA;AACzC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,cAAc,CAAA;AAEzC,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE5C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,SAAS,GAAG;;8BAEK,WAAW;;;CAGxC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;mBACV,WAAW,aAAa,CAAA;AAE3C,sDAAsD;AACtD,MAAM,UAAU,WAAW,CAAC,WAA0C,EAAE,KAAK,GAAG,cAAc;IAC5F,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;IAChE,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAA;IAC/C,MAAM,KAAK,GAAG,MAAM;SACjB,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CACtM;SACA,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO;;;;;aAKI,UAAU,CAAC,KAAK,CAAC;;;;;;;;;;;;;;;YAelB,UAAU,CAAC,KAAK,CAAC;WAClB,MAAM,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE;;EAEjJ,KAAK;;aAEM,aAAa;;;CAGzB,CAAA;AACD,CAAC","sourcesContent":["/**\n * What `pwf dev` adds to a page: the reload client, and the overlay shown\n * instead of the app when the last build failed.\n */\nimport type { AssembleDiagnostic } from './diagnostics.js'\nimport { escapeHtml } from './shell.js'\n\n/** Server-Sent Events endpoint the page listens on. */\nexport const EVENTS_PATH = '/_pwf/events'\n/** The current build's status as JSON. */\nexport const STATUS_PATH = '/_pwf/status'\n\n/** Where the dev server serves the reload client's script. */\nexport const RELOAD_PATH = '/_pwf/reload.js'\n\n/** The reload client's script: reloads the page when the server announces a new build. */\nexport const RELOAD_JS = `(function () {\n  if (typeof EventSource === 'undefined') return\n  var es = new EventSource('${EVENTS_PATH}')\n  es.addEventListener('reload', function () { location.reload() })\n})()\n`\n\n/**\n * The reload client, as markup for a page. A script file on the dev server's\n * own origin, not an inline script, so the app's Content Security Policy\n * covers it with 'self' (and its event stream with connect-src 'self').\n */\nexport const RELOAD_CLIENT = `\n    <script src=\"${RELOAD_PATH}\"></script>`\n\n/** The page shown while the last build has errors. */\nexport function overlayHtml(diagnostics: readonly AssembleDiagnostic[], title = 'Build failed'): string {\n  const errors = diagnostics.filter((d) => d.severity === 'error')\n  const rest = diagnostics.length - errors.length\n  const items = errors\n    .map(\n      (d) => `<li><code>${escapeHtml(d.code)}</code>${d.path ? ` <span class=\"path\">${escapeHtml(d.path)}${d.line !== undefined ? `:${d.line}` : ''}</span>` : ''}<pre>${escapeHtml(d.message)}</pre></li>`\n    )\n    .join('\\n')\n  return `<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\" />\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n    <title>${escapeHtml(title)} — pwf dev</title>\n    <style>\n      body { margin: 0; font: 14px/1.5 ui-sans-serif, system-ui, sans-serif; background: #1c1917; color: #fafaf9; }\n      main { max-width: 960px; margin: 0 auto; padding: 32px 16px; }\n      h1 { font-size: 20px; color: #fca5a5; margin: 0 0 4px; }\n      p { color: #d6d3d1; margin: 0 0 24px; }\n      ul { list-style: none; padding: 0; margin: 0; }\n      li { border-left: 3px solid #f87171; background: #292524; padding: 12px 16px; margin: 0 0 12px; border-radius: 4px; }\n      code { color: #fca5a5; font-weight: 600; }\n      .path { color: #a8a29e; margin-left: 8px; }\n      pre { white-space: pre-wrap; word-break: break-word; margin: 8px 0 0; font: 13px/1.5 ui-monospace, Menlo, Consolas, monospace; }\n    </style>\n  </head>\n  <body>\n    <main>\n      <h1>${escapeHtml(title)}</h1>\n      <p>${errors.length} error${errors.length === 1 ? '' : 's'}${rest > 0 ? `, ${rest} other finding${rest === 1 ? '' : 's'} in the terminal` : ''}. Fix the files and the page reloads.</p>\n      <ul>\n${items}\n      </ul>\n    </main>${RELOAD_CLIENT}\n  </body>\n</html>\n`\n}\n"]}

package/dist/dev/server.d.ts

@@ -0,0 +1,27 @@
+import type { CreateLocalHost } from '../host/types.js';
+import { type AssembleOptions } from './assemble.js';
+import { type AssembleDiagnostic } from './diagnostics.js';
+import type { DevServer, DevServerOptions, StartDevServer } from './types.js';
+import { type WatchOptions } from './watcher.js';
+export declare const DEFAULT_PORT = 4600;
+export declare const DEFAULT_HOSTNAME = "127.0.0.1";
+/** Where a host this server creates is mounted. */
+export declare const HOST_PREFIX = "/_host";
+/** Seams for the `dev` command and for tests; not part of the public contract. */
+export interface DevServerInternals {
+    /** Watching; `false` turns it off. */
+    readonly watch?: WatchOptions | false;
+    /** Makes a host when the app needs one and none was passed. */
+    readonly createHost?: CreateLocalHost;
+    /** Assembly options (runtime bundles, cache folder). */
+    readonly assemble?: Pick<AssembleOptions, 'runtime' | 'cacheDir' | 'publishedAt'>;
+}
+export declare function contentTypeOf(path: string): string;
+/** The address a browser should open for a bound interface. */
+export declare function urlFor(hostname: string, port: number): string;
+/** Lines for the terminal: everything that is the app's own, and a count of what pinned packs say. */
+export declare function logLines(diagnostics: readonly AssembleDiagnostic[]): string[];
+/** Starts the dev server with the internal seams. {@link startDevServer} is the public entry. */
+export declare function createDevServer(options: DevServerOptions, internals?: DevServerInternals): Promise<DevServer>;
+/** Implements the `pwf dev` contract (see ./types.ts). */
+export declare const startDevServer: StartDevServer;

package/dist/dev/server.js

@@ -0,0 +1,268 @@
+/**
+ * `pwf dev`: serves an app folder as a pwapp and keeps it current.
+ *
+ * One `node:http` server on 127.0.0.1 (port 4600 by default). It assembles
+ * the app into memory (see ./assemble.ts), serves the files from there,
+ * watches the folder, reassembles on change and tells the open page to reload
+ * through Server-Sent Events. While the last build has errors the page is an
+ * overlay listing them; the terminal gets the same list.
+ *
+ * When the app declares sign-in or records it needs a local host. A host
+ * passed in `localHost` is mounted on the same server: requests it claims go
+ * to `host.handle()`, and the envelope carries `host.envelopeEntries()`.
+ * This module never constructs a host itself (it depends on the host's
+ * interface only); a caller that can make one passes `createHost`.
+ */
+import { createServer } from 'node:http';
+import { extname, join, resolve } from 'node:path';
+import { assemblePwapp } from './assemble.js';
+import { createCompileCache } from './compile.js';
+import { formatDiagnostic } from './diagnostics.js';
+import { hostNeeds } from './needs-host.js';
+import { EVENTS_PATH, overlayHtml, RELOAD_CLIENT, RELOAD_JS, RELOAD_PATH, STATUS_PATH } from './overlay.js';
+import { withBaseHref } from './shell.js';
+import { PWF_DIR } from './sources.js';
+import { watchFolder } from './watcher.js';
+export const DEFAULT_PORT = 4600;
+export const DEFAULT_HOSTNAME = '127.0.0.1';
+/** Where a host this server creates is mounted. */
+export const HOST_PREFIX = '/_host';
+const CONTENT_TYPES = {
+    '.html': 'text/html; charset=utf-8',
+    '.js': 'text/javascript; charset=utf-8',
+    '.mjs': 'text/javascript; charset=utf-8',
+    '.json': 'application/json; charset=utf-8',
+    '.map': 'application/json; charset=utf-8',
+    '.css': 'text/css; charset=utf-8',
+    '.svg': 'image/svg+xml',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.ico': 'image/x-icon',
+    '.woff2': 'font/woff2',
+    '.txt': 'text/plain; charset=utf-8',
+};
+export function contentTypeOf(path) {
+    return CONTENT_TYPES[extname(path).toLowerCase()] ?? 'application/octet-stream';
+}
+function isLocalHost(value) {
+    return (value !== null &&
+        typeof value === 'object' &&
+        typeof value.handle === 'function' &&
+        typeof value.envelopeEntries === 'function');
+}
+/** The address a browser should open for a bound interface. */
+export function urlFor(hostname, port) {
+    const h = hostname === '0.0.0.0' || hostname === '::' || hostname === '' ? 'localhost' : hostname;
+    return `http://${h.includes(':') ? `[${h}]` : h}:${port}/`;
+}
+function send(res, status, type, body, head = false) {
+    res.writeHead(status, {
+        'content-type': type,
+        'cache-control': 'no-store',
+        'content-length': typeof body === 'string' ? Buffer.byteLength(body) : body.byteLength,
+    });
+    res.end(head ? undefined : body);
+}
+/** Lines for the terminal: everything that is the app's own, and a count of what pinned packs say. */
+export function logLines(diagnostics) {
+    const own = [];
+    let packWarnings = 0;
+    for (const d of diagnostics) {
+        if (d.severity !== 'error' && d.path?.startsWith(`${PWF_DIR}/`)) {
+            packWarnings++;
+            continue;
+        }
+        if (d.severity === 'info')
+            continue;
+        own.push(formatDiagnostic(d));
+    }
+    if (packWarnings > 0)
+        own.push(`${packWarnings} finding${packWarnings === 1 ? '' : 's'} in pinned packs (\`pwf build\` lists them)`);
+    return own;
+}
+/** Starts the dev server with the internal seams. {@link startDevServer} is the public entry. */
+export async function createDevServer(options, internals = {}) {
+    const root = resolve(options.root);
+    const log = options.log ?? (() => undefined);
+    const hostname = options.hostname ?? DEFAULT_HOSTNAME;
+    const cache = createCompileCache(internals.assemble?.cacheDir === undefined ? join(root, PWF_DIR, 'build-cache') : internals.assemble.cacheDir);
+    // ── the local host ───────────────────────────────────────────────
+    let host = null;
+    if (isLocalHost(options.localHost)) {
+        host = options.localHost;
+    }
+    else if (options.localHost !== false) {
+        const needs = await hostNeeds(root);
+        const wanted = options.localHost === true || needs.length > 0;
+        if (wanted && internals.createHost) {
+            host = internals.createHost({ root, prefix: HOST_PREFIX });
+        }
+        else if (wanted) {
+            log(`note: this app declares ${needs.join(' and ') || 'a host'}, but no local host is mounted — pages render, ${needs.includes('sign-in') ? 'sign-in cannot complete and ' : ''}data stays empty`);
+        }
+    }
+    // ── state ────────────────────────────────────────────────────────
+    let state = null;
+    const packMemo = new Map();
+    const clients = new Set();
+    let origin = '';
+    const broadcast = (event, data) => {
+        const frame = `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+        for (const c of clients)
+            c.write(frame);
+    };
+    const build = async () => {
+        let result;
+        try {
+            result = await assemblePwapp(root, {
+                ...internals.assemble,
+                cache,
+                packMemo,
+                shellExtra: RELOAD_CLIENT,
+                ...(host ? { envelopeEntries: host.envelopeEntries(origin) } : {}),
+            });
+        }
+        catch (e) {
+            const diagnostics = [
+                { severity: 'error', code: 'INTERNAL', message: e instanceof Error ? (e.stack ?? e.message) : String(e) },
+            ];
+            result = {
+                ok: false,
+                files: state?.files ?? new Map(),
+                diagnostics,
+                stats: { pages: 0, blocks: 0, engines: 0, atoms: 0, compiled: 0, fromCache: 0, failed: 0 },
+                ms: 0,
+            };
+        }
+        state = result;
+        const { stats } = result;
+        log(`${result.ok ? 'built' : 'build failed'} in ${result.ms} ms — ${stats.pages} page${stats.pages === 1 ? '' : 's'}, ${stats.blocks} block type${stats.blocks === 1 ? '' : 's'}, ${stats.compiled}/${stats.atoms} atoms compiled (${stats.fromCache} from cache${stats.failed ? `, ${stats.failed} failed` : ''})`);
+        for (const line of logLines(result.diagnostics))
+            log(`  ${line}`);
+        broadcast('reload', { ok: result.ok });
+        return { ok: result.ok, compiled: stats.compiled, diagnostics: result.diagnostics.map(formatDiagnostic), ms: result.ms };
+    };
+    let chain = Promise.resolve();
+    const rebuild = () => {
+        const next = chain.then(build, build);
+        chain = next.catch(() => undefined);
+        return next;
+    };
+    // ── HTTP ─────────────────────────────────────────────────────────
+    const handle = async (req, res) => {
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        if (url.pathname === EVENTS_PATH) {
+            res.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-store', connection: 'keep-alive' });
+            res.write(': connected\n\n');
+            clients.add(res);
+            req.on('close', () => clients.delete(res));
+            return;
+        }
+        if (url.pathname === RELOAD_PATH) {
+            send(res, 200, CONTENT_TYPES['.js'], RELOAD_JS, req.method === 'HEAD');
+            return;
+        }
+        if (url.pathname === STATUS_PATH) {
+            send(res, 200, CONTENT_TYPES['.json'], JSON.stringify({ ok: state?.ok ?? false, diagnostics: state?.diagnostics ?? [] }));
+            return;
+        }
+        if (host && (await host.handle(req, res)))
+            return;
+        if (req.method !== 'GET' && req.method !== 'HEAD') {
+            send(res, 405, CONTENT_TYPES['.txt'], 'method not allowed');
+            return;
+        }
+        const head = req.method === 'HEAD';
+        let path;
+        try {
+            path = decodeURIComponent(url.pathname);
+        }
+        catch {
+            send(res, 400, CONTENT_TYPES['.txt'], 'bad path', head);
+            return;
+        }
+        let rel = path.replace(/^\/+/, '');
+        if (rel === '' || rel.endsWith('/'))
+            rel += 'index.html';
+        if (rel.split('/').some((s) => s === '..' || s === '.') || rel.includes('\\') || rel.includes('\0')) {
+            send(res, 400, CONTENT_TYPES['.txt'], 'bad path', head);
+            return;
+        }
+        const current = state;
+        const isPage = rel === 'index.html' || extname(rel) === '';
+        if (isPage && current && !current.ok) {
+            send(res, 200, CONTENT_TYPES['.html'], overlayHtml(current.diagnostics), head);
+            return;
+        }
+        // `_headers` configures a static host; it is not part of the site.
+        const file = rel === '_headers'
+            ? undefined
+            : (current?.files.get(rel) ?? (extname(rel) === '' ? current?.files.get('index.html') : undefined));
+        if (!file) {
+            send(res, 404, CONTENT_TYPES['.txt'], `not found: /${rel}`, head);
+            return;
+        }
+        // A nested page path answered with the shell needs the app's base, or the
+        // shell's relative script addresses resolve under the page's folder.
+        const body = isPage && rel !== 'index.html' ? withBaseHref(file) : file;
+        send(res, 200, contentTypeOf(isPage ? 'index.html' : rel), body, head);
+    };
+    const server = createServer((req, res) => {
+        handle(req, res).catch((e) => {
+            if (!res.headersSent)
+                send(res, 500, CONTENT_TYPES['.txt'], e instanceof Error ? e.message : String(e));
+            else
+                res.end();
+        });
+    });
+    await new Promise((ok, fail) => {
+        server.once('error', fail);
+        server.listen(options.port ?? DEFAULT_PORT, hostname, () => {
+            server.off('error', fail);
+            ok();
+        });
+    });
+    const port = server.address().port;
+    const url = urlFor(hostname, port);
+    origin = url.replace(/\/$/, '');
+    if (host) {
+        log(`local host mounted at ${origin}${HOST_PREFIX} — development only: records in memory, one user, any password`);
+    }
+    await rebuild();
+    let watcher = null;
+    if (internals.watch !== false) {
+        watcher = watchFolder(root, (paths) => {
+            // A pack build changed (or the platform could not say what did): read it again.
+            if (paths === null || paths.some((p) => p.startsWith(`${PWF_DIR}/packs`)))
+                packMemo.clear();
+            void rebuild();
+        }, internals.watch ?? {});
+        log(`watching ${root} (${watcher.mode === 'native' ? 'file events' : 'polling'})`);
+    }
+    let closed = null;
+    return {
+        url,
+        rebuild,
+        close() {
+            closed ??= (async () => {
+                watcher?.close();
+                for (const c of clients)
+                    c.end();
+                clients.clear();
+                await new Promise((ok) => {
+                    server.close(() => ok());
+                    server.closeAllConnections();
+                });
+                await chain;
+            })();
+            return closed;
+        },
+    };
+}
+/** Implements the `pwf dev` contract (see ./types.ts). */
+export const startDevServer = (options) => createDevServer(options);
+//# sourceMappingURL=server.js.map

package/dist/dev/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/dev/server.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `pwf dev`: serves an app folder as a pwapp and keeps it current.\n *\n * One `node:http` server on 127.0.0.1 (port 4600 by default). It assembles\n * the app into memory (see ./assemble.ts), serves the files from there,\n * watches the folder, reassembles on change and tells the open page to reload\n * through Server-Sent Events. While the last build has errors the page is an\n * overlay listing them; the terminal gets the same list.\n *\n * When the app declares sign-in or records it needs a local host. A host\n * passed in `localHost` is mounted on the same server: requests it claims go\n * to `host.handle()`, and the envelope carries `host.envelopeEntries()`.\n * This module never constructs a host itself (it depends on the host's\n * interface only); a caller that can make one passes `createHost`.\n */\nimport { createServer, type IncomingMessage, type ServerResponse } from 'node:http'\nimport type { AddressInfo } from 'node:net'\nimport { extname, join, resolve } from 'node:path'\nimport type { CreateLocalHost, LocalHost } from '../host/types.js'\nimport { assemblePwapp, type AssembleOptions, type AssembleResult } from './assemble.js'\nimport { createCompileCache } from './compile.js'\nimport { formatDiagnostic, type AssembleDiagnostic } from './diagnostics.js'\nimport { hostNeeds } from './needs-host.js'\nimport { EVENTS_PATH, overlayHtml, RELOAD_CLIENT, RELOAD_JS, RELOAD_PATH, STATUS_PATH } from './overlay.js'\nimport { withBaseHref } from './shell.js'\nimport { PWF_DIR, type PackMemo } from './sources.js'\nimport type { DevBuildResult, DevServer, DevServerOptions, StartDevServer } from './types.js'\nimport { watchFolder, type WatchOptions, type Watcher } from './watcher.js'\n\nexport const DEFAULT_PORT = 4600\nexport const DEFAULT_HOSTNAME = '127.0.0.1'\n/** Where a host this server creates is mounted. */\nexport const HOST_PREFIX = '/_host'\n\n/** Seams for the `dev` command and for tests; not part of the public contract. */\nexport interface DevServerInternals {\n  /** Watching; `false` turns it off. */\n  readonly watch?: WatchOptions | false\n  /** Makes a host when the app needs one and none was passed. */\n  readonly createHost?: CreateLocalHost\n  /** Assembly options (runtime bundles, cache folder). */\n  readonly assemble?: Pick<AssembleOptions, 'runtime' | 'cacheDir' | 'publishedAt'>\n}\n\nconst CONTENT_TYPES: Readonly<Record<string, string>> = {\n  '.html': 'text/html; charset=utf-8',\n  '.js': 'text/javascript; charset=utf-8',\n  '.mjs': 'text/javascript; charset=utf-8',\n  '.json': 'application/json; charset=utf-8',\n  '.map': 'application/json; charset=utf-8',\n  '.css': 'text/css; charset=utf-8',\n  '.svg': 'image/svg+xml',\n  '.png': 'image/png',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.gif': 'image/gif',\n  '.webp': 'image/webp',\n  '.avif': 'image/avif',\n  '.ico': 'image/x-icon',\n  '.woff2': 'font/woff2',\n  '.txt': 'text/plain; charset=utf-8',\n}\n\nexport function contentTypeOf(path: string): string {\n  return CONTENT_TYPES[extname(path).toLowerCase()] ?? 'application/octet-stream'\n}\n\nfunction isLocalHost(value: unknown): value is LocalHost {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as LocalHost).handle === 'function' &&\n    typeof (value as LocalHost).envelopeEntries === 'function'\n  )\n}\n\n/** The address a browser should open for a bound interface. */\nexport function urlFor(hostname: string, port: number): string {\n  const h = hostname === '0.0.0.0' || hostname === '::' || hostname === '' ? 'localhost' : hostname\n  return `http://${h.includes(':') ? `[${h}]` : h}:${port}/`\n}\n\nfunction send(res: ServerResponse, status: number, type: string, body: string | Uint8Array, head = false): void {\n  res.writeHead(status, {\n    'content-type': type,\n    'cache-control': 'no-store',\n    'content-length': typeof body === 'string' ? Buffer.byteLength(body) : body.byteLength,\n  })\n  res.end(head ? undefined : body)\n}\n\n/** Lines for the terminal: everything that is the app's own, and a count of what pinned packs say. */\nexport function logLines(diagnostics: readonly AssembleDiagnostic[]): string[] {\n  const own: string[] = []\n  let packWarnings = 0\n  for (const d of diagnostics) {\n    if (d.severity !== 'error' && d.path?.startsWith(`${PWF_DIR}/`)) {\n      packWarnings++\n      continue\n    }\n    if (d.severity === 'info') continue\n    own.push(formatDiagnostic(d))\n  }\n  if (packWarnings > 0) own.push(`${packWarnings} finding${packWarnings === 1 ? '' : 's'} in pinned packs (\\`pwf build\\` lists them)`)\n  return own\n}\n\n/** Starts the dev server with the internal seams. {@link startDevServer} is the public entry. */\nexport async function createDevServer(options: DevServerOptions, internals: DevServerInternals = {}): Promise<DevServer> {\n  const root = resolve(options.root)\n  const log = options.log ?? ((): void => undefined)\n  const hostname = options.hostname ?? DEFAULT_HOSTNAME\n  const cache = createCompileCache(\n    internals.assemble?.cacheDir === undefined ? join(root, PWF_DIR, 'build-cache') : internals.assemble.cacheDir\n  )\n\n  // ── the local host ───────────────────────────────────────────────\n  let host: LocalHost | null = null\n  if (isLocalHost(options.localHost)) {\n    host = options.localHost\n  } else if (options.localHost !== false) {\n    const needs = await hostNeeds(root)\n    const wanted = options.localHost === true || needs.length > 0\n    if (wanted && internals.createHost) {\n      host = internals.createHost({ root, prefix: HOST_PREFIX })\n    } else if (wanted) {\n      log(\n        `note: this app declares ${needs.join(' and ') || 'a host'}, but no local host is mounted — pages render, ${\n          needs.includes('sign-in') ? 'sign-in cannot complete and ' : ''\n        }data stays empty`\n      )\n    }\n  }\n\n  // ── state ────────────────────────────────────────────────────────\n  let state: AssembleResult | null = null\n  const packMemo: PackMemo = new Map()\n  const clients = new Set<ServerResponse>()\n  let origin = ''\n\n  const broadcast = (event: string, data: unknown): void => {\n    const frame = `event: ${event}\\ndata: ${JSON.stringify(data)}\\n\\n`\n    for (const c of clients) c.write(frame)\n  }\n\n  const build = async (): Promise<DevBuildResult> => {\n    let result: AssembleResult\n    try {\n      result = await assemblePwapp(root, {\n        ...internals.assemble,\n        cache,\n        packMemo,\n        shellExtra: RELOAD_CLIENT,\n        ...(host ? { envelopeEntries: host.envelopeEntries(origin) } : {}),\n      })\n    } catch (e) {\n      const diagnostics: AssembleDiagnostic[] = [\n        { severity: 'error', code: 'INTERNAL', message: e instanceof Error ? (e.stack ?? e.message) : String(e) },\n      ]\n      result = {\n        ok: false,\n        files: state?.files ?? new Map(),\n        diagnostics,\n        stats: { pages: 0, blocks: 0, engines: 0, atoms: 0, compiled: 0, fromCache: 0, failed: 0 },\n        ms: 0,\n      }\n    }\n    state = result\n    const { stats } = result\n    log(\n      `${result.ok ? 'built' : 'build failed'} in ${result.ms} ms — ${stats.pages} page${stats.pages === 1 ? '' : 's'}, ${\n        stats.blocks\n      } block type${stats.blocks === 1 ? '' : 's'}, ${stats.compiled}/${stats.atoms} atoms compiled (${stats.fromCache} from cache${\n        stats.failed ? `, ${stats.failed} failed` : ''\n      })`\n    )\n    for (const line of logLines(result.diagnostics)) log(`  ${line}`)\n    broadcast('reload', { ok: result.ok })\n    return { ok: result.ok, compiled: stats.compiled, diagnostics: result.diagnostics.map(formatDiagnostic), ms: result.ms }\n  }\n\n  let chain: Promise<unknown> = Promise.resolve()\n  const rebuild = (): Promise<DevBuildResult> => {\n    const next = chain.then(build, build)\n    chain = next.catch(() => undefined)\n    return next\n  }\n\n  // ── HTTP ─────────────────────────────────────────────────────────\n  const handle = async (req: IncomingMessage, res: ServerResponse): Promise<void> => {\n    const url = new URL(req.url ?? '/', 'http://localhost')\n    if (url.pathname === EVENTS_PATH) {\n      res.writeHead(200, { 'content-type': 'text/event-stream', 'cache-control': 'no-store', connection: 'keep-alive' })\n      res.write(': connected\\n\\n')\n      clients.add(res)\n      req.on('close', () => clients.delete(res))\n      return\n    }\n    if (url.pathname === RELOAD_PATH) {\n      send(res, 200, CONTENT_TYPES['.js'] as string, RELOAD_JS, req.method === 'HEAD')\n      return\n    }\n    if (url.pathname === STATUS_PATH) {\n      send(res, 200, CONTENT_TYPES['.json'] as string, JSON.stringify({ ok: state?.ok ?? false, diagnostics: state?.diagnostics ?? [] }))\n      return\n    }\n    if (host && (await host.handle(req, res))) return\n    if (req.method !== 'GET' && req.method !== 'HEAD') {\n      send(res, 405, CONTENT_TYPES['.txt'] as string, 'method not allowed')\n      return\n    }\n    const head = req.method === 'HEAD'\n    let path: string\n    try {\n      path = decodeURIComponent(url.pathname)\n    } catch {\n      send(res, 400, CONTENT_TYPES['.txt'] as string, 'bad path', head)\n      return\n    }\n    let rel = path.replace(/^\\/+/, '')\n    if (rel === '' || rel.endsWith('/')) rel += 'index.html'\n    if (rel.split('/').some((s) => s === '..' || s === '.') || rel.includes('\\\\') || rel.includes('\\0')) {\n      send(res, 400, CONTENT_TYPES['.txt'] as string, 'bad path', head)\n      return\n    }\n    const current = state\n    const isPage = rel === 'index.html' || extname(rel) === ''\n    if (isPage && current && !current.ok) {\n      send(res, 200, CONTENT_TYPES['.html'] as string, overlayHtml(current.diagnostics), head)\n      return\n    }\n    // `_headers` configures a static host; it is not part of the site.\n    const file =\n      rel === '_headers'\n        ? undefined\n        : (current?.files.get(rel) ?? (extname(rel) === '' ? current?.files.get('index.html') : undefined))\n    if (!file) {\n      send(res, 404, CONTENT_TYPES['.txt'] as string, `not found: /${rel}`, head)\n      return\n    }\n    // A nested page path answered with the shell needs the app's base, or the\n    // shell's relative script addresses resolve under the page's folder.\n    const body = isPage && rel !== 'index.html' ? withBaseHref(file) : file\n    send(res, 200, contentTypeOf(isPage ? 'index.html' : rel), body, head)\n  }\n\n  const server = createServer((req, res) => {\n    handle(req, res).catch((e: unknown) => {\n      if (!res.headersSent) send(res, 500, CONTENT_TYPES['.txt'] as string, e instanceof Error ? e.message : String(e))\n      else res.end()\n    })\n  })\n  await new Promise<void>((ok, fail) => {\n    server.once('error', fail)\n    server.listen(options.port ?? DEFAULT_PORT, hostname, () => {\n      server.off('error', fail)\n      ok()\n    })\n  })\n  const port = (server.address() as AddressInfo).port\n  const url = urlFor(hostname, port)\n  origin = url.replace(/\\/$/, '')\n  if (host) {\n    log(`local host mounted at ${origin}${HOST_PREFIX} — development only: records in memory, one user, any password`)\n  }\n\n  await rebuild()\n\n  let watcher: Watcher | null = null\n  if (internals.watch !== false) {\n    watcher = watchFolder(\n      root,\n      (paths) => {\n        // A pack build changed (or the platform could not say what did): read it again.\n        if (paths === null || paths.some((p) => p.startsWith(`${PWF_DIR}/packs`))) packMemo.clear()\n        void rebuild()\n      },\n      internals.watch ?? {}\n    )\n    log(`watching ${root} (${watcher.mode === 'native' ? 'file events' : 'polling'})`)\n  }\n\n  let closed: Promise<void> | null = null\n  return {\n    url,\n    rebuild,\n    close() {\n      closed ??= (async () => {\n        watcher?.close()\n        for (const c of clients) c.end()\n        clients.clear()\n        await new Promise<void>((ok) => {\n          server.close(() => ok())\n          server.closeAllConnections()\n        })\n        await chain\n      })()\n      return closed\n    },\n  }\n}\n\n/** Implements the `pwf dev` contract (see ./types.ts). */\nexport const startDevServer: StartDevServer = (options) => createDevServer(options)\n"]}

package/dist/dev/shell.d.ts

@@ -0,0 +1,94 @@
+/** The runner and renderer bundles a pwapp ships. */
+export interface RuntimeAssets {
+    /** `assets/runner.js` — the ES module exporting `runApp`. */
+    readonly runnerJs: string;
+    /** Its source map, when the build has one. */
+    readonly runnerMap?: string;
+    /** `assets/embed.js` — the classic script that defines `window.PWFabric`. */
+    readonly embedJs: string;
+}
+/** Reads the built runner and renderer from the installed engine packages (once per process). */
+export declare function loadRuntimeAssets(): Promise<RuntimeAssets>;
+/**
+ * Globals the renderer bundle does not seed itself, and the vendor-table key
+ * the shell seeds each from (see {@link buildShellHtml}), so blocks that reach
+ * for these get the renderer's own instance instead of `undefined`.
+ *
+ * The renderer bundle (`@pwfabric/embed`'s `embed.js`) carries `react-dom`,
+ * `@pwfabric/core` and `@pwfabric/authoring` (the `sdk@v1` shim's package)
+ * in its `__PW_VENDOR__` table but does not seed these globals itself, so a
+ * block that uses a VALUE from core or the authoring kit (as opposed to a
+ * type) reads the renderer's instance here instead of `undefined`.
+ */
+export declare const SHELL_SEEDED_GLOBALS: Readonly<Record<string, string>>;
+/** Whether `name` can be an `export const { name }` binding. */
+export declare function isExportableName(name: string): boolean;
+/** Evaluates the renderer bundle in an isolated context and returns what it put on `globalThis`. */
+export declare function seededGlobals(embedJs: string): Record<string, unknown>;
+/** The global each shim file reads (every specifier sharing a shim names the same global). */
+export declare function shimGlobal(shim: string): string;
+/** Source of one shim module. */
+export declare function shimSource(shim: string, global: string, names: readonly string[]): string;
+/**
+ * Every shim file the import map can point at, with its source.
+ *
+ * Names come from, in order: the global the renderer seeds; the vendor table
+ * entry the shell seeds the global from; the package itself (for globals no
+ * standalone page seeds — their exports resolve to `undefined`, which keeps a
+ * block linking instead of failing at load).
+ */
+export declare function buildShims(embedJs: string): Promise<Map<string, string>>;
+/** {@link buildShims}, once per renderer bundle. */
+export declare function shimsFor(embedJs: string): Promise<Map<string, string>>;
+/** The import map: every host import → `./shims/<file>`. */
+export declare function importMap(): {
+    readonly imports: Record<string, string>;
+};
+export declare function escapeHtml(s: string): string;
+/** JSON safe to place inside a `<script>` element. */
+export declare function scriptJson(value: unknown): string;
+export interface ShellOptions {
+    readonly title: string;
+    /** `<html lang>`; default `en`. */
+    readonly lang?: string;
+    /** The app's appearance configuration (its webfonts are linked). */
+    readonly appearance?: Record<string, unknown>;
+    /** Markup appended to `<body>` (the dev server's reload client). */
+    readonly bodyExtra?: string;
+    /** The policy for the shell's `<meta http-equiv="Content-Security-Policy">`; none when absent. */
+    readonly csp?: string;
+}
+/** The exact text of the shell's inline import map (the CSP hashes this). */
+export declare function importMapText(): string;
+/**
+ * `assets/seed.js`: seeds the globals the renderer does not seed itself from
+ * its vendor table (a file, not an inline script, so the policy needs no hash).
+ */
+export declare function seedScript(): string;
+/** `assets/boot.js`: the module that starts the runner. */
+export declare function bootScript(locale?: 'en' | 'tr'): string;
+/** A BCP-47-looking tag, or `en`. */
+export declare function htmlLangOf(locale: string | undefined): string;
+/** `tr-TR` → `tr`; the runner's copy knows `en` and `tr`. */
+export declare function runnerLocaleOf(locale: string | undefined): 'en' | 'tr';
+/**
+ * `index.html`, in the order the pwapp format requires: import map, the
+ * renderer (a classic script that seeds the shared globals) and `seed.js`,
+ * the mount element, then `boot.js`, which starts the runner. The import map
+ * is the only inline script, so a Content Security Policy needs one hash.
+ * Every address is relative, so the folder works at a host root, under a
+ * sub-path, or from disk behind any static server.
+ */
+export declare function buildShellHtml(options: ShellOptions): string;
+/**
+ * The shell with `<base href="/">` as the first element of its head, unless it
+ * already declares a base.
+ *
+ * The shell addresses its scripts and the import map relatively (`./assets/…`,
+ * `./shims/…`) so the folder works under any sub-path. When a server answers a
+ * nested page path (`/team/members`) with that shell, the browser would resolve
+ * those addresses against `/team/` and miss every file. The pwapp format puts
+ * the fix on the host: under path routing it declares the app's base with
+ * `<base href>`. This server serves the app at its root, so the base is `/`.
+ */
+export declare function withBaseHref(body: Uint8Array, href?: string): Uint8Array;