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

package/dist/commands/create.js

@@ -0,0 +1,119 @@
+/**
+ * `pwf create <name>` — a new app folder standing on a foundation pack.
+ */
+import { mkdir, readdir, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, relative } from 'node:path';
+import { hashPack, packContent, validatePack } from '@pwfabric/pack';
+import { boolFlag, guard, stringFlag, UsageError } from './lib/flags.js';
+import { cacheDir, cacheRelDir, readPackSource, resolveFrom, writePackFolder, ATOMS_README } from './lib/project.js';
+import { caretRange, engineRange, engineVersion, formatIdentity, formatJson } from './lib/identity.js';
+import { printIssues } from './lib/report.js';
+import { ATOMS_README_TEXT, catalogOf, GITIGNORE_TEXT, starterAppearance, starterBlocks, starterNavigation, starterPlan, starterReceipt, starterTheme, titleOf, } from './lib/starter.js';
+/** Environment variable naming the foundation pack when `--foundation` is not given. */
+export const FOUNDATION_ENV = 'PWF_FOUNDATION';
+const NAME = /^[a-z0-9][a-z0-9-]*$/;
+const NO_FOUNDATION = [
+    'pwf create: no foundation pack given.',
+    'Every app stands on a foundation pack (its blocks, themes and shells). The',
+    'foundation pack is not published to a registry yet, so point pwf at a copy:',
+    '  pwf create <name> --foundation <folder or .pwpack>',
+    `or set ${FOUNDATION_ENV} to that path once for every create.`,
+];
+async function isNonEmptyDir(dir) {
+    const entries = await readdir(dir).catch(() => null);
+    return entries !== null && entries.length > 0;
+}
+export async function runCreate(args, io, options = {}) {
+    const name = args.positionals[0];
+    if (name === undefined)
+        throw new UsageError('missing <name>');
+    if (!NAME.test(name))
+        throw new UsageError(`"${name}" is not a valid name: use lower-case letters, digits and hyphens`);
+    const target = resolveFrom(io.cwd, stringFlag(args, 'dir') ?? name);
+    const force = boolFlag(args, 'force');
+    const foundationPath = stringFlag(args, 'foundation') ?? io.env[FOUNDATION_ENV];
+    if (!foundationPath) {
+        for (const line of NO_FOUNDATION)
+            io.err(line);
+        return 1;
+    }
+    if (!force && (await isNonEmptyDir(target))) {
+        io.err(`pwf create: ${target} is not empty; choose another --dir or pass --force to write into it`);
+        return 1;
+    }
+    const foundationAbs = resolveFrom(io.cwd, foundationPath);
+    const foundation = await readPackSource(foundationAbs);
+    const checked = validatePack(foundation);
+    if (!checked.ok || !checked.identity) {
+        io.err(`pwf create: the foundation pack at ${foundationAbs} is not valid`);
+        printIssues(io, checked.issues.filter((i) => i.severity === 'error'));
+        return 1;
+    }
+    const { id: foundationId, version: foundationVersion } = checked.identity;
+    const catalog = catalogOf(foundation, checked);
+    const title = titleOf(name);
+    const blocks = starterBlocks(catalog, title);
+    if (blocks.length === 0) {
+        io.err(`pwf create: ${foundationId}@${foundationVersion} has no heading, text or button block to start a page with`);
+        return 1;
+    }
+    const theme = starterTheme(catalog);
+    // What is cached and pinned is the pack content: a foundation read from its
+    // source folder brings its package.json, scripts and tests, none of which
+    // the app stands on.
+    const foundationContent = packContent(foundation);
+    const foundationHash = hashPack(foundationContent);
+    const identity = {
+        id: `@pwpack/local/${name}`,
+        version: '0.1.0',
+        formatVersion: '1.0',
+        engines: { pwfabric: engineRange(options.engineVersion ?? engineVersion()) },
+        requires: [{ id: foundationId, range: caretRange(foundationVersion) }],
+        license: { fork: true, redistribute: true },
+        app: { entry: 'home', surfaceOrder: ['home'] },
+        packs: [{ id: foundationId, version: foundationVersion, hash: foundationHash }],
+    };
+    const files = {
+        'pwpack.json': formatIdentity(identity),
+        'app/plan.json': formatJson(starterPlan(name, title, blocks, foundationId, theme)),
+        'app/definitions/appearance.json': formatJson(starterAppearance(theme)),
+        'app/definitions/navigation.json': formatJson(starterNavigation()),
+        'app/surfaces/home.receipt.json': formatJson(starterReceipt(blocks)),
+        [ATOMS_README]: ATOMS_README_TEXT,
+        '.gitignore': GITIGNORE_TEXT,
+    };
+    for (const [path, text] of Object.entries(files)) {
+        const abs = join(target, ...path.split('/'));
+        await mkdir(dirname(abs), { recursive: true });
+        await writeFile(abs, text);
+    }
+    await writePackFolder(cacheDir(target, foundationId, foundationVersion), foundationContent);
+    const rel = relative(io.cwd, target);
+    const shown = rel === '' ? '.' : rel.startsWith('..') || isAbsolute(rel) ? target : rel;
+    io.out(`Created ${identity.id} in ${target}`);
+    io.out(`  foundation ${foundationId}@${foundationVersion} (${foundationHash})`);
+    io.out(`  cached in  ${cacheRelDir(foundationId, foundationVersion)}`);
+    io.out(`  home page  ${blocks.map((b) => b.type).join(', ')}${theme ? `; theme ${theme}` : ''}`);
+    io.out('');
+    io.out('Next:');
+    io.out(`  cd ${shown}`);
+    io.out('  pwf dev        # serve it and rebuild on change');
+    io.out('  pwf validate   # check the folder');
+    io.out('  pwf pack       # write the .pwpack');
+    return 0;
+}
+export const create = {
+    name: 'create',
+    summary: 'Create a new app folder standing on a foundation pack',
+    usage: `pwf create <name> [--dir <path>] [--foundation <folder|.pwpack>] [--force]
+
+  <name>          lower-case letters, digits and hyphens; the app id is @pwpack/local/<name>
+  --dir <path>    where to write it (default ./<name>)
+  --foundation    the foundation pack to stand on (default: $${FOUNDATION_ENV})
+  --force         write into a folder that is not empty
+
+The foundation is copied into .pwf/packs/<id>@<version>/ and pinned in
+pwpack.json by content hash, so dev and run work offline.`,
+    run: (args, io) => guard('create', io, () => runCreate(args, io)),
+};
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/dev.d.ts

