staticforge 0.0.0-stage → 0.1.0

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { run } from './main.js';
+process.exitCode = await run(process.argv);
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/browser.d.ts

@@ -0,0 +1,3 @@
+/** Open a URL in the default browser; failures are ignored (e.g. headless machines). */
+export declare function openBrowser(url: string): void;
+//# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAc7C"}

package/dist/browser.js

@@ -0,0 +1,18 @@
+import { spawn } from 'node:child_process';
+/** Open a URL in the default browser; failures are ignored (e.g. headless machines). */
+export function openBrowser(url) {
+    const [command, args] = process.platform === 'darwin'
+        ? ['open', [url]]
+        : process.platform === 'win32'
+            ? ['cmd', ['/c', 'start', '""', url]]
+            : ['xdg-open', [url]];
+    try {
+        spawn(command, args, { stdio: 'ignore', detached: true })
+            .on('error', () => { })
+            .unref();
+    }
+    catch {
+        // No browser available.
+    }
+}
+//# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,GACnB,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC3B,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;QACjB,CAAC,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO;YAC5B,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC;QACH,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;aACtD,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC;aACrB,KAAK,EAAE,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACP,wBAAwB;IAC1B,CAAC;AACH,CAAC"}

package/dist/cloud.d.ts

@@ -0,0 +1,31 @@
+import { type LoadedConfig, type TargetConfig } from '@staticforge/core';
+import { type Confirm, type IacRunOptions, type PlanSummary } from '@staticforge/iac';
+import type { Deployer, Provider } from '@staticforge/provider-api';
+import type { Runtime } from './command.js';
+import type { CommandContext } from './context.js';
+/**
+ * The provider of a target; tests inject fakes through the runtime. Providers
+ * are loaded on demand: their cloud SDKs would slow down every other command.
+ */
+export declare function providerFor(runtime: Runtime, target: TargetConfig): Promise<Provider>;
+export interface TargetContext {
+    loaded: LoadedConfig;
+    targetName: string;
+    target: TargetConfig;
+    provider: Provider;
+    iac: IacRunOptions;
+}
+export declare function targetContext(runtime: Runtime, ctx: CommandContext, loaded: LoadedConfig, targetName: string, localState?: boolean): Promise<TargetContext>;
+/** The target's deployer, with its infrastructure outputs (cached, or read from state). */
+export declare function deployerFor(ctx: CommandContext, target: TargetContext): Promise<Deployer>;
+/** Human summary of a plan: one line per resource plus the totals. */
+export declare function formatPlan(plan: PlanSummary): string;
+/**
+ * The confirmation for a change: none with --yes, a prompt when interactive,
+ * otherwise SF_CONFIRMATION_REQUIRED (CI never applies by accident).
+ */
+export declare function confirmer(ctx: CommandContext, yes: boolean, flag?: string): Confirm | undefined;
+/** Ask a yes/no question without a plan (rollback, preview removal). */
+export declare function confirmAction(ctx: CommandContext, yes: boolean, question: string): Promise<void>;
+export declare const truthy: (value: string | undefined) => boolean;
+//# sourceMappingURL=cloud.d.ts.map

package/dist/cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud.d.ts","sourceRoot":"","sources":["../src/cloud.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EAIlB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,WAAW,EAEjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,QAAQ,CAAC,CAM3F;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,aAAa,CAAC;CACpB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,cAAc,EACnB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,UAAU,UAAQ,GACjB,OAAO,CAAC,aAAa,CAAC,CAkBxB;AAED,2FAA2F;AAC3F,wBAAsB,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAY/F;AAYD,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAYpD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,SAAU,GAAG,OAAO,GAAG,SAAS,CAiBhG;AAED,wEAAwE;AACxE,wBAAsB,aAAa,CACjC,GAAG,EAAE,cAAc,EACnB,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAef;AAED,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,OACwB,CAAC"}

package/dist/cloud.js

