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

package/dist/commands/pack.js

@@ -0,0 +1,56 @@
+/**
+ * `pwf pack [dir]` — the deterministic `.pwpack` archive of a valid folder.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { hashPack, packContent, writePwpack } from '@pwfabric/pack';
+import { guard, stringFlag } from './lib/flags.js';
+import { readProject, resolveFrom } from './lib/project.js';
+import { countLine, printIssues, validateProject } from './lib/report.js';
+/** `<name>-<version>.pwpack`, where name is the last segment of the pack id. */
+export function archiveName(id, version) {
+    const name = id.split('/').pop()?.replace(/^@/, '') || 'pack';
+    return `${name}-${version}.pwpack`;
+}
+export async function runPack(args, io) {
+    const root = resolveFrom(io.cwd, args.positionals[0]);
+    const pack = await readProject(root);
+    const result = await validateProject(root, pack);
+    if (!result.ok || !result.identity) {
+        printIssues(io, result.issues);
+        io.err(`pwf pack: ${root} is not valid (${countLine(result.issues)}); nothing written`);
+        return 1;
+    }
+    printIssues(io, result.issues.filter((i) => i.severity === 'warning'));
+    const { id, version } = result.identity;
+    const outFlag = stringFlag(args, 'out');
+    const out = outFlag ? resolveFrom(io.cwd, outFlag) : join(root, archiveName(id, version));
+    // The archive carries the pack content only: an author's tooling never
+    // ships, and the archive hashes the same as the folder it came from.
+    const content = packContent(pack);
+    const bytes = await writePwpack(content);
+    await mkdir(dirname(out), { recursive: true });
+    await writeFile(out, bytes);
+    const left = pack.files.size - content.files.size;
+    io.out(`Packed ${id}@${version}`);
+    io.out(`  file  ${out}`);
+    io.out(`  size  ${bytes.byteLength} bytes, ${content.files.size} files${left > 0 ? ` (${left} outside the pack content left out)` : ''}`);
+    io.out(`  hash  ${hashPack(content)}`);
+    return 0;
+}
+export const pack = {
+    name: 'pack',
+    summary: 'Write the deterministic .pwpack archive of a folder',
+    usage: `pwf pack [dir] [--out <file>]
+
+  dir           the pwpack folder (default: the current folder)
+  --out <file>  where to write (default <dir>/<name>-<version>.pwpack)
+
+Validates first and refuses on errors. The archive holds the pack content
+only — pwpack.json, LICENSE, NOTICE, README.md, app/, atoms/ and media/ —
+never .pwf/, .gitignore or the author's tooling (package.json, scripts/, …).
+The same folder always gives the same bytes; the printed hash is the
+content hash pins use.`,
+    run: (args, io) => guard('pack', io, () => runPack(args, io)),
+};
+//# sourceMappingURL=pack.js.map

