@staticforge/build 0.0.0-stage → 0.1.0

package/dist/html.js

@@ -0,0 +1,31 @@
+import { fromHtml } from 'hast-util-from-html';
+import { minifyWhitespace } from 'hast-util-minify-whitespace';
+import { toHtml } from 'hast-util-to-html';
+import { visit } from 'unist-util-visit';
+const URL_PROPERTIES = ['href', 'src'];
+/** Rewrite asset references and minify a page's tree in place. */
+export function finishTree(tree, options) {
+    visit(tree, 'element', (node) => {
+        for (const name of URL_PROPERTIES) {
+            const value = node.properties[name];
+            if (typeof value === 'string' && value.startsWith('/') && !value.startsWith('//')) {
+                node.properties[name] = options.assetUrl(value);
+            }
+        }
+    });
+    if (options.minify)
+        minifyWhitespace(tree);
+}
+/** The same, for an HTML fragment such as a page body in a feed. */
+export function finishFragment(html, options) {
+    const tree = fromHtml(html, { fragment: true });
+    finishTree(tree, options);
+    return toHtml(tree);
+}
+/** Rewrite asset references in, and minify, a rendered page. */
+export function finishHtml(html, options) {
+    const tree = fromHtml(html);
+    finishTree(tree, options);
+    return toHtml(tree);
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AASzC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;AAEhD,kEAAkE;AAClE,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,OAAsB;IAC3D,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE;QACvC,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,MAAM;QAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,OAAsB;IACjE,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAsB;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/images.d.ts

@@ -0,0 +1,22 @@
+import type { Element, Root } from 'hast';
+import { type ImageOptions, type OptimizedImage } from '@staticforge/assets';
+/** Where image variants are written in the build. */
+export declare const IMAGE_DIR = "_assets/img";
+export interface ImageContext extends ImageOptions {
+    sizes: string;
+    /** Source file of a root-relative URL in the built site, if it is copied from the project. */
+    sourceOf: (urlPath: string) => string | undefined;
+    /** Called for each variant to write. */
+    emit: (output: string, file: string) => void;
+    /** Called when an image cannot be processed. */
+    fail: (node: Element, message: string) => void;
+}
+/** Images being processed, by source file, so each is encoded once per build. */
+export type ImageCache = Map<string, Promise<OptimizedImage>>;
+/**
+ * Replace content images with responsive `<picture>` elements: modern formats
+ * at several widths, the original format as fallback, and width/height so
+ * the layout does not shift while images load.
+ */
+export declare function optimizeImages(tree: Root, context: ImageContext, cache: ImageCache): Promise<void>;
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE1C,OAAO,EACL,KAAK,YAAY,EAEjB,KAAK,cAAc,EAGpB,MAAM,qBAAqB,CAAC;AAE7B,qDAAqD;AACrD,eAAO,MAAM,SAAS,gBAAgB,CAAC;AAEvC,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAClD,wCAAwC;IACxC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,gDAAgD;IAChD,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED,iFAAiF;AACjF,MAAM,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;AAO9D;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,CAkFf"}

package/dist/images.js

@@ -0,0 +1,95 @@
+import { posix } from 'node:path';
+import { visit } from 'unist-util-visit';
+import { OPTIMIZABLE, optimizeImage, srcsetOf, } from '@staticforge/assets';
+/** Where image variants are written in the build. */
+export const IMAGE_DIR = '_assets/img';
+const stringProperty = (node, name) => {
+    const value = node.properties[name];
+    return typeof value === 'string' ? value : undefined;
+};
+/**
+ * Replace content images with responsive `<picture>` elements: modern formats
+ * at several widths, the original format as fallback, and width/height so
+ * the layout does not shift while images load.
+ */
+export async function optimizeImages(tree, context, cache) {
+    const jobs = [];
+    visit(tree, 'element', (node, index, parent) => {
+        if (node.tagName !== 'img' || parent === undefined || index === undefined)
+            return;
+        // An author-built <picture> or srcset is left alone.
+        if ((parent.type === 'element' && parent.tagName === 'picture') ||
+            node.properties.srcSet !== undefined)
+            return;
+        const src = stringProperty(node, 'src');
+        if (src === undefined || !src.startsWith('/') || src.startsWith('//'))
+            return;
+        const path = src.split(/[?#]/)[0] ?? '';
+        if (!OPTIMIZABLE.test(path))
+            return;
+        const source = context.sourceOf(path);
+        if (source !== undefined)
+            jobs.push({ node, parent, index, source });
+    });
+    await Promise.all(jobs.map(async ({ node, parent, index, source }) => {
+        let image = cache.get(source);
+        if (image === undefined) {
+            const stem = posix
+                .basename(source)
+                .replace(/\.[^.]+$/, '')
+                .replace(/[^\w-]+/g, '-');
+            image = optimizeImage(source, `${IMAGE_DIR}/${stem}`, context);
+            cache.set(source, image);
+        }
+        let result;
+        try {
+            result = await image;
+        }
+        catch (error) {
+            context.fail(node, (error instanceof Error ? error.message : String(error)).split('\n')[0] ?? '');
+            return;
+        }
+        for (const variant of [
+            ...result.sources.flatMap((s) => s.variants),
+            ...result.fallback.variants,
+        ]) {
+            context.emit(variant.output, variant.file);
+        }
+        const urlOf = (output) => `/${output}`;
+        const largest = result.fallback.variants.at(-1);
+        if (largest === undefined)
+            return;
+        const img = {
+            ...node,
+            properties: {
+                ...node.properties,
+                src: urlOf(largest.output),
+                srcSet: srcsetOf(result.fallback.variants, urlOf),
+                sizes: context.sizes,
+                // Keep the author's size; otherwise reserve the aspect ratio.
+                ...(node.properties.width === undefined &&
+                    node.properties.height === undefined && {
+                    width: largest.width,
+                    height: Math.round((result.height * largest.width) / result.width),
+                }),
+            },
+        };
+        const picture = {
+            type: 'element',
+            tagName: 'picture',
+            properties: {},
+            children: [
+                ...result.sources.map((s) => ({
+                    type: 'element',
+                    tagName: 'source',
+                    properties: { type: s.type, srcSet: srcsetOf(s.variants, urlOf), sizes: context.sizes },
+                    children: [],
+                })),
+                img,
+            ],
+            ...(node.position && { position: node.position }),
+        };
+        parent.children[index] = picture;
+    }));
+}
+//# sourceMappingURL=images.js.map

package/dist/images.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './build.js';
+export { BuildCache, Memo, hashOf, memoized, stableJson } from './cache.js';
+export * from './feeds.js';
+export * from './project.js';
+export * from './routes.js';
+export * from './scaffold.js';
+export * from './site.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './build.js';
+export { BuildCache, Memo, hashOf, memoized, stableJson } from './cache.js';
+export * from './feeds.js';
+export * from './project.js';
+export * from './routes.js';
+export * from './scaffold.js';
+export * from './site.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5E,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}

package/dist/nav.d.ts

@@ -0,0 +1,15 @@
+import type { NavItem } from '@staticforge/render';
+export interface NavCandidate {
+    url: string;
+    title: string;
+    nav: {
+        order?: number | undefined;
+        label?: string | undefined;
+        hide: boolean;
+    } | undefined;
+}
+/** Top-level pages, plus deeper pages that opt in with `nav.order`. Excludes home and 404. */
+export declare function navEntries(pages: NavCandidate[]): Omit<NavItem, 'current' | 'active'>[];
+/** Mark the current page, and the section containing it. */
+export declare function navFor(entries: Omit<NavItem, 'current' | 'active'>[], pageUrl: string): NavItem[];
+//# sourceMappingURL=nav.d.ts.map

package/dist/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CAC5F;AAED,8FAA8F;AAC9F,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC,EAAE,CAQvF;AAED,4DAA4D;AAC5D,wBAAgB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE,CAMjG"}

package/dist/nav.js

@@ -0,0 +1,19 @@
+/** Top-level pages, plus deeper pages that opt in with `nav.order`. Excludes home and 404. */
+export function navEntries(pages) {
+    const topLevel = (url) => /^\/[^/]+(\/|\.html)?$/.test(url);
+    return pages
+        .filter((p) => p.url !== '/' && p.url !== '/404.html' && p.nav?.hide !== true)
+        .filter((p) => topLevel(p.url) || p.nav?.order !== undefined)
+        .map((p) => ({ title: p.nav?.label ?? p.title, url: p.url, order: p.nav?.order ?? Infinity }))
+        .sort((a, b) => a.order - b.order || a.title.localeCompare(b.title))
+        .map(({ title, url }) => ({ title, url }));
+}
+/** Mark the current page, and the section containing it. */
+export function navFor(entries, pageUrl) {
+    return entries.map((entry) => {
+        const current = entry.url === pageUrl;
+        const section = entry.url.endsWith('/') ? entry.url : `${entry.url}/`;
+        return { ...entry, current, active: current || pageUrl.startsWith(section) };
+    });
+}
+//# sourceMappingURL=nav.js.map

package/dist/nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.js","sourceRoot":"","sources":["../src/nav.ts"],"names":[],"mappings":"AAQA,8FAA8F;AAC9F,MAAM,UAAU,UAAU,CAAC,KAAqB;IAC9C,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,uBAAuB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,WAAW,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,IAAI,CAAC;SAC7E,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,KAAK,KAAK,SAAS,CAAC;SAC5D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;SAC7F,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;SACnE,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAC/C,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,MAAM,CAAC,OAA8C,EAAE,OAAe;IACpF,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK,OAAO,CAAC;QACtC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC;QACtE,OAAO,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/E,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/project.d.ts

@@ -0,0 +1,31 @@
+/** Conventional project directories, relative to the project root. */
+export declare const ProjectDirs: {
+    /** Pages (Markdown/HTML) plus co-located files copied alongside them. */
+    readonly content: "content";
+    /** Copied verbatim to the site root. */
+    readonly static: "static";
+    /** Copied to /assets/ (processed in a later milestone). */
+    readonly assets: "assets";
+    /** Project overrides for theme templates. */
+    readonly templates: "templates";
+    /** JSON/YAML files exposed to templates as `data`. */
+    readonly data: "data";
+};
+export declare const PAGE_EXTENSIONS: Set<string>;
+/**
+ * Resolve the output directory and refuse anything we must never delete: the
+ * project root, anything outside it, or a directory holding project sources.
+ */
+export declare function resolveOutDir(rootDir: string, outDir: string): string;
+/**
+ * Validate a scratch output directory (used by `sforge dev`): it must be a
+ * subdirectory of the OS temp directory, so a rebuild can never delete
+ * project files.
+ */
+export declare function resolveScratchDir(dir: string): string;
+/**
+ * List files under `dir` as POSIX paths relative to it. Skips dot-files,
+ * dot-directories and node_modules. Returns [] if the directory is missing.
+ */
+export declare function listFiles(dir: string): string[];
+//# sourceMappingURL=project.d.ts.map

package/dist/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAKA,sEAAsE;AACtE,eAAO,MAAM,WAAW;IACtB,yEAAyE;;IAEzE,wCAAwC;;IAExC,2DAA2D;;IAE3D,6CAA6C;;IAE7C,sDAAsD;;CAE9C,CAAC;AAEX,eAAO,MAAM,eAAe,aAAiD,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAuBrE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAUrD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAe/C"}

package/dist/project.js

@@ -0,0 +1,74 @@
+import { readdirSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { isAbsolute, join, relative, resolve, sep } from 'node:path';
+import { ErrorCode, SforgeError } from '@staticforge/core';
+/** Conventional project directories, relative to the project root. */
+export const ProjectDirs = {
+    /** Pages (Markdown/HTML) plus co-located files copied alongside them. */
+    content: 'content',
+    /** Copied verbatim to the site root. */
+    static: 'static',
+    /** Copied to /assets/ (processed in a later milestone). */
+    assets: 'assets',
+    /** Project overrides for theme templates. */
+    templates: 'templates',
+    /** JSON/YAML files exposed to templates as `data`. */
+    data: 'data',
+};
+export const PAGE_EXTENSIONS = new Set(['.md', '.markdown', '.html', '.htm']);
+/**
+ * Resolve the output directory and refuse anything we must never delete: the
+ * project root, anything outside it, or a directory holding project sources.
+ */
+export function resolveOutDir(rootDir, outDir) {
+    const absolute = isAbsolute(outDir) ? outDir : resolve(rootDir, outDir);
+    const rel = relative(rootDir, absolute);
+    const unsafe = (reason) => new SforgeError(ErrorCode.UnsafePath, `Refusing to use ${absolute} as the output directory: ${reason}`, {
+        hint: 'Set build.outDir to a dedicated directory inside the project, such as "dist".',
+    });
+    if (rel === '')
+        throw unsafe('it is the project root');
+    if (rel.startsWith('..') || isAbsolute(rel))
+        throw unsafe('it is outside the project');
+    const top = rel.split(sep)[0] ?? '';
+    if (Object.values(ProjectDirs).includes(top) ||
+        top === 'node_modules' ||
+        top.startsWith('.')) {
+        throw unsafe(`it would overwrite the project's ${top}/ directory`);
+    }
+    return absolute;
+}
+/**
+ * Validate a scratch output directory (used by `sforge dev`): it must be a
+ * subdirectory of the OS temp directory, so a rebuild can never delete
+ * project files.
+ */
+export function resolveScratchDir(dir) {
+    const absolute = resolve(dir);
+    const rel = relative(tmpdir(), absolute);
+    if (rel === '' || rel.startsWith('..') || isAbsolute(rel)) {
+        throw new SforgeError(ErrorCode.UnsafePath, `Scratch output directory ${absolute} is not inside ${tmpdir()}`);
+    }
+    return absolute;
+}
+/**
+ * List files under `dir` as POSIX paths relative to it. Skips dot-files,
+ * dot-directories and node_modules. Returns [] if the directory is missing.
+ */
+export function listFiles(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { recursive: true, withFileTypes: true });
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return [];
+        throw error;
+    }
+    return entries
+        .filter((entry) => entry.isFile())
+        .map((entry) => relative(dir, join(entry.parentPath, entry.name)).split(sep).join('/'))
+        .filter((path) => !path.split('/').some((part) => part.startsWith('.') || part === 'node_modules'))
+        .sort();
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/routes.d.ts

@@ -0,0 +1,42 @@
+import type { Report, ResolveRef } from '@staticforge/content';
+export interface UrlOptions {
+    cleanUrls: boolean;
+    trailingSlash: 'always' | 'never';
+}
+export interface Route {
+    /** Root-relative URL, e.g. "/blog/hello/". */
+    url: string;
+    /** Output file, POSIX-relative to the output directory. */
+    output: string;
+}
+/**
+ * Map a page's path inside content/ to its URL and output file.
+ *
+ *   index.md         → /             index.html
+ *   about.md         → /about/       about/index.html   (cleanUrls, trailingSlash: always)
+ *                    → /about        about.html         (cleanUrls, trailingSlash: never)
+ *                    → /about.html   about.html         (cleanUrls: false)
+ *   blog/_index.md   → /blog/        blog/index.html
+ *   404.md           → /404.html     404.html           (always, for hosting providers)
+ */
+export declare function routeFor(contentPath: string, slug: string | undefined, options: UrlOptions): Route;
+/**
+ * Resolve references the way authors write them (relative to the source file,
+ * pointing at other sources) to the URLs they have in the built site:
+ *
+ *   other.md#intro        → /other/#intro            (a page)
+ *   photo.jpg             → /blog/photo.jpg          (a file next to the page)
+ *   ../../assets/logo.svg → /assets/logo.svg
+ *   ../../static/cv.pdf   → /cv.pdf
+ *
+ * Root-relative URLs are site URLs and stay unchanged, except page sources
+ * (e.g. /blog/post.md). Absolute URLs and fragments are untouched.
+ */
+export declare function createRefResolver(options: {
+    /** Project-relative path of the page holding the references. */
+    sourcePath: string;
+    /** Page URL by project-relative source path. */
+    pageUrls: ReadonlyMap<string, string>;
+    report: Report;
+}): ResolveRef;
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG/D,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,KAAK;IACpB,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,EAAE,UAAU,GAClB,KAAK,CAiBP;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,gEAAgE;IAChE,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,UAAU,CAoEb"}

package/dist/routes.js

@@ -0,0 +1,106 @@
+import { posix } from 'node:path';
+import { PAGE_EXTENSIONS, ProjectDirs } from './project.js';
+/**
+ * Map a page's path inside content/ to its URL and output file.
+ *
+ *   index.md         → /             index.html
+ *   about.md         → /about/       about/index.html   (cleanUrls, trailingSlash: always)
+ *                    → /about        about.html         (cleanUrls, trailingSlash: never)
+ *                    → /about.html   about.html         (cleanUrls: false)
+ *   blog/_index.md   → /blog/        blog/index.html
+ *   404.md           → /404.html     404.html           (always, for hosting providers)
+ */
+export function routeFor(contentPath, slug, options) {
+    const segments = contentPath.replace(/\.[^./]+$/, '').split('/');
+    let last = segments.pop() ?? 'index';
+    const isIndex = last === 'index' || last === '_index';
+    if (!isIndex && slug !== undefined)
+        last = slug;
+    if (segments.length === 0 && last === '404')
+        return { url: '/404.html', output: '404.html' };
+    const path = (isIndex ? segments : [...segments, last]).join('/');
+    if (path === '')
+        return { url: '/', output: 'index.html' };
+    const encoded = encodeURI(path);
+    if (options.cleanUrls && options.trailingSlash === 'never') {
+        return { url: `/${encoded}`, output: `${path}.html` };
+    }
+    if (options.cleanUrls || isIndex)
+        return { url: `/${encoded}/`, output: `${path}/index.html` };
+    return { url: `/${encoded}.html`, output: `${path}.html` };
+}
+const isPage = (path) => PAGE_EXTENSIONS.has(posix.extname(path).toLowerCase());
+/**
+ * Resolve references the way authors write them (relative to the source file,
+ * pointing at other sources) to the URLs they have in the built site:
+ *
+ *   other.md#intro        → /other/#intro            (a page)
+ *   photo.jpg             → /blog/photo.jpg          (a file next to the page)
+ *   ../../assets/logo.svg → /assets/logo.svg
+ *   ../../static/cv.pdf   → /cv.pdf
+ *
+ * Root-relative URLs are site URLs and stay unchanged, except page sources
+ * (e.g. /blog/post.md). Absolute URLs and fragments are untouched.
+ */
+export function createRefResolver(options) {
+    const { sourcePath, pageUrls, report } = options;
+    const contentPrefix = `${ProjectDirs.content}/`;
+    return (ref, node) => {
+        if (ref === '' ||
+            ref.startsWith('#') ||
+            ref.startsWith('//') ||
+            /^[a-z][a-z\d+.-]*:/i.test(ref)) {
+            return undefined;
+        }
+        const [, rawPath = '', suffix = ''] = /^([^?#]*)(.*)$/s.exec(ref) ?? [];
+        if (rawPath === '')
+            return undefined;
+        let path;
+        try {
+            path = decodeURI(rawPath);
+        }
+        catch {
+            return undefined;
+        }
+        let projectPath;
+        if (path.startsWith('/')) {
+            if (!isPage(path))
+                return undefined;
+            projectPath = posix.normalize(contentPrefix + path.slice(1));
+        }
+        else {
+            projectPath = posix.normalize(posix.join(posix.dirname(sourcePath), path));
+        }
+        const pageUrl = pageUrls.get(projectPath);
+        if (pageUrl !== undefined)
+            return pageUrl + suffix;
+        // A root-relative /x.html that is not a page may be a file from static/;
+        // `sforge check` verifies it against the built site.
+        if (path.startsWith('/') && !/\.(?:md|markdown)$/i.test(path))
+            return undefined;
+        if (projectPath.startsWith(contentPrefix)) {
+            if (isPage(projectPath)) {
+                report({
+                    ruleId: 'link-broken',
+                    severity: 'warning',
+                    message: `Link to ${ref} does not match any page`,
+                    hint: 'Check the path, or the page may be a draft.',
+                }, node);
+                return undefined;
+            }
+            return `/${encodeURI(projectPath.slice(contentPrefix.length))}${suffix}`;
+        }
+        if (projectPath.startsWith(`${ProjectDirs.assets}/`))
+            return `/${encodeURI(projectPath)}${suffix}`;
+        if (projectPath.startsWith(`${ProjectDirs.static}/`)) {
+            return `/${encodeURI(projectPath.slice(ProjectDirs.static.length + 1))}${suffix}`;
+        }
+        report({
+            ruleId: 'link-outside-site',
+            severity: 'warning',
+            message: `Reference ${ref} points outside content/, assets/ and static/, so it will not be published`,
+        }, node);
+        return undefined;
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,46 @@
+import { type UrlOptions } from './routes.js';
+export declare const SCHEMA_PATH = "./node_modules/staticforge/schema/staticforge.schema.json";
+export interface ScaffoldResult {
+    rootDir: string;
+    /** Project-relative paths written. */
+    created: string[];
+    /** Project-relative paths left alone because they already existed. */
+    skipped: string[];
+}
+export interface InitOptions {
+    /** Absolute project directory; created if missing. */
+    dir: string;
+    title?: string;
+    baseUrl?: string;
+    language?: string;
+    format?: 'ts' | 'json' | 'yaml';
+    /** Add a "staging" deploy target for this provider. */
+    provider?: 'aws' | 'azure';
+    /** AWS region or Azure location for the target. */
+    region?: string;
+    /** Overwrite existing files. */
+    force?: boolean;
+}
+/** Create a new project: config, starter content, a site stylesheet and .gitignore. */
+export declare function initProject(options: InitOptions): ScaffoldResult & {
+    configPath: string;
+};
+export interface NewContentOptions {
+    rootDir: string;
+    kind: 'page' | 'post';
+    /** Path inside content/, e.g. "about" or "blog/hello-world". Posts default to blog/. */
+    path: string;
+    title?: string;
+    format?: 'md' | 'html';
+    draft?: boolean;
+    force?: boolean;
+    /** Post date; defaults to today. */
+    date?: Date;
+    urls: UrlOptions;
+}
+/** Create a page or post with front-matter; returns its file and future URL. */
+export declare function newContent(options: NewContentOptions): {
+    file: string;
+    url: string;
+};
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,UAAU,EAAY,MAAM,aAAa,CAAC;AAExD,eAAO,MAAM,WAAW,8DAA8D,CAAC;AAEvF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA+DD,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAmEzF;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oCAAoC;IACpC,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAoCpF"}