@@ -0,0 +1,102 @@
+import { ErrorCode, SforgeError, getTarget, } from '@staticforge/core';
+import { targetOutputs, } from '@staticforge/iac';
+import { loadProjectConfigAt } from './project.js';
+/**
+ * The provider of a target; tests inject fakes through the runtime. Providers
+ * are loaded on demand: their cloud SDKs would slow down every other command.
+ */
+export async function providerFor(runtime, target) {
+    const injected = runtime.providers?.[target.provider];
+    if (injected !== undefined)
+        return injected;
+    return target.provider === 'aws'
+        ? (await import('@staticforge/aws')).createAwsProvider()
+        : (await import('@staticforge/azure')).createAzureProvider();
+}
+export async function targetContext(runtime, ctx, loaded, targetName, localState = false) {
+    const target = getTarget(loaded.config, targetName);
+    const provider = await providerFor(runtime, target);
+    return {
+        loaded,
+        targetName,
+        target,
+        provider,
+        iac: {
+            rootDir: loaded.rootDir,
+            config: loaded.config,
+            targetName,
+            profile: provider.iac,
+            env: ctx.io.env,
+            logger: ctx.logger,
+            localState,
+        },
+    };
+}
+/** The target's deployer, with its infrastructure outputs (cached, or read from state). */
+export async function deployerFor(ctx, target) {
+    const outputs = await targetOutputs(target.iac);
+    return target.provider.createDeployer({
+        rootDir: target.loaded.rootDir,
+        config: target.loaded.config,
+        targetName: target.targetName,
+        target: target.target,
+        outputs,
+        env: ctx.io.env,
+        logger: ctx.logger,
+        loadConfig: (dir) => loadProjectConfigAt(dir),
+    });
+}
+const SYMBOLS = {
+    create: '+',
+    update: '~',
+    delete: '-',
+    replace: '-/+',
+    read: '<=',
+    move: '->',
+    noop: ' ',
+};
+/** Human summary of a plan: one line per resource plus the totals. */
+export function formatPlan(plan) {
+    const lines = plan.resources.map((r) => `  ${SYMBOLS[r.action] ?? '?'} ${r.address} (${r.action})`);
+    for (const d of plan.drift)
+        lines.push(`  ! ${d.address} changed outside OpenTofu/Terraform (${d.action})`);
+    lines.push(plan.changes
+        ? `Plan: ${plan.add} to add, ${plan.change} to change, ${plan.remove} to destroy.`
+        : 'No changes. The infrastructure matches the configuration.');
+    return lines.join('\n');
+}
+/**
+ * The confirmation for a change: none with --yes, a prompt when interactive,
+ * otherwise SF_CONFIRMATION_REQUIRED (CI never applies by accident).
+ */
+export function confirmer(ctx, yes, flag = '--yes') {
+    if (yes)
+        return undefined;
+    return async (question, plan) => {
+        if (!ctx.interactive) {
+            throw new SforgeError(ErrorCode.ConfirmationRequired, `${question.replace(/\?$/, '')}: confirmation required`, {
+                details: { plan },
+                hint: `Pass ${flag} to confirm in non-interactive runs (CI, --json, no TTY).`,
+            });
+        }
+        ctx.io.stderr.write(`${formatPlan(plan)}\n`);
+        const answer = await ctx.io.prompt(`${question} Type "yes" to continue: `);
+        return answer.trim().toLowerCase() === 'yes';
+    };
+}
+/** Ask a yes/no question without a plan (rollback, preview removal). */
+export async function confirmAction(ctx, yes, question) {
+    if (yes)
+        return;
+    if (!ctx.interactive) {
+        throw new SforgeError(ErrorCode.ConfirmationRequired, `${question.replace(/\?$/, '')}: confirmation required`, {
+            hint: 'Pass --yes to confirm in non-interactive runs (CI, --json, no TTY).',
+        });
+    }
+    const answer = await ctx.io.prompt(`${question} Type "yes" to continue: `);
+    if (answer.trim().toLowerCase() !== 'yes') {
+        throw new SforgeError(ErrorCode.Aborted, 'Cancelled; nothing was changed');
+    }
+}
+export const truthy = (value) => value !== undefined && value !== '' && value !== 'false' && value !== '0';
+//# sourceMappingURL=cloud.js.map

package/dist/cloud.js.map

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

package/dist/command.d.ts