@@ -0,0 +1,13 @@
+import { type DevServerInternals } from '../dev/server.js';
+import type { Command, CommandIO, ParsedArgs } from './types.js';
+/** Resolves when the process is asked to stop (Ctrl+C or a termination signal). */
+export declare function untilInterrupted(): Promise<void>;
+export interface DevCommandOptions {
+    /** What keeps the server running; default {@link untilInterrupted}. */
+    readonly until?: () => Promise<void>;
+    /** Passed through to the server (tests turn watching off). */
+    readonly internals?: DevServerInternals;
+}
+export declare function runDev(args: ParsedArgs, io: CommandIO, options?: DevCommandOptions): Promise<number>;
+export declare const devCommand: Command;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAWA,OAAO,EAAgE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAExH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAEhE,mFAAmF;AACnF,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUhD;AAED,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAA;CACxC;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,SAAS,EAAE,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoE9G;AAED,eAAO,MAAM,UAAU,EAAE,OAexB,CAAA"}

package/dist/commands/dev.js

@@ -0,0 +1,107 @@
+/**
+ * `pwf dev [dir] [--port <n>] [--host <name>] [--local-host | --no-host]` —
+ * serves the app locally, rebuilds on every change and reloads the page. Runs
+ * until interrupted.
+ *
+ * This is where the dev server and the local host meet (ARCHITECTURE.md:
+ * `dev/` knows the host's interface only). The host is mounted under
+ * `/_host` when the app declares sign-in or records, or when `--local-host`
+ * asks for it; `--no-host` serves the pages alone.
+ */
+import { resolve } from 'node:path';
+import { createDevServer, DEFAULT_HOSTNAME, DEFAULT_PORT, HOST_PREFIX } from '../dev/server.js';
+import { createLocalHost } from '../host/local-host.js';
+/** Resolves when the process is asked to stop (Ctrl+C or a termination signal). */
+export function untilInterrupted() {
+    return new Promise((done) => {
+        const stop = () => {
+            process.off('SIGINT', stop);
+            process.off('SIGTERM', stop);
+            done();
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+}
+export async function runDev(args, io, options = {}) {
+    const portFlag = args.flags['port'];
+    let port = DEFAULT_PORT;
+    if (portFlag !== undefined) {
+        const n = typeof portFlag === 'string' ? Number(portFlag) : NaN;
+        if (!Number.isInteger(n) || n < 0 || n > 65535) {
+            io.err('pwf dev: --port needs a number from 0 to 65535');
+            return 2;
+        }
+        port = n;
+    }
+    const hostFlag = args.flags['host'];
+    if (hostFlag === true || hostFlag === '') {
+        io.err('pwf dev: --host needs an interface name or address');
+        return 2;
+    }
+    const hostname = typeof hostFlag === 'string' ? hostFlag : DEFAULT_HOSTNAME;
+    // A switch followed by the folder (`pwf dev --no-host ./app`) is read by the
+    // argument parser as the switch's value; take it back as the folder.
+    let dirArg = args.positionals[0];
+    const extra = [];
+    const switchOn = (name) => {
+        const v = args.flags[name];
+        if (v === undefined || v === false || v === 'false')
+            return false;
+        if (typeof v === 'string' && v !== 'true') {
+            if (dirArg === undefined)
+                dirArg = v;
+            else
+                extra.push(v);
+        }
+        return true;
+    };
+    const forceHost = switchOn('local-host');
+    const noHost = switchOn('no-host');
+    if (extra.length > 0) {
+        io.err(`pwf dev: unexpected argument ${extra.map((e) => `"${e}"`).join(', ')}; pwf dev serves one folder`);
+        return 2;
+    }
+    if (forceHost && noHost) {
+        io.err('pwf dev: --local-host and --no-host contradict each other; pass one');
+        return 2;
+    }
+    const root = resolve(io.cwd, dirArg ?? '.');
+    // Undefined lets the server decide from the app's declarations.
+    const localHost = noHost ? false : forceHost ? true : undefined;
+    const internals = { createHost: createLocalHost, ...options.internals };
+    let server;
+    try {
+        server = await createDevServer({ root, port, hostname, log: io.out, ...(localHost !== undefined ? { localHost } : {}) }, internals);
+    }
+    catch (e) {
+        const err = e;
+        io.err(err.code === 'EADDRINUSE'
+            ? `pwf dev: port ${port} is in use; pass --port <n> (or --port 0 for any free port)`
+            : `pwf dev: ${err.message}`);
+        return 1;
+    }
+    io.out(`pwf dev: serving ${root} at ${server.url}`);
+    io.out('press Ctrl+C to stop');
+    await (options.until ?? untilInterrupted)();
+    await server.close();
+    io.out('pwf dev: stopped');
+    return 0;
+}
+export const devCommand = {
+    name: 'dev',
+    summary: 'Serve the app locally and reload it on every change',
+    usage: `pwf dev [dir] [--port <n>] [--host <name>] [--local-host | --no-host]
+
+  dir            the app folder (default: the current folder)
+  --port <n>     port to listen on (default ${DEFAULT_PORT}; 0 picks a free one)
+  --host <name>  interface to bind (default ${DEFAULT_HOSTNAME})
+  --local-host   mount the local host for sign-in and data even when the app declares neither
+  --no-host      do not mount the local host, even when the app declares sign-in or records
+
+The local host (under ${HOST_PREFIX}) is for development only: records live in
+memory and are seeded from app/data/, the one development user signs in
+with any password, and nothing survives a restart.`,
+    run: (args, io) => runDev(args, io),
+};
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/lib/flags.d.ts

@@ -0,0 +1,11 @@
+import type { CommandIO, ParsedArgs } from '../types.js';
+/** Thrown for a malformed invocation; commands turn it into exit code 2. */
+export declare class UsageError extends Error {
+}
+/** A flag that takes a value: absent → undefined, bare `--flag` → UsageError. */
+export declare function stringFlag(args: ParsedArgs, name: string): string | undefined;
+/** A switch: present (bare or with any value but "false") → true. */
+export declare function boolFlag(args: ParsedArgs, name: string): boolean;
+/** Runs a command body, turning usage errors into exit 2 and other failures into exit 1. */
+export declare function guard(name: string, io: CommandIO, body: () => Promise<number>): Promise<number>;
+//# sourceMappingURL=flags.d.ts.map

package/dist/commands/lib/flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.d.ts","sourceRoot":"","sources":["../../../src/commands/lib/flags.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAExD,4EAA4E;AAC5E,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7E;AAED,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,4FAA4F;AAC5F,wBAAsB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrG"}

package/dist/commands/lib/flags.js

@@ -0,0 +1,33 @@
+/** Thrown for a malformed invocation; commands turn it into exit code 2. */
+export class UsageError extends Error {
+}
+/** A flag that takes a value: absent → undefined, bare `--flag` → UsageError. */
+export function stringFlag(args, name) {
+    const v = args.flags[name];
+    if (v === undefined)
+        return undefined;
+    if (v === true || v === '')
+        throw new UsageError(`--${name} needs a value`);
+    return v;
+}
+/** A switch: present (bare or with any value but "false") → true. */
+export function boolFlag(args, name) {
+    const v = args.flags[name];
+    return v !== undefined && v !== false && v !== 'false';
+}
+/** Runs a command body, turning usage errors into exit 2 and other failures into exit 1. */
+export async function guard(name, io, body) {
+    try {
+        return await body();
+    }
+    catch (e) {
+        if (e instanceof UsageError) {
+            io.err(`pwf ${name}: ${e.message}`);
+            io.err(`Run \`pwf ${name} --help\` for usage.`);
+            return 2;
+        }
+        io.err(`pwf ${name}: ${e.message}`);
+        return 1;
+    }
+}
+//# sourceMappingURL=flags.js.map

package/dist/commands/lib/flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flags.js","sourceRoot":"","sources":["../../../src/commands/lib/flags.ts"],"names":[],"mappings":"AAEA,4EAA4E;AAC5E,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG;AAExC,iFAAiF;AACjF,MAAM,UAAU,UAAU,CAAC,IAAgB,EAAE,IAAY;IACvD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACrC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,KAAK,IAAI,gBAAgB,CAAC,CAAA;IAC3E,OAAO,CAAW,CAAA;AACpB,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,QAAQ,CAAC,IAAgB,EAAE,IAAY;IACrD,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC1B,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,OAAO,CAAA;AACxD,CAAC;AAED,4FAA4F;AAC5F,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,IAAY,EAAE,EAAa,EAAE,IAA2B;IAClF,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,EAAE,CAAA;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,CAAC,YAAY,UAAU,EAAE,CAAC;YAC5B,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;YACnC,EAAE,CAAC,GAAG,CAAC,aAAa,IAAI,sBAAsB,CAAC,CAAA;YAC/C,OAAO,CAAC,CAAA;QACV,CAAC;QACD,EAAE,CAAC,GAAG,CAAC,OAAO,IAAI,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAA;QAC9C,OAAO,CAAC,CAAA;IACV,CAAC;AACH,CAAC"}

package/dist/commands/lib/identity.d.ts

@@ -0,0 +1,39 @@
+/** The order `pwpack.json` members are written in. Members not listed follow, in their original order. */
+export declare const IDENTITY_KEY_ORDER: readonly ["id", "version", "formatVersion", "engines", "requires", "license", "app", "packs"];
+export declare const IDENTITY_FILE = "pwpack.json";
+export type IdentityJson = Record<string, unknown>;
+export interface PackPin {
+    readonly id: string;
+    readonly version: string;
+    readonly hash: string;
+}
+/** A copy of `doc` with its members in {@link IDENTITY_KEY_ORDER}. */
+export declare function orderIdentity(doc: IdentityJson): IdentityJson;
+/** The JSON text of `pwpack.json`: ordered members, two-space indent, trailing newline. */
+export declare function formatIdentity(doc: IdentityJson): string;
+/** Two-space JSON with a trailing newline, the format of every file the commands write. */
+export declare function formatJson(value: unknown): string;
+export declare function readIdentityFile(root: string): Promise<IdentityJson>;
+export declare function writeIdentityFile(root: string, doc: IdentityJson): Promise<void>;
+/** `^<major>.0.0` for a semver version — the range a requirement on that build declares. */
+export declare function caretRange(version: string): string;
+/** Adds the pin, or replaces the pin with the same id. Order of the others is kept. */
+export declare function upsertPin(doc: IdentityJson, pin: PackPin): void;
+/** Adds `{ id, range }` to `requires`, or updates the entry (object or bare name) for that id. */
+export declare function upsertRequirement(doc: IdentityJson, id: string, range: string): void;
+/** Pins listed in a parsed `pwpack.json`. */
+export declare function pinsOf(doc: {
+    readonly packs?: readonly PackPin[];
+} | null): readonly PackPin[];
+/**
+ * Finds `node_modules/<name>/package.json` the way Node resolves a bare
+ * import, walking up from `fromDir`. Returns null when it is not installed.
+ */
+export declare function findPackageJson(name: string, fromDir: string): string | null;
+/** The engine version this command line runs with: the contracts package's version. */
+export declare function engineVersion(fromDir?: string): string;
+/** `>=<major>.<minor> <<major+1>`: this engine's release and every later one before the next major. */
+export declare function engineRange(version: string): string;
+/** Text without a leading byte-order mark. */
+export declare function stripBom(text: string): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/commands/lib/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/commands/lib/identity.ts"],"names":[],"mappings":"AASA,0GAA0G;AAC1G,eAAO,MAAM,kBAAkB,+FAAgG,CAAA;AAE/H,eAAO,MAAM,aAAa,gBAAgB,CAAA;AAE1C,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAK7D;AAED,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAExD;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEjD;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAW1E;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED,4FAA4F;AAC5F,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAO/D;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOpF;AAED,6CAA6C;AAC7C,wBAAgB,MAAM,CAAC,GAAG,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,OAAO,EAAE,CAE9F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS5E;AAID,uFAAuF;AACvF,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAgD,GAAG,MAAM,CAM/F;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,8CAA8C;AAC9C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7C"}

package/dist/commands/lib/identity.js

@@ -0,0 +1,120 @@
+/**
+ * Reading and writing a project's `pwpack.json`: stable key order, pins and
+ * requirements, and the engine range a new project declares.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/** The order `pwpack.json` members are written in. Members not listed follow, in their original order. */
+export const IDENTITY_KEY_ORDER = ['id', 'version', 'formatVersion', 'engines', 'requires', 'license', 'app', 'packs'];
+export const IDENTITY_FILE = 'pwpack.json';
+/** A copy of `doc` with its members in {@link IDENTITY_KEY_ORDER}. */
+export function orderIdentity(doc) {
+    const out = {};
+    for (const key of IDENTITY_KEY_ORDER)
+        if (doc[key] !== undefined)
+            out[key] = doc[key];
+    for (const [key, value] of Object.entries(doc))
+        if (!(key in out) && value !== undefined)
+            out[key] = value;
+    return out;
+}
+/** The JSON text of `pwpack.json`: ordered members, two-space indent, trailing newline. */
+export function formatIdentity(doc) {
+    return `${JSON.stringify(orderIdentity(doc), null, 2)}\n`;
+}
+/** Two-space JSON with a trailing newline, the format of every file the commands write. */
+export function formatJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+export async function readIdentityFile(root) {
+    const text = await readFile(join(root, IDENTITY_FILE), 'utf8').catch(() => null);
+    if (text === null)
+        throw new Error(`${join(root, IDENTITY_FILE)} not found; run this inside a pwpack folder or pass --dir`);
+    let value;
+    try {
+        value = JSON.parse(stripBom(text));
+    }
+    catch (e) {
+        throw new Error(`${IDENTITY_FILE} is not JSON: ${e.message}`);
+    }
+    if (value === null || typeof value !== 'object' || Array.isArray(value))
+        throw new Error(`${IDENTITY_FILE} is not a JSON object`);
+    return value;
+}
+export async function writeIdentityFile(root, doc) {
+    await writeFile(join(root, IDENTITY_FILE), formatIdentity(doc));
+}
+/** `^<major>.0.0` for a semver version — the range a requirement on that build declares. */
+export function caretRange(version) {
+    const major = /^(\d+)\./.exec(version)?.[1];
+    if (major === undefined)
+        throw new Error(`"${version}" is not a semver version`);
+    return `^${major}.0.0`;
+}
+/** Adds the pin, or replaces the pin with the same id. Order of the others is kept. */
+export function upsertPin(doc, pin) {
+    const pins = Array.isArray(doc.packs) ? [...doc.packs] : [];
+    const entry = { id: pin.id, version: pin.version, hash: pin.hash };
+    const at = pins.findIndex((p) => p !== null && typeof p === 'object' && p.id === pin.id);
+    if (at >= 0)
+        pins[at] = entry;
+    else
+        pins.push(entry);
+    doc.packs = pins;
+}
+/** Adds `{ id, range }` to `requires`, or updates the entry (object or bare name) for that id. */
+export function upsertRequirement(doc, id, range) {
+    const list = Array.isArray(doc.requires) ? [...doc.requires] : [];
+    const at = list.findIndex((r) => r === id || (r !== null && typeof r === 'object' && r.id === id));
+    const entry = { id, range };
+    if (at >= 0)
+        list[at] = entry;
+    else
+        list.push(entry);
+    doc.requires = list;
+}
+/** Pins listed in a parsed `pwpack.json`. */
+export function pinsOf(doc) {
+    return doc?.packs ?? [];
+}
+/**
+ * Finds `node_modules/<name>/package.json` the way Node resolves a bare
+ * import, walking up from `fromDir`. Returns null when it is not installed.
+ */
+export function findPackageJson(name, fromDir) {
+    let dir = fromDir;
+    for (;;) {
+        const candidate = join(dir, 'node_modules', ...name.split('/'), 'package.json');
+        if (existsSync(candidate))
+            return candidate;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+const CONTRACTS_PACKAGE = '@pwfabric/contracts';
+/** The engine version this command line runs with: the contracts package's version. */
+export function engineVersion(fromDir = dirname(fileURLToPath(import.meta.url))) {
+    const path = findPackageJson(CONTRACTS_PACKAGE, fromDir);
+    if (!path)
+        throw new Error(`cannot find ${CONTRACTS_PACKAGE}; reinstall pwf`);
+    const { version } = JSON.parse(readFileSync(path, 'utf8'));
+    if (typeof version !== 'string')
+        throw new Error(`${path} has no version`);
+    return version;
+}
+/** `>=<major>.<minor> <<major+1>`: this engine's release and every later one before the next major. */
+export function engineRange(version) {
+    const m = /^(\d+)\.(\d+)\./.exec(version);
+    if (!m)
+        throw new Error(`engine version "${version}" is not semver`);
+    return `>=${m[1]}.${m[2]} <${Number(m[1]) + 1}`;
+}
+/** Text without a leading byte-order mark. */
+export function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+//# sourceMappingURL=identity.js.map

package/dist/commands/lib/identity.js.map

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

package/dist/commands/lib/project.d.ts

@@ -0,0 +1,35 @@
+import { type PackFolder } from '@pwfabric/pack';
+/** The project-local working directory (pack cache, build output of other commands). */
+export declare const PWF_DIR = ".pwf";
+/** Installed pack builds, one folder per `<id>@<version>`. */
+export declare const PACK_CACHE_DIR = ".pwf/packs";
+/** The note `create` writes into `atoms/`. Pack content (documentation, `DOC_FILE`), so it travels with the pack. */
+export declare const ATOMS_README = "atoms/README.md";
+/** Names skipped at any depth when a project is read: the defaults plus the cache and VCS ignore file. */
+export declare const PROJECT_IGNORED_NAMES: ReadonlySet<string>;
+/**
+ * Reads a project folder into memory, without the cache. The author's tooling
+ * (`package.json`, `scripts/`, …) is still in it — validation reports on it;
+ * `packContent` is what is packed, installed and hashed.
+ */
+export declare function readProject(dir: string): Promise<PackFolder>;
+/**
+ * Opens a pack source: a folder (read like a project, so its own `.pwf/`
+ * cache never travels) or a `.pwpack` / `.tgz` archive.
+ */
+export declare function readPackSource(path: string): Promise<PackFolder>;
+/**
+ * Relative folder of one pack build in the cache: `.pwf/packs/<id>@<version>`.
+ * A scoped id (`@pwpack/acme/cards`) nests the way npm scopes do. Throws when
+ * the id or version could escape the cache.
+ */
+export declare function cacheRelDir(id: string, version: string): string;
+/** Absolute folder of one pack build in a project's cache. */
+export declare function cacheDir(root: string, id: string, version: string): string;
+/** Reads a cached pack build exactly as it was written: nothing is skipped. */
+export declare function readCachedPack(dir: string): Promise<PackFolder>;
+/** Writes a pack folder to disk, replacing whatever was there. */
+export declare function writePackFolder(dir: string, pack: PackFolder): Promise<void>;
+/** Resolves a user-given path against the command's working directory. */
+export declare function resolveFrom(cwd: string, path: string | undefined): string;
+//# sourceMappingURL=project.d.ts.map

package/dist/commands/lib/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/commands/lib/project.ts"],"names":[],"mappings":"AAYA,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,gBAAgB,CAAA;AAEvB,wFAAwF;AACxF,eAAO,MAAM,OAAO,SAAS,CAAA;AAC7B,8DAA8D;AAC9D,eAAO,MAAM,cAAc,eAAqB,CAAA;AAChD,qHAAqH;AACrH,eAAO,MAAM,YAAY,oBAAoB,CAAA;AAE7C,0GAA0G;AAC1G,eAAO,MAAM,qBAAqB,EAAE,WAAW,CAAC,MAAM,CAA8D,CAAA;AAEpH;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAKlE;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAKtE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1E;AAED,+EAA+E;AAC/E,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAErE;AAED,kEAAkE;AAClE,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEzE"}

package/dist/commands/lib/project.js

@@ -0,0 +1,78 @@
+/**
+ * The project folder as the commands see it: which files belong to the pack,
+ * where the local pack cache lives, and how a pack source (folder or archive)
+ * is opened.
+ *
+ * A project is a pwpack folder plus things that are never packed: the `.pwf/`
+ * cache (installed pack builds), the `.gitignore` next to it, and anything
+ * else outside the pack content (`packContent`: `pwpack.json`, `LICENSE`,
+ * `NOTICE`, `README.md`, `app/`, `atoms/`, `media/`).
+ */
+import { mkdir, readFile, rm, stat, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { DEFAULT_IGNORED_NAMES, isSafePackPath, readFolder, readPwpack, } from '@pwfabric/pack';
+/** The project-local working directory (pack cache, build output of other commands). */
+export const PWF_DIR = '.pwf';
+/** Installed pack builds, one folder per `<id>@<version>`. */
+export const PACK_CACHE_DIR = `${PWF_DIR}/packs`;
+/** The note `create` writes into `atoms/`. Pack content (documentation, `DOC_FILE`), so it travels with the pack. */
+export const ATOMS_README = 'atoms/README.md';
+/** Names skipped at any depth when a project is read: the defaults plus the cache and VCS ignore file. */
+export const PROJECT_IGNORED_NAMES = new Set([...DEFAULT_IGNORED_NAMES, PWF_DIR, '.gitignore']);
+/**
+ * Reads a project folder into memory, without the cache. The author's tooling
+ * (`package.json`, `scripts/`, …) is still in it — validation reports on it;
+ * `packContent` is what is packed, installed and hashed.
+ */
+export async function readProject(dir) {
+    const read = await readFolder(dir, { ignore: PROJECT_IGNORED_NAMES });
+    // A dot entry at the root (`.editorconfig`, `.vscode/`, …) is never pack
+    // content; it is the author's environment and is not reported on.
+    return { files: new Map([...read.files].filter(([path]) => !path.startsWith('.'))) };
+}
+/**
+ * Opens a pack source: a folder (read like a project, so its own `.pwf/`
+ * cache never travels) or a `.pwpack` / `.tgz` archive.
+ */
+export async function readPackSource(path) {
+    const st = await stat(path).catch(() => null);
+    if (!st)
+        throw new Error(`no such file or folder: ${path}`);
+    if (st.isDirectory())
+        return readProject(path);
+    return readPwpack(new Uint8Array(await readFile(path)));
+}
+/**
+ * Relative folder of one pack build in the cache: `.pwf/packs/<id>@<version>`.
+ * A scoped id (`@pwpack/acme/cards`) nests the way npm scopes do. Throws when
+ * the id or version could escape the cache.
+ */
+export function cacheRelDir(id, version) {
+    const rel = `${id}@${version}`;
+    if (!isSafePackPath(rel) || /[<>:"|?*]/.test(rel))
+        throw new Error(`pack id "${id}" with version "${version}" is not usable as a cache folder name`);
+    return `${PACK_CACHE_DIR}/${rel}`;
+}
+/** Absolute folder of one pack build in a project's cache. */
+export function cacheDir(root, id, version) {
+    return join(root, ...cacheRelDir(id, version).split('/'));
+}
+/** Reads a cached pack build exactly as it was written: nothing is skipped. */
+export async function readCachedPack(dir) {
+    return readFolder(dir, { ignore: new Set() });
+}
+/** Writes a pack folder to disk, replacing whatever was there. */
+export async function writePackFolder(dir, pack) {
+    await rm(dir, { recursive: true, force: true });
+    await mkdir(dir, { recursive: true });
+    for (const [path, bytes] of pack.files) {
+        const target = join(dir, ...path.split('/'));
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, bytes);
+    }
+}
+/** Resolves a user-given path against the command's working directory. */
+export function resolveFrom(cwd, path) {
+    return resolve(cwd, path ?? '.');
+}
+//# sourceMappingURL=project.js.map

package/dist/commands/lib/project.js.map

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