package/dist/commands/pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pack.js","sourceRoot":"","sources":["../../src/commands/pack.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `pwf pack [dir]` — the deterministic `.pwpack` archive of a valid folder.\n */\nimport { mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, join } from 'node:path'\nimport { hashPack, packContent, writePwpack } from '@pwfabric/pack'\nimport type { Command, CommandIO, ParsedArgs } from './types.js'\nimport { guard, stringFlag } from './lib/flags.js'\nimport { readProject, resolveFrom } from './lib/project.js'\nimport { countLine, printIssues, validateProject } from './lib/report.js'\n\n/** `<name>-<version>.pwpack`, where name is the last segment of the pack id. */\nexport function archiveName(id: string, version: string): string {\n  const name = id.split('/').pop()?.replace(/^@/, '') || 'pack'\n  return `${name}-${version}.pwpack`\n}\n\nexport async function runPack(args: ParsedArgs, io: CommandIO): Promise<number> {\n  const root = resolveFrom(io.cwd, args.positionals[0])\n  const pack = await readProject(root)\n  const result = await validateProject(root, pack)\n  if (!result.ok || !result.identity) {\n    printIssues(io, result.issues)\n    io.err(`pwf pack: ${root} is not valid (${countLine(result.issues)}); nothing written`)\n    return 1\n  }\n  printIssues(\n    io,\n    result.issues.filter((i) => i.severity === 'warning')\n  )\n  const { id, version } = result.identity\n  const outFlag = stringFlag(args, 'out')\n  const out = outFlag ? resolveFrom(io.cwd, outFlag) : join(root, archiveName(id, version))\n  // The archive carries the pack content only: an author's tooling never\n  // ships, and the archive hashes the same as the folder it came from.\n  const content = packContent(pack)\n  const bytes = await writePwpack(content)\n  await mkdir(dirname(out), { recursive: true })\n  await writeFile(out, bytes)\n  const left = pack.files.size - content.files.size\n  io.out(`Packed ${id}@${version}`)\n  io.out(`  file  ${out}`)\n  io.out(`  size  ${bytes.byteLength} bytes, ${content.files.size} files${left > 0 ? ` (${left} outside the pack content left out)` : ''}`)\n  io.out(`  hash  ${hashPack(content)}`)\n  return 0\n}\n\nexport const pack: Command = {\n  name: 'pack',\n  summary: 'Write the deterministic .pwpack archive of a folder',\n  usage: `pwf pack [dir] [--out <file>]\n\n  dir           the pwpack folder (default: the current folder)\n  --out <file>  where to write (default <dir>/<name>-<version>.pwpack)\n\nValidates first and refuses on errors. The archive holds the pack content\nonly — pwpack.json, LICENSE, NOTICE, README.md, app/, atoms/ and media/ —\nnever .pwf/, .gitignore or the author's tooling (package.json, scripts/, …).\nThe same folder always gives the same bytes; the printed hash is the\ncontent hash pins use.`,\n  run: (args, io) => guard('pack', io, () => runPack(args, io)),\n}\n"]}

package/dist/commands/registry.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from './types.js';
+/**
+ * Every `pwf` command. Lanes add their command module here and nowhere else.
+ * Order is the order `pwf help` prints.
+ */
+export declare const COMMANDS: Command[];
+export declare function findCommand(name: string): Command | undefined;

package/dist/commands/registry.js

@@ -0,0 +1,16 @@
+import { create } from './create.js';
+import { devCommand } from './dev.js';
+import { buildCommand } from './build.js';
+import { validate } from './validate.js';
+import { pack } from './pack.js';
+import { add } from './add.js';
+import { run } from './run.js';
+/**
+ * Every `pwf` command. Lanes add their command module here and nowhere else.
+ * Order is the order `pwf help` prints.
+ */
+export const COMMANDS = [create, devCommand, buildCommand, validate, pack, add, run];
+export function findCommand(name) {
+    return COMMANDS.find((c) => c.name === name);
+}
+//# sourceMappingURL=registry.js.map

package/dist/commands/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAc,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;AAE/F,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAA;AAC9C,CAAC","sourcesContent":["import type { Command } from './types.js'\nimport { create } from './create.js'\nimport { devCommand } from './dev.js'\nimport { buildCommand } from './build.js'\nimport { validate } from './validate.js'\nimport { pack } from './pack.js'\nimport { add } from './add.js'\nimport { run } from './run.js'\n\n/**\n * Every `pwf` command. Lanes add their command module here and nowhere else.\n * Order is the order `pwf help` prints.\n */\nexport const COMMANDS: Command[] = [create, devCommand, buildCommand, validate, pack, add, run]\n\nexport function findCommand(name: string): Command | undefined {\n  return COMMANDS.find((c) => c.name === name)\n}\n"]}

package/dist/commands/run.d.ts

@@ -0,0 +1,14 @@
+import type { Command, CommandIO, ParsedArgs } from './types.js';
+import { type StaticServer, type StaticSource } from './lib/static-server.js';
+export declare const DEFAULT_RUN_PORT = 4700;
+/** Resolves when the process is asked to stop (Ctrl-C or SIGTERM). */
+export declare function untilSignal(): Promise<void>;
+export declare function parsePort(value: string | undefined): number;
+/** The source to serve: a folder with an `index.html`, or a `.pwapp` archive opened in memory. */
+export declare function openRunSource(path: string): Promise<StaticSource>;
+export interface RunOptions {
+    /** Resolves when the server should stop. Default: SIGINT or SIGTERM. */
+    readonly until?: (server: StaticServer) => Promise<void>;
+}
+export declare function runRun(args: ParsedArgs, io: CommandIO, options?: RunOptions): Promise<number>;
+export declare const run: Command;

package/dist/commands/run.js

@@ -0,0 +1,79 @@
+/**
+ * `pwf run <dir|file.pwapp>` — serve a built pwapp locally.
+ */
+import { readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { readPwpack } from '@pwfabric/pack';
+import { guard, stringFlag, UsageError } from './lib/flags.js';
+import { resolveFrom } from './lib/project.js';
+import { startStaticServer } from './lib/static-server.js';
+export const DEFAULT_RUN_PORT = 4700;
+/** Resolves when the process is asked to stop (Ctrl-C or SIGTERM). */
+export function untilSignal() {
+    return new Promise((done) => {
+        const stop = () => {
+            process.off('SIGINT', stop);
+            process.off('SIGTERM', stop);
+            done();
+        };
+        process.on('SIGINT', stop);
+        process.on('SIGTERM', stop);
+    });
+}
+export function parsePort(value) {
+    if (value === undefined)
+        return DEFAULT_RUN_PORT;
+    const port = Number(value);
+    if (!/^\d+$/.test(value) || port > 65535)
+        throw new UsageError(`--port "${value}" is not a port number`);
+    return port;
+}
+/** The source to serve: a folder with an `index.html`, or a `.pwapp` archive opened in memory. */
+export async function openRunSource(path) {
+    const st = await stat(path).catch(() => null);
+    if (!st)
+        throw new Error(`no such file or folder: ${path}`);
+    if (st.isDirectory()) {
+        const index = await stat(join(path, 'index.html')).catch(() => null);
+        if (!index?.isFile())
+            throw new Error(`${path} has no index.html; build the app first (pwf build)`);
+        return { dir: path };
+    }
+    const { files } = await readPwpack(new Uint8Array(await readFile(path)));
+    if (!files.has('index.html'))
+        throw new Error(`${path} has no index.html at its root; it is not a built pwapp`);
+    return { files };
+}
+export async function runRun(args, io, options = {}) {
+    const target = args.positionals[0];
+    if (target === undefined)
+        throw new UsageError('missing <dir|file.pwapp>');
+    const port = parsePort(stringFlag(args, 'port'));
+    const hostname = stringFlag(args, 'host') ?? '127.0.0.1';
+    const source = await openRunSource(resolveFrom(io.cwd, target));
+    const server = await startStaticServer({ source, port, hostname });
+    io.out(`Serving ${target} at ${server.url}`);
+    io.out('Press Ctrl-C to stop.');
+    try {
+        await (options.until ?? untilSignal)(server);
+    }
+    finally {
+        await server.close();
+    }
+    return 0;
+}
+export const run = {
+    name: 'run',
+    summary: 'Serve a built pwapp (folder or .pwapp) on a local port',
+    usage: `pwf run <dir|file.pwapp> [--port <n>] [--host <name>]
+
+  <dir>          a built pwapp folder with an index.html (see pwf build)
+  <file.pwapp>   a packaged pwapp (gzipped tar, read like a .pwpack), served from memory
+  --port <n>     port to listen on (default ${DEFAULT_RUN_PORT}; 0 picks a free one)
+  --host <name>  interface to bind (default 127.0.0.1)
+
+Page paths without a file extension are answered with index.html and a
+<base href="/">, so path-routed apps work at any depth; a missing asset is a 404.`,
+    run: (args, io) => guard('run', io, () => runRun(args, io)),
+};
+//# sourceMappingURL=run.js.map

package/dist/commands/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * `pwf run <dir|file.pwapp>` — serve a built pwapp locally.\n */\nimport { readFile, stat } from 'node:fs/promises'\nimport { join } from 'node:path'\nimport { readPwpack } from '@pwfabric/pack'\nimport type { Command, CommandIO, ParsedArgs } from './types.js'\nimport { guard, stringFlag, UsageError } from './lib/flags.js'\nimport { resolveFrom } from './lib/project.js'\nimport { startStaticServer, type StaticServer, type StaticSource } from './lib/static-server.js'\n\nexport const DEFAULT_RUN_PORT = 4700\n\n/** Resolves when the process is asked to stop (Ctrl-C or SIGTERM). */\nexport function untilSignal(): Promise<void> {\n  return new Promise((done) => {\n    const stop = (): void => {\n      process.off('SIGINT', stop)\n      process.off('SIGTERM', stop)\n      done()\n    }\n    process.on('SIGINT', stop)\n    process.on('SIGTERM', stop)\n  })\n}\n\nexport function parsePort(value: string | undefined): number {\n  if (value === undefined) return DEFAULT_RUN_PORT\n  const port = Number(value)\n  if (!/^\\d+$/.test(value) || port > 65535) throw new UsageError(`--port \"${value}\" is not a port number`)\n  return port\n}\n\n/** The source to serve: a folder with an `index.html`, or a `.pwapp` archive opened in memory. */\nexport async function openRunSource(path: string): Promise<StaticSource> {\n  const st = await stat(path).catch(() => null)\n  if (!st) throw new Error(`no such file or folder: ${path}`)\n  if (st.isDirectory()) {\n    const index = await stat(join(path, 'index.html')).catch(() => null)\n    if (!index?.isFile()) throw new Error(`${path} has no index.html; build the app first (pwf build)`)\n    return { dir: path }\n  }\n  const { files } = await readPwpack(new Uint8Array(await readFile(path)))\n  if (!files.has('index.html')) throw new Error(`${path} has no index.html at its root; it is not a built pwapp`)\n  return { files }\n}\n\nexport interface RunOptions {\n  /** Resolves when the server should stop. Default: SIGINT or SIGTERM. */\n  readonly until?: (server: StaticServer) => Promise<void>\n}\n\nexport async function runRun(args: ParsedArgs, io: CommandIO, options: RunOptions = {}): Promise<number> {\n  const target = args.positionals[0]\n  if (target === undefined) throw new UsageError('missing <dir|file.pwapp>')\n  const port = parsePort(stringFlag(args, 'port'))\n  const hostname = stringFlag(args, 'host') ?? '127.0.0.1'\n  const source = await openRunSource(resolveFrom(io.cwd, target))\n  const server = await startStaticServer({ source, port, hostname })\n  io.out(`Serving ${target} at ${server.url}`)\n  io.out('Press Ctrl-C to stop.')\n  try {\n    await (options.until ?? untilSignal)(server)\n  } finally {\n    await server.close()\n  }\n  return 0\n}\n\nexport const run: Command = {\n  name: 'run',\n  summary: 'Serve a built pwapp (folder or .pwapp) on a local port',\n  usage: `pwf run <dir|file.pwapp> [--port <n>] [--host <name>]\n\n  <dir>          a built pwapp folder with an index.html (see pwf build)\n  <file.pwapp>   a packaged pwapp (gzipped tar, read like a .pwpack), served from memory\n  --port <n>     port to listen on (default ${DEFAULT_RUN_PORT}; 0 picks a free one)\n  --host <name>  interface to bind (default 127.0.0.1)\n\nPage paths without a file extension are answered with index.html and a\n<base href=\"/\">, so path-routed apps work at any depth; a missing asset is a 404.`,\n  run: (args, io) => guard('run', io, () => runRun(args, io)),\n}\n"]}

package/dist/commands/types.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The contract every `pwf` command implements.
+ *
+ * A command is a plain object registered in ./registry.ts. It never calls
+ * `process.exit` and never writes to `process.stdout` directly: it writes
+ * through the `io` it is given and returns an exit code. That keeps every
+ * command testable in-process.
+ */
+export interface CommandIO {
+    /** Working directory the command runs in (absolute). */
+    readonly cwd: string;
+    /** Normal output. */
+    out(line: string): void;
+    /** Diagnostics and errors. */
+    err(line: string): void;
+    /** Environment variables visible to the command. */
+    readonly env: Readonly<Record<string, string | undefined>>;
+}
+export interface ParsedArgs {
+    /** Positional arguments after the command name. */
+    readonly positionals: readonly string[];
+    /** `--flag value` and `--flag=value` become strings; bare `--flag` becomes true. */
+    readonly flags: Readonly<Record<string, string | boolean>>;
+}
+export interface Command {
+    /** The word after `pwf`, e.g. `create`. */
+    readonly name: string;
+    /** One line shown by `pwf help`. */
+    readonly summary: string;
+    /** Usage line, e.g. `pwf create <name> [--dir <path>]`. */
+    readonly usage: string;
+    /** Runs the command. Resolves to the process exit code (0 = success). */
+    run(args: ParsedArgs, io: CommandIO): Promise<number>;
+}

package/dist/commands/types.js

@@ -0,0 +1,10 @@
+/**
+ * The contract every `pwf` command implements.
+ *
+ * A command is a plain object registered in ./registry.ts. It never calls
+ * `process.exit` and never writes to `process.stdout` directly: it writes
+ * through the `io` it is given and returns an exit code. That keeps every
+ * command testable in-process.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/commands/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG","sourcesContent":["/**\n * The contract every `pwf` command implements.\n *\n * A command is a plain object registered in ./registry.ts. It never calls\n * `process.exit` and never writes to `process.stdout` directly: it writes\n * through the `io` it is given and returns an exit code. That keeps every\n * command testable in-process.\n */\n\nexport interface CommandIO {\n  /** Working directory the command runs in (absolute). */\n  readonly cwd: string\n  /** Normal output. */\n  out(line: string): void\n  /** Diagnostics and errors. */\n  err(line: string): void\n  /** Environment variables visible to the command. */\n  readonly env: Readonly<Record<string, string | undefined>>\n}\n\nexport interface ParsedArgs {\n  /** Positional arguments after the command name. */\n  readonly positionals: readonly string[]\n  /** `--flag value` and `--flag=value` become strings; bare `--flag` becomes true. */\n  readonly flags: Readonly<Record<string, string | boolean>>\n}\n\nexport interface Command {\n  /** The word after `pwf`, e.g. `create`. */\n  readonly name: string\n  /** One line shown by `pwf help`. */\n  readonly summary: string\n  /** Usage line, e.g. `pwf create <name> [--dir <path>]`. */\n  readonly usage: string\n  /** Runs the command. Resolves to the process exit code (0 = success). */\n  run(args: ParsedArgs, io: CommandIO): Promise<number>\n}\n"]}

package/dist/commands/validate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * `pwf validate [dir]` — checks a pwpack folder and its pinned packs.
+ */
+import type { Command, CommandIO, ParsedArgs } from './types.js';
+export declare function runValidate(args: ParsedArgs, io: CommandIO): Promise<number>;
+export declare const validate: Command;

package/dist/commands/validate.js

@@ -0,0 +1,33 @@
+import { boolFlag, guard } from './lib/flags.js';
+import { readProject, resolveFrom } from './lib/project.js';
+import { countLine, printIssues, validateProject } from './lib/report.js';
+export async function runValidate(args, io) {
+    const root = resolveFrom(io.cwd, args.positionals[0]);
+    const result = await validateProject(root, await readProject(root));
+    if (boolFlag(args, 'json')) {
+        io.out(JSON.stringify(result, null, 2));
+        return result.ok ? 0 : 1;
+    }
+    const who = result.identity ? `${result.identity.id}@${result.identity.version}` : root;
+    printIssues(io, result.issues);
+    const summary = `${who}: ${result.ok ? 'valid' : 'invalid'} (${countLine(result.issues)}; layout ${result.layout}; ${result.atoms.length} atoms)`;
+    if (result.ok)
+        io.out(summary);
+    else
+        io.err(summary);
+    return result.ok ? 0 : 1;
+}
+export const validate = {
+    name: 'validate',
+    summary: 'Check a pwpack folder and the packs it pins',
+    usage: `pwf validate [dir] [--json]
+
+  dir      the pwpack folder (default: the current folder)
+  --json   print the raw result (ok, issues, identity, layout, atoms)
+
+Every packs[] pin is looked up in .pwf/packs/<id>@<version>/: a build that is
+not there is a warning, one whose content hash differs from the pin is an
+error. Exit code 1 when there is any error, 0 otherwise.`,
+    run: (args, io) => guard('validate', io, () => runValidate(args, io)),
+};
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAEzE,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAgB,EAAE,EAAa;IAC/D,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAA;IACrD,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,CAAA;IACnE,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC;QAC3B,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACvC,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1B,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IACvF,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;IAC9B,MAAM,OAAO,GAAG,GAAG,GAAG,KAAK,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,SAAS,CAAA;IACjJ,IAAI,MAAM,CAAC,EAAE;QAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;;QACzB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACpB,OAAO,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAY;IAC/B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,6CAA6C;IACtD,KAAK,EAAE;;;;;;;yDAOgD;IACvD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;CACtE,CAAA","sourcesContent":["/**\n * `pwf validate [dir]` — checks a pwpack folder and its pinned packs.\n */\nimport type { Command, CommandIO, ParsedArgs } from './types.js'\nimport { boolFlag, guard } from './lib/flags.js'\nimport { readProject, resolveFrom } from './lib/project.js'\nimport { countLine, printIssues, validateProject } from './lib/report.js'\n\nexport async function runValidate(args: ParsedArgs, io: CommandIO): Promise<number> {\n  const root = resolveFrom(io.cwd, args.positionals[0])\n  const result = await validateProject(root, await readProject(root))\n  if (boolFlag(args, 'json')) {\n    io.out(JSON.stringify(result, null, 2))\n    return result.ok ? 0 : 1\n  }\n  const who = result.identity ? `${result.identity.id}@${result.identity.version}` : root\n  printIssues(io, result.issues)\n  const summary = `${who}: ${result.ok ? 'valid' : 'invalid'} (${countLine(result.issues)}; layout ${result.layout}; ${result.atoms.length} atoms)`\n  if (result.ok) io.out(summary)\n  else io.err(summary)\n  return result.ok ? 0 : 1\n}\n\nexport const validate: Command = {\n  name: 'validate',\n  summary: 'Check a pwpack folder and the packs it pins',\n  usage: `pwf validate [dir] [--json]\n\n  dir      the pwpack folder (default: the current folder)\n  --json   print the raw result (ok, issues, identity, layout, atoms)\n\nEvery packs[] pin is looked up in .pwf/packs/<id>@<version>/: a build that is\nnot there is a warning, one whose content hash differs from the pin is an\nerror. Exit code 1 when there is any error, 0 otherwise.`,\n  run: (args, io) => guard('validate', io, () => runValidate(args, io)),\n}\n"]}

package/dist/dev/assemble.d.ts

@@ -0,0 +1,47 @@
+import { type CompileCache, type CompiledAtom } from './compile.js';
+import { type AssembleDiagnostic } from './diagnostics.js';
+import { type RuntimeAssets } from './shell.js';
+import { type PackMemo } from './sources.js';
+export interface AssembleOptions {
+    /** Markup appended to the shell's `<body>` — the dev server's reload client. Absent in a build. */
+    readonly shellExtra?: string;
+    /** Envelope files a local host adds (see `LocalHost.envelopeEntries`). */
+    readonly envelopeEntries?: Readonly<Record<string, unknown>>;
+    /** A compile cache to reuse across builds; default: one on disk under `.pwf/build-cache/`. */
+    readonly cache?: CompileCache;
+    /** Folder of the on-disk compile cache; `null` keeps it in memory only. */
+    readonly cacheDir?: string | null;
+    /** `publish.json`'s `publishedAt`; default now. */
+    readonly publishedAt?: string;
+    /** Runner and renderer bundles; default: the installed engine packages. */
+    readonly runtime?: RuntimeAssets;
+    /** Pack builds read by an earlier build of the same session. */
+    readonly packMemo?: PackMemo;
+}
+export interface AssembleStats {
+    readonly pages: number;
+    /** Entries in `blocks/manifest.json`. */
+    readonly blocks: number;
+    /** Entries in `engines/manifest.json`. */
+    readonly engines: number;
+    /** Atoms of a compiled kind across the app and its packs. */
+    readonly atoms: number;
+    /** Of those, how many have a module (compiled or shipped precompiled). */
+    readonly compiled: number;
+    /** Of the compiled, how many came from the cache. */
+    readonly fromCache: number;
+    readonly failed: number;
+}
+export interface AssembleResult {
+    /** No diagnostic is an error. */
+    readonly ok: boolean;
+    /** The served folder: POSIX path → bytes. Filled as far as the build got, even when not `ok`. */
+    readonly files: Map<string, Uint8Array>;
+    readonly diagnostics: readonly AssembleDiagnostic[];
+    readonly stats: AssembleStats;
+    readonly ms: number;
+}
+/** Every name a block atom answers to in a receipt: its id, its manifest name, and its short forms. */
+export declare function blockNames(atom: Pick<CompiledAtom, 'id' | 'manifest'>): string[];
+/** Assembles the pwapp for the app folder at `root`. */
+export declare function assemblePwapp(root: string, options?: AssembleOptions): Promise<AssembleResult>;