@@ -0,0 +1,54 @@
+import type { Command } from 'commander';
+import { ExitCode } from '@staticforge/core';
+import type { Provider } from '@staticforge/provider-api';
+import { type CommandContext } from './context.js';
+import type { Io } from './io.js';
+import { type Envelope } from './output.js';
+/** Mutable state shared by all commands of one CLI invocation. */
+export interface Runtime {
+    io: Io;
+    exitCode: ExitCode;
+    /** Cloud providers to use instead of the real ones (tests). */
+    providers?: Partial<Record<Provider['id'], Provider>>;
+    /**
+     * Receives every command's outcome, in --json mode or not, before a
+     * long-running command starts waiting (in-process callers: the MCP server).
+     */
+    onResult?(outcome: Outcome): void;
+}
+export interface Outcome {
+    envelope: Envelope;
+    /** The human-readable rendering, when the command has one. */
+    text?: string;
+    /** The current data of a long-running command (e.g. the dev server's latest build). */
+    live?: () => unknown;
+}
+export interface CommandResult<T> {
+    data: T;
+    /** Defaults to true. False marks a completed run that found failures (exit code 1). */
+    ok?: boolean;
+    /** Human-readable rendering written to stdout when not in --json mode. */
+    text?: string;
+    /**
+     * For long-running commands (servers): the result is written as soon as the
+     * command is ready, then the process stays up until this settles.
+     */
+    wait?: Promise<void>;
+    /** For long-running commands: the current `data`, for {@link Runtime.onResult}. */
+    live?: () => T;
+}
+export interface ActionInput {
+    /** Positional arguments in declaration order. */
+    args: unknown[];
+    /** The command's own (non-global) options. */
+    options: Record<string, unknown>;
+}
+export type Handler<T> = (ctx: CommandContext, input: ActionInput) => Promise<CommandResult<T>>;
+/** "config validate" for `sforge config validate`. */
+export declare function commandPath(command: Command): string;
+/**
+ * Adapt a handler to a commander action: builds the context, renders the result
+ * (text or JSON envelope) and maps errors to stable codes and exit codes.
+ */
+export declare function action<T>(runtime: Runtime, handler: Handler<T>): (...raw: unknown[]) => Promise<void>;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAA4B,MAAM,mBAAmB,CAAC;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,QAAQ,EAAyB,MAAM,aAAa,CAAC;AAEnE,kEAAkE;AAClE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,EAAE,CAAC;IACP,QAAQ,EAAE,QAAQ,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD;;;OAGG;IACH,QAAQ,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,OAAO;IACtB,QAAQ,EAAE,QAAQ,CAAC;IACnB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC;IACR,uFAAuF;IACvF,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;AAEhG,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAIpD;AAMD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,IAC/C,GAAG,KAAK,OAAO,EAAE,KAAG,OAAO,CAAC,IAAI,CAAC,CA+ChD"}

package/dist/command.js

@@ -0,0 +1,70 @@
+import { ExitCode, ErrorCode, toSforgeError } from '@staticforge/core';
+import { createContext } from './context.js';
+import { OUTPUT_SCHEMA_VERSION } from './output.js';
+/** "config validate" for `sforge config validate`. */
+export function commandPath(command) {
+    const names = [];
+    for (let c = command; c?.parent; c = c.parent)
+        names.unshift(c.name());
+    return names.join(' ');
+}
+function writeEnvelope(io, envelope) {
+    io.stdout.write(`${JSON.stringify(envelope, null, 2)}\n`);
+}
+/**
+ * Adapt a handler to a commander action: builds the context, renders the result
+ * (text or JSON envelope) and maps errors to stable codes and exit codes.
+ */
+export function action(runtime, handler) {
+    return async (...raw) => {
+        const command = raw.at(-1);
+        const ctx = createContext(command, runtime.io);
+        const name = commandPath(command);
+        try {
+            const result = await handler(ctx, { args: raw.slice(0, -2), options: command.opts() });
+            const ok = result.ok ?? true;
+            const envelope = {
+                schemaVersion: OUTPUT_SCHEMA_VERSION,
+                command: name,
+                ok,
+                data: result.data,
+            };
+            runtime.onResult?.({
+                envelope,
+                ...(result.text !== undefined && { text: result.text }),
+                ...(result.live && { live: result.live }),
+            });
+            if (ctx.json) {
+                writeEnvelope(runtime.io, envelope);
+            }
+            else if (result.text !== undefined) {
+                runtime.io.stdout.write(result.text.endsWith('\n') ? result.text : `${result.text}\n`);
+            }
+            runtime.exitCode = ok ? ExitCode.Ok : ExitCode.Failure;
+            await result.wait;
+        }
+        catch (thrown) {
+            const error = toSforgeError(thrown);
+            const envelope = {
+                schemaVersion: OUTPUT_SCHEMA_VERSION,
+                command: name,
+                ok: false,
+                error: error.toJSON(),
+            };
+            runtime.onResult?.({ envelope });
+            if (ctx.json) {
+                writeEnvelope(runtime.io, envelope);
+            }
+            else {
+                ctx.logger.error(error.message);
+                if (error.hint !== undefined)
+                    ctx.logger.info(`hint: ${error.hint}`);
+            }
+            if (error.code === ErrorCode.Internal && thrown instanceof Error && thrown.stack) {
+                ctx.logger.debug(thrown.stack);
+            }
+            runtime.exitCode = error.exitCode;
+        }
+    };
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

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

package/dist/commands/build.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import { type Runtime } from '../command.js';
+export declare function registerBuildCommand(program: Command, runtime: Runtime): void;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAMrD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAiD7E"}

package/dist/commands/build.js

@@ -0,0 +1,54 @@
+import { formatDiagnostic } from '@staticforge/core';
+import { action } from '../command.js';
+import { displayPath } from '../paths.js';
+import { loadProjectConfig } from '../project.js';
+import { VERSION } from '../version.js';
+import { addWorkersOption, withWorkers } from '../workers.js';
+export function registerBuildCommand(program, runtime) {
+    addWorkersOption(program
+        .command('build')
+        .description('Build the site into the output directory')
+        .option('--drafts', 'include pages marked draft: true')
+        .option('--out <dir>', 'output directory (default: build.outDir)')
+        .option('--base-url <url>', 'site URL for canonical links (default: site.baseUrl)')).action(action(runtime, async (ctx, { options }) => {
+        const { buildSite } = await import('@staticforge/build');
+        const loaded = await loadProjectConfig(ctx);
+        const { rootDir } = loaded;
+        const config = withWorkers(loaded.config, options);
+        const result = await buildSite({
+            rootDir,
+            config,
+            drafts: options.drafts === true ? true : undefined,
+            outDir: options.out,
+            baseUrl: options.baseUrl,
+            generator: `staticforge ${VERSION}`,
+            logger: ctx.logger,
+        });
+        if (!ctx.json) {
+            for (const d of result.diagnostics) {
+                const line = formatDiagnostic(d);
+                if (d.severity === 'error')
+                    ctx.logger.error(line);
+                else if (d.severity === 'warning')
+                    ctx.logger.warn(line);
+                else
+                    ctx.logger.info(line);
+                if (d.hint !== undefined)
+                    ctx.logger.debug(`  hint: ${d.hint}`);
+            }
+        }
+        const { error, warning } = result.summary;
+        const outDir = displayPath(ctx.cwd, result.outDir);
+        return {
+            ok: result.ok,
+            data: result,
+            text: `Built ${result.pages.length} page${result.pages.length === 1 ? '' : 's'} ` +
+                `(${result.fileCount} files) into ${outDir} in ${result.durationMs}ms: ` +
+                `${error} error${error === 1 ? '' : 's'}, ${warning} warning${warning === 1 ? '' : 's'}` +
+                (result.drafts.skipped.length > 0
+                    ? `, ${result.drafts.skipped.length} draft(s) skipped`
+                    : ''),
+        };
+    }));
+}
+//# sourceMappingURL=build.js.map

package/dist/commands/build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.js","sourceRoot":"","sources":["../../src/commands/build.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAgB,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,UAAU,oBAAoB,CAAC,OAAgB,EAAE,OAAgB;IACrE,gBAAgB,CACd,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,UAAU,EAAE,kCAAkC,CAAC;SACtD,MAAM,CAAC,aAAa,EAAE,0CAA0C,CAAC;SACjE,MAAM,CAAC,kBAAkB,EAAE,sDAAsD,CAAC,CACtF,CAAC,MAAM,CACN,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACzC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAC3B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC;YAC7B,OAAO;YACP,MAAM;YACN,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;YAClD,MAAM,EAAE,OAAO,CAAC,GAAyB;YACzC,OAAO,EAAE,OAAO,CAAC,OAA6B;YAC9C,SAAS,EAAE,eAAe,OAAO,EAAE;YACnC,MAAM,EAAE,GAAG,CAAC,MAAM;SACnB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YACd,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;oBAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;qBAC9C,IAAI,CAAC,CAAC,QAAQ,KAAK,SAAS;oBAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;oBACpD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3B,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS;oBAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM;YACZ,IAAI,EACF,SAAS,MAAM,CAAC,KAAK,CAAC,MAAM,QAAQ,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG;gBAC3E,IAAI,MAAM,CAAC,SAAS,gBAAgB,MAAM,OAAO,MAAM,CAAC,UAAU,MAAM;gBACxE,GAAG,KAAK,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,WAAW,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;gBACxF,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;oBAC/B,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,mBAAmB;oBACtD,CAAC,CAAC,EAAE,CAAC;SACV,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC"}

package/dist/commands/check.d.ts

@@ -0,0 +1,4 @@
+import { type Command } from 'commander';
+import { type Runtime } from '../command.js';
+export declare function registerCheckCommand(program: Command, runtime: Runtime): void;
+//# sourceMappingURL=check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGjD,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAmBrD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAuG7E"}

package/dist/commands/check.js

@@ -0,0 +1,100 @@
+import { existsSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { Option } from 'commander';
+import { ErrorCode, SforgeError, shouldUseColor } from '@staticforge/core';
+import { action } from '../command.js';
+import { displayPath } from '../paths.js';
+import { loadProjectConfig } from '../project.js';
+import { VERSION } from '../version.js';
+import { addWorkersOption, withWorkers } from '../workers.js';
+/** Directory of the enclosing git repository, if any. */
+function gitRoot(dir) {
+    for (let d = resolve(dir);; d = dirname(d)) {
+        if (existsSync(join(d, '.git')))
+            return d;
+        if (dirname(d) === d)
+            return undefined;
+    }
+}
+const truthy = (value) => value !== undefined && value !== '' && value !== 'false' && value !== '0';
+export function registerCheckCommand(program, runtime) {
+    addWorkersOption(program
+        .command('check')
+        .description('Build the site to a temporary directory and check it for accessibility and correctness')
+        .option('--fix', 'apply safe fixes to the source files, then check again')
+        .option('--dry-run', 'with --fix: print the fixes as a diff instead of applying them')
+        .option('--headless', 'run rendered checks in headless Chromium (default: check.headless)')
+        .option('--no-headless', 'skip rendered checks')
+        .option('--pages <globs...>', 'only check pages whose URL or source matches, e.g. "/blog/**"')
+        .addOption(new Option('--format <format>', 'report format')
+        .choices(['pretty', 'json', 'sarif', 'junit'])
+        .default('pretty'))
+        .option('--output <file>', 'write the report to a file instead of stdout')
+        .addOption(new Option('--fail-on <severity>', 'exit 1 on problems at or above (default: check.failOn)').choices(['error', 'warning']))
+        .option('--drafts', 'include pages marked draft: true')).action(action(runtime, async (ctx, { options }) => {
+        const format = options.format;
+        const output = options.output;
+        if (options.dryRun === true && options.fix !== true) {
+            throw new SforgeError(ErrorCode.Usage, '--dry-run requires --fix');
+        }
+        if (ctx.json && format !== 'pretty' && format !== 'json' && output === undefined) {
+            throw new SforgeError(ErrorCode.Usage, `--format ${format} and --json both write to stdout`, {
+                hint: `Write the ${format} report to a file with --output <file>.`,
+            });
+        }
+        const { checkSite, formatJunit, formatPretty, formatSarif } = await import('@staticforge/checker');
+        const loaded = await loadProjectConfig(ctx);
+        const { rootDir } = loaded;
+        const config = withWorkers(loaded.config, options);
+        const env = ctx.io.env;
+        const headless = options.headless;
+        const result = await checkSite({
+            rootDir,
+            config,
+            ...(headless !== undefined && { headless }),
+            // An explicit --headless, or CI, must not silently skip rendered checks.
+            requireBrowser: headless === true || truthy(env.CI),
+            ...(env.SFORGE_CHROMIUM_PATH && { executablePath: env.SFORGE_CHROMIUM_PATH }),
+            ...(options.pages !== undefined && { pages: options.pages }),
+            ...(options.fix === true && { fix: options.dryRun === true ? 'dry-run' : 'apply' }),
+            ...(options.failOn !== undefined && { failOn: options.failOn }),
+            ...(options.drafts === true && { drafts: true }),
+            generator: `staticforge ${VERSION}`,
+            logger: ctx.logger,
+        });
+        const render = (as, color) => {
+            switch (as) {
+                case 'json':
+                    return JSON.stringify(result, null, 2);
+                case 'sarif': {
+                    const repo = gitRoot(rootDir);
+                    const prefix = repo === undefined ? '' : relative(repo, rootDir).split(sep).join('/');
+                    return JSON.stringify(formatSarif(result, {
+                        toolVersion: VERSION,
+                        uriPrefix: prefix === '' ? '' : `${prefix}/`,
+                        fallbackFile: relative(rootDir, loaded.path).split(sep).join('/'),
+                    }), null, 2);
+                }
+                case 'junit':
+                    return formatJunit(result);
+                default:
+                    return formatPretty(result, { color });
+            }
+        };
+        const color = ctx.color && shouldUseColor(ctx.io.stdout, env);
+        let text;
+        if (output !== undefined) {
+            const path = resolve(ctx.cwd, output);
+            writeFileSync(path, `${render(format, false)}\n`);
+            text = `${formatPretty(result, { color })}\nWrote ${format} report to ${displayPath(ctx.cwd, path)}`;
+        }
+        else {
+            text = render(format, color);
+        }
+        if (result.fixes?.applied === false && format === 'pretty' && output === undefined) {
+            text = `${result.fixes.diff}\n${text}`;
+        }
+        return { ok: result.ok, data: result, text };
+    }));
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/config.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import { type Runtime } from '../command.js';
+export declare function registerConfigCommands(program: Command, runtime: Runtime): void;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAGrD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6B/E"}

package/dist/commands/config.js

@@ -0,0 +1,27 @@
+import { action } from '../command.js';
+import { loadProjectConfig } from '../project.js';
+export function registerConfigCommands(program, runtime) {
+    const config = program.command('config').description('Inspect and validate the project config');
+    config
+        .command('validate')
+        .description('Validate the config file and report problems')
+        .action(action(runtime, async (ctx) => {
+        const loaded = await loadProjectConfig(ctx);
+        const targets = Object.keys(loaded.config.targets);
+        return {
+            data: { valid: true, path: loaded.path, rootDir: loaded.rootDir, targets },
+            text: `Config is valid: ${loaded.path}`,
+        };
+    }));
+    config
+        .command('show')
+        .description('Print the resolved config, with defaults applied')
+        .action(action(runtime, async (ctx) => {
+        const loaded = await loadProjectConfig(ctx);
+        return {
+            data: { path: loaded.path, config: loaded.config },
+            text: JSON.stringify(loaded.config, null, 2),
+        };
+    }));
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,MAAM,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,UAAU,sBAAsB,CAAC,OAAgB,EAAE,OAAgB;IACvE,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,yCAAyC,CAAC,CAAC;IAEhG,MAAM;SACH,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,8CAA8C,CAAC;SAC3D,MAAM,CACL,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnD,OAAO;YACL,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE;YAC1E,IAAI,EAAE,oBAAoB,MAAM,CAAC,IAAI,EAAE;SACxC,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,kDAAkD,CAAC;SAC/D,MAAM,CACL,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAC5C,OAAO;YACL,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAClD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;SAC7C,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/commands/deploy.d.ts

@@ -0,0 +1,4 @@
+import type { Command } from 'commander';
+import { type Runtime } from '../command.js';
+export declare function registerDeployCommands(program: Command, runtime: Runtime): void;
+//# sourceMappingURL=deploy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYzC,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,eAAe,CAAC;AAoErD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAiJ/E"}