@staticforge/build 0.0.0-stage → 0.1.0

package/dist/scaffold.js

@@ -0,0 +1,163 @@
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { basename, dirname, join } from 'node:path';
+import { stringify as toYaml } from 'yaml';
+import { CONFIG_FILE_NAMES, ErrorCode, SforgeError, validateConfig, } from '@staticforge/core';
+import { ProjectDirs } from './project.js';
+import { routeFor } from './routes.js';
+export const SCHEMA_PATH = './node_modules/staticforge/schema/staticforge.schema.json';
+const humanize = (name) => {
+    const words = name.replace(/[-_]+/g, ' ').trim();
+    return words === '' ? 'My site' : words.charAt(0).toUpperCase() + words.slice(1);
+};
+const slugify = (name) => name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '') || 'site';
+/** Render a config object as a TypeScript literal with unquoted keys and single quotes. */
+function toTsLiteral(value, indent = '') {
+    const next = `${indent}  `;
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        return `[${value.map((v) => toTsLiteral(v, next)).join(', ')}]`;
+    }
+    if (value !== null && typeof value === 'object') {
+        const entries = Object.entries(value);
+        if (entries.length === 0)
+            return '{}';
+        const lines = entries.map(([k, v]) => {
+            const key = /^[A-Za-z_$][\w$]*$/.test(k) ? k : `'${k}'`;
+            return `${next}${key}: ${toTsLiteral(v, next)},`;
+        });
+        return `{\n${lines.join('\n')}\n${indent}}`;
+    }
+    if (typeof value === 'string')
+        return `'${value.replace(/\\/g, '\\\\').replace(/'/g, "\\'")}'`;
+    return String(value);
+}
+function configSource(config, format) {
+    switch (format) {
+        case 'ts':
+            return `import { defineConfig } from 'staticforge';\n\nexport default defineConfig(${toTsLiteral(config)});\n`;
+        case 'json':
+            return `${JSON.stringify({ $schema: SCHEMA_PATH, ...config }, null, 2)}\n`;
+        case 'yaml':
+            return `# yaml-language-server: $schema=${SCHEMA_PATH}\n${toYaml(config)}`;
+    }
+}
+function writeFiles(rootDir, files, force) {
+    const result = { rootDir, created: [], skipped: [] };
+    for (const [path, contents] of Object.entries(files)) {
+        const full = join(rootDir, path);
+        if (existsSync(full) && !force) {
+            result.skipped.push(path);
+            continue;
+        }
+        mkdirSync(dirname(full), { recursive: true });
+        writeFileSync(full, contents);
+        result.created.push(path);
+    }
+    return result;
+}
+/** Create a new project: config, starter content, a site stylesheet and .gitignore. */
+export function initProject(options) {
+    const { dir, format = 'ts', force = false } = options;
+    const existing = CONFIG_FILE_NAMES.find((name) => existsSync(join(dir, name)));
+    if (existing !== undefined && !force) {
+        throw new SforgeError(ErrorCode.FileExists, `${join(dir, existing)} already exists`, {
+            hint: 'This directory is already a staticforge project. Pass --force to overwrite the starter files.',
+        });
+    }
+    const name = basename(dir);
+    const title = options.title ?? humanize(name);
+    const config = {
+        site: {
+            title,
+            baseUrl: options.baseUrl ?? 'https://example.com',
+            language: options.language ?? 'en',
+        },
+        styles: ['/assets/css/site.css'],
+    };
+    if (options.provider === 'aws') {
+        config.targets = { staging: { provider: 'aws', region: options.region ?? 'us-east-1' } };
+    }
+    else if (options.provider === 'azure') {
+        config.targets = {
+            staging: {
+                provider: 'azure',
+                resourceGroup: `rg-${slugify(name)}`,
+                location: options.region ?? 'westeurope',
+            },
+        };
+    }
+    validateConfig(config, 'generated config'); // guard against scaffolding drifting from the schema
+    const configName = `staticforge.config.${format}`;
+    const files = {
+        [configName]: configSource(config, format),
+        [`${ProjectDirs.content}/index.md`]: `---
+${toYaml({ title, description: `Welcome to ${title}.` })}---
+
+This site is built with staticforge.
+
+## Next steps
+
+- Edit this page in \`content/index.md\`.
+- Add a page with \`sforge new page <name>\`, or a blog post with \`sforge new post <name>\`.
+- Build the site into \`dist/\` with \`sforge build\`.
+`,
+        [`${ProjectDirs.content}/about.md`]: `---
+title: About
+description: What this site is about.
+nav:
+  order: 1
+---
+
+Tell visitors who you are and what they will find here.
+`,
+        [`${ProjectDirs.assets}/css/site.css`]: `/*
+ * Site styles, loaded after the theme. Override theme variables here, e.g.:
+ *
+ * :root { --color-link: #0b6e4f; }
+ */
+`,
+        '.gitignore': 'node_modules/\ndist/\n.sforge/cache/\n.sforge/state/\n.sforge/iac/**/.terraform/\n',
+    };
+    const result = writeFiles(dir, files, force);
+    return { ...result, configPath: join(dir, configName) };
+}
+/** Create a page or post with front-matter; returns its file and future URL. */
+export function newContent(options) {
+    const { kind, format = 'md' } = options;
+    let path = options.path.replace(/^\.?\/?(content\/)?/, '').replace(/\.(md|markdown|html?)$/i, '');
+    if (kind === 'post' && !path.includes('/'))
+        path = `blog/${path}`;
+    const segments = path.split('/');
+    if (path === '' || segments.some((s) => !/^[a-z0-9][a-z0-9_-]*$/i.test(s))) {
+        throw new SforgeError(ErrorCode.Usage, `Invalid content path "${options.path}"`, {
+            hint: 'Use letters, digits, "-" and "_" in each segment, e.g. "guides/getting-started".',
+        });
+    }
+    const contentPath = `${path}.${format}`;
+    const file = `${ProjectDirs.content}/${contentPath}`;
+    const full = join(options.rootDir, file);
+    if (existsSync(full) && !options.force) {
+        throw new SforgeError(ErrorCode.FileExists, `${file} already exists`, {
+            hint: 'Pass --force to overwrite it.',
+        });
+    }
+    const frontMatter = {
+        title: options.title ?? humanize(segments.at(-1) ?? path),
+    };
+    if (kind === 'post') {
+        frontMatter.layout = 'post';
+        frontMatter.date = (options.date ?? new Date()).toISOString().slice(0, 10);
+        frontMatter.tags = [];
+    }
+    if (options.draft)
+        frontMatter.draft = true;
+    const body = format === 'md' ? 'Write your content here.\n' : '<p>Write your content here.</p>\n';
+    mkdirSync(dirname(full), { recursive: true });
+    writeFileSync(full, `---\n${toYaml(frontMatter)}---\n\n${body}`);
+    return { file, url: routeFor(contentPath, undefined, options.urls).url };
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/site.d.ts

@@ -0,0 +1,47 @@
+import type { PageMeta } from '@staticforge/content';
+import type { SforgeConfig } from '@staticforge/core';
+import type { Breadcrumb, PageSummary, TagRef } from '@staticforge/render';
+import { type Route, type UrlOptions } from './routes.js';
+/** A built page with what site features need to know about it. */
+export interface SitePage {
+    source: string;
+    url: string;
+    title: string;
+    meta: PageMeta;
+}
+export interface Collection {
+    name: string;
+    /** Content-relative directory, e.g. "blog". */
+    dir: string;
+    /** Source of the collection's index page (`blog/_index.md`), if it has one. */
+    index: string | undefined;
+    /** Members, sorted. */
+    pages: SitePage[];
+    perPage: number;
+    feed: {
+        rss: boolean;
+        atom: boolean;
+    };
+}
+/** "Static Sites" → "static-sites"; "C++" → "c"; non-Latin letters are kept. */
+export declare function slugify(text: string): string;
+/**
+ * Group pages into the configured collections. A collection's members are the
+ * pages under its directory, except section index pages.
+ */
+export declare function collectionsOf(config: SforgeConfig['collections'], pages: SitePage[]): {
+    collections: Collection[];
+    problems: string[];
+};
+/** Route of a collection's list page `n` (1-based): /blog/, /blog/page/2/, … */
+export declare function listRoute(dir: string, n: number, urls: UrlOptions): Route;
+/** Route of a tag's page, /tags/<slug>/, or the tag index, /tags/. */
+export declare function tagRoute(slug: string | undefined, urls: UrlOptions): Route;
+export declare function summarize(page: SitePage, baseUrl: string, tagUrl: (slug: string) => string | undefined): PageSummary;
+export declare function tagsOf(names: string[], tagUrl: (slug: string) => string | undefined): TagRef[];
+/**
+ * Home, then each ancestor URL that is a page, then the page itself:
+ * /guides/setup/ → Home › Guides › Setup.
+ */
+export declare function breadcrumbsFor(url: string, titles: ReadonlyMap<string, string>): Breadcrumb[];
+//# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE3E,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAY,MAAM,aAAa,CAAC;AAEpE,kEAAkE;AAClE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uBAAuB;IACvB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,GAAG,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;CACvC;AAID,gFAAgF;AAChF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAS5C;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,CAAC,aAAa,CAAC,EACnC,KAAK,EAAE,QAAQ,EAAE,GAChB;IAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CA2CnD;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,CAGzE;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,UAAU,GAAG,KAAK,CAE1E;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC3C,WAAW,CAUb;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAK9F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,UAAU,EAAE,CAkB7F"}

package/dist/site.js

@@ -0,0 +1,107 @@
+import { posix } from 'node:path';
+import { ProjectDirs } from './project.js';
+import { routeFor } from './routes.js';
+const INDEX = /(^|\/)_?index\.[^/]+$/;
+/** "Static Sites" → "static-sites"; "C++" → "c"; non-Latin letters are kept. */
+export function slugify(text) {
+    return (text
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}]+/gu, '-')
+        .replace(/^-+|-+$/g, '') || 'tag');
+}
+const time = (date) => date?.getTime() ?? -Infinity;
+/**
+ * Group pages into the configured collections. A collection's members are the
+ * pages under its directory, except section index pages.
+ */
+export function collectionsOf(config, pages) {
+    const collections = [];
+    const problems = [];
+    for (const [name, options] of Object.entries(config)) {
+        const dir = posix.normalize(options.dir).replace(/\/+$/, '');
+        const prefix = `${ProjectDirs.content}/`;
+        if (!dir.startsWith(prefix) && dir !== ProjectDirs.content) {
+            problems.push(`Collection "${name}": dir "${options.dir}" must be inside ${ProjectDirs.content}/`);
+            continue;
+        }
+        const contentDir = dir === ProjectDirs.content ? '' : dir.slice(prefix.length);
+        const within = (source) => source.startsWith(`${dir}/`);
+        const members = pages.filter((p) => within(p.source) && !INDEX.test(p.source));
+        const index = pages.find((p) => posix.dirname(p.source) === dir && INDEX.test(p.source))?.source;
+        const sorted = [...members].sort((a, b) => {
+            switch (options.sortBy) {
+                case 'title':
+                    return a.title.localeCompare(b.title);
+                case 'order':
+                    return ((a.meta.order ?? Infinity) - (b.meta.order ?? Infinity) ||
+                        a.title.localeCompare(b.title));
+                default:
+                    // Newest first; undated pages last, by title.
+                    return time(b.meta.date) - time(a.meta.date) || a.title.localeCompare(b.title);
+            }
+        });
+        collections.push({
+            name,
+            dir: contentDir,
+            index,
+            pages: sorted,
+            perPage: options.perPage,
+            feed: options.feed,
+        });
+    }
+    return { collections, problems };
+}
+/** Route of a collection's list page `n` (1-based): /blog/, /blog/page/2/, … */
+export function listRoute(dir, n, urls) {
+    const base = dir === '' ? '' : `${dir}/`;
+    return routeFor(n === 1 ? `${base}index.md` : `${base}page/${n}.md`, undefined, urls);
+}
+/** Route of a tag's page, /tags/<slug>/, or the tag index, /tags/. */
+export function tagRoute(slug, urls) {
+    return routeFor(slug === undefined ? 'tags/index.md' : `tags/${slug}.md`, undefined, urls);
+}
+export function summarize(page, baseUrl, tagUrl) {
+    return {
+        title: page.title,
+        url: page.url,
+        absoluteUrl: new URL(page.url, baseUrl).href,
+        description: page.meta.description,
+        date: page.meta.date,
+        updated: page.meta.updated,
+        tags: tagsOf(page.meta.tags, tagUrl),
+    };
+}
+export function tagsOf(names, tagUrl) {
+    return names.map((name) => {
+        const slug = slugify(name);
+        return { name, slug, url: tagUrl(slug) };
+    });
+}
+/**
+ * Home, then each ancestor URL that is a page, then the page itself:
+ * /guides/setup/ → Home › Guides › Setup.
+ */
+export function breadcrumbsFor(url, titles) {
+    const crumbs = [];
+    const home = titles.get('/');
+    if (home !== undefined && url !== '/')
+        crumbs.push({ title: home, url: '/', current: false });
+    const segments = url
+        .replace(/^\/|\/$/g, '')
+        .split('/')
+        .filter((s) => s !== '');
+    for (let i = 1; i < segments.length; i++) {
+        const path = `/${segments.slice(0, i).join('/')}`;
+        const ancestor = titles.has(`${path}/`) ? `${path}/` : titles.has(path) ? path : undefined;
+        if (ancestor !== undefined) {
+            crumbs.push({ title: titles.get(ancestor) ?? '', url: ancestor, current: false });
+        }
+    }
+    const title = titles.get(url);
+    if (title !== undefined)
+        crumbs.push({ title, url, current: true });
+    return crumbs;
+}
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAA+B,QAAQ,EAAE,MAAM,aAAa,CAAC;AAsBpE,MAAM,KAAK,GAAG,uBAAuB,CAAC;AAEtC,gFAAgF;AAChF,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,CACL,IAAI;SACD,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;SAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,KAAK,CACpC,CAAC;AACJ,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,IAAsB,EAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC;AAE9E;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,MAAmC,EACnC,KAAiB;IAEjB,MAAM,WAAW,GAAiB,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,GAAG,WAAW,CAAC,OAAO,GAAG,CAAC;QACzC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,GAAG,KAAK,WAAW,CAAC,OAAO,EAAE,CAAC;YAC3D,QAAQ,CAAC,IAAI,CACX,eAAe,IAAI,WAAW,OAAO,CAAC,GAAG,oBAAoB,WAAW,CAAC,OAAO,GAAG,CACpF,CAAC;YACF,SAAS;QACX,CAAC;QACD,MAAM,UAAU,GAAG,GAAG,KAAK,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/E,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAC/D,EAAE,MAAM,CAAC;QAEV,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxC,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;gBACvB,KAAK,OAAO;oBACV,OAAO,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBACxC,KAAK,OAAO;oBACV,OAAO,CACL,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC;wBACvD,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAC/B,CAAC;gBACJ;oBACE,8CAA8C;oBAC9C,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACnF,CAAC;QACH,CAAC,CAAC,CAAC;QACH,WAAW,CAAC,IAAI,CAAC;YACf,IAAI;YACJ,GAAG,EAAE,UAAU;YACf,KAAK;YACL,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI;SACnB,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,CAAS,EAAE,IAAgB;IAChE,MAAM,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC;IACzC,OAAO,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AACxF,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,QAAQ,CAAC,IAAwB,EAAE,IAAgB;IACjE,OAAO,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,SAAS,CACvB,IAAc,EACd,OAAe,EACf,MAA4C;IAE5C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,IAAI;QAC5C,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW;QAClC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;QACpB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAe,EAAE,MAA4C;IAClF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,MAAmC;IAC7E,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,KAAK,GAAG;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,MAAM,QAAQ,GAAG,GAAG;SACjB,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tasks.d.ts

@@ -0,0 +1,86 @@
+import type { Root } from 'hast';
+import { type ParsedContent, type PreparedSource } from '@staticforge/content';
+import type { Diagnostic } from '@staticforge/core';
+import { type NavItem, type Pagination, type PageContext, type PageSummary, type RenderContext, type TagSummary } from '@staticforge/render';
+/** Below this many pages, work stays in the main thread: starting workers costs more. */
+export declare const MIN_PAGES_FOR_WORKERS = 100;
+export declare const PARSE_TASK: {
+    module: string;
+    fn: string;
+};
+export declare const RENDER_TASK: {
+    module: string;
+    fn: string;
+};
+/** Whether a root-relative URL path names an output file or directory index. */
+export declare function outputExists(outputs: {
+    has(path: string): boolean;
+}, urlPath: string): boolean;
+/** The final URL of an asset: its fingerprinted name, keeping a query or fragment. */
+export declare function assetUrlFor(urls: ReadonlyMap<string, string>): (url: string) => string;
+export interface ParseContext {
+    language: string;
+    /** Page URL by project-relative source path. */
+    pageUrls: Map<string, string>;
+    /** Every output path of the build. */
+    outputs: Set<string>;
+    /** Whether content images are optimized (their pages then need their trees). */
+    optimizeImages: boolean;
+}
+/**
+ * A parsed page. Pages the build still changes (documents, and fragments with
+ * images to optimize) keep their tree; the others carry their HTML, which is
+ * much cheaper to send between threads and safe to cache.
+ */
+export type ParsedPage = Omit<ParsedContent, 'tree'> & ({
+    tree: Root;
+    html?: undefined;
+} | {
+    tree?: undefined;
+    html: string;
+});
+export interface ParseResult {
+    parsed: ParsedPage;
+    /** Problems found while resolving references (reported before `parsed.diagnostics`). */
+    references: Diagnostic[];
+}
+/** Parse pages to HAST; references resolve against all pages and outputs of the build. */
+export declare function parsePages(input: {
+    items: PreparedSource[];
+    context: ParseContext;
+}): Promise<ParseResult[]>;
+export interface RenderContextShared {
+    /** Distinguishes builds, so workers never reuse a renderer (and its templates) across them. */
+    buildId: string;
+    theme: string;
+    rootDir: string;
+    baseUrl: string;
+    /** Fingerprinted URL by asset URL. */
+    assetUrls: Map<string, string>;
+    minify: boolean;
+    base: Omit<RenderContext, 'page' | 'content' | 'nav' | 'breadcrumbs'>;
+    nav: Omit<NavItem, 'current' | 'active'>[];
+    /** Page title by URL, for breadcrumbs. */
+    titles: Map<string, string>;
+}
+export interface RenderItem {
+    layout: string;
+    url: string;
+    page: PageContext;
+    content: string;
+    pagination?: Pagination;
+    tag?: TagSummary & {
+        items: PageSummary[];
+    };
+}
+export type RenderResult = {
+    html: string;
+} | {
+    error: string;
+};
+/** Render pages with their layouts and finish them (asset URLs, minification). */
+export declare function renderPages(input: {
+    items: RenderItem[];
+    context: RenderContextShared;
+}): RenderResult[];
+//# sourceMappingURL=tasks.d.ts.map

package/dist/tasks.d.ts.map

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

package/dist/tasks.js

@@ -0,0 +1,103 @@
+import { posix } from 'node:path';
+import { toHtml } from 'hast-util-to-html';
+import { visit } from 'unist-util-visit';
+import { createReport, parseContent, } from '@staticforge/content';
+import { createRenderer, loadTheme, } from '@staticforge/render';
+import { finishHtml } from './html.js';
+import { navFor } from './nav.js';
+import { createRefResolver } from './routes.js';
+import { breadcrumbsFor } from './site.js';
+/*
+ * The per-page work of a build, as functions of plain data, so it can run in
+ * worker threads (see `WorkerPool` in @staticforge/core) or in this thread.
+ */
+/** Below this many pages, work stays in the main thread: starting workers costs more. */
+export const MIN_PAGES_FOR_WORKERS = 100;
+export const PARSE_TASK = { module: import.meta.url, fn: 'parsePages' };
+export const RENDER_TASK = { module: import.meta.url, fn: 'renderPages' };
+/** Whether a root-relative URL path names an output file or directory index. */
+export function outputExists(outputs, urlPath) {
+    let path;
+    try {
+        path = decodeURI(urlPath.split(/[?#]/)[0] ?? '').replace(/^\//, '');
+    }
+    catch {
+        return false;
+    }
+    return (outputs.has(path) || outputs.has(posix.join(path, 'index.html')) || outputs.has(`${path}.html`));
+}
+/** The final URL of an asset: its fingerprinted name, keeping a query or fragment. */
+export function assetUrlFor(urls) {
+    return (url) => {
+        const [, path = url, rest = ''] = /^([^?#]*)(.*)$/s.exec(url) ?? [];
+        return (urls.get(path) ?? path) + rest;
+    };
+}
+function hasImage(tree) {
+    let found = false;
+    visit(tree, 'element', (node) => {
+        if (node.tagName === 'img')
+            found = true;
+        return found ? false : undefined;
+    });
+    return found;
+}
+/** Parse pages to HAST; references resolve against all pages and outputs of the build. */
+export async function parsePages(input) {
+    const { language, pageUrls, outputs, optimizeImages } = input.context;
+    const fileExists = (urlPath) => outputExists(outputs, urlPath);
+    const results = [];
+    for (const prepared of input.items) {
+        const references = [];
+        const report = createReport(prepared.path, references);
+        const parsed = await parseContent(prepared, {
+            language,
+            resolveRef: createRefResolver({ sourcePath: prepared.path, pageUrls, report }),
+            fileExists,
+        });
+        const { tree, ...rest } = parsed;
+        const keepTree = parsed.kind === 'document' || (optimizeImages && hasImage(tree));
+        results.push({
+            parsed: keepTree ? { ...rest, tree } : { ...rest, html: toHtml(tree) },
+            references,
+        });
+    }
+    return results;
+}
+let cached;
+/** Render pages with their layouts and finish them (asset URLs, minification). */
+export function renderPages(input) {
+    const { context } = input;
+    const assetUrl = assetUrlFor(context.assetUrls);
+    if (cached?.buildId !== context.buildId) {
+        const theme = loadTheme(context.theme, context.rootDir);
+        cached = {
+            buildId: context.buildId,
+            renderer: createRenderer(theme, {
+                rootDir: context.rootDir,
+                baseUrl: context.baseUrl,
+                assetUrl,
+            }),
+        };
+    }
+    const { renderer } = cached;
+    return input.items.map((item) => {
+        let html;
+        try {
+            html = renderer.render(item.layout, {
+                ...context.base,
+                page: item.page,
+                content: item.content,
+                nav: navFor(context.nav, item.url),
+                breadcrumbs: breadcrumbsFor(item.url, context.titles),
+                ...(item.pagination && { pagination: item.pagination }),
+                ...(item.tag && { tag: item.tag }),
+            });
+        }
+        catch (error) {
+            return { error: error instanceof Error ? error.message : String(error) };
+        }
+        return { html: finishHtml(html, { assetUrl, minify: context.minify }) };
+    });
+}
+//# sourceMappingURL=tasks.js.map

package/dist/tasks.js.map

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

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@staticforge/build",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Site build pipeline: discovery, URL mapping, rendering and output",
+  "keywords": [
+    "staticforge"
+  ],
+  "homepage": "https://github.com/elchanio-76/sforge#readme",
+  "bugs": {
+    "url": "https://github.com/elchanio-76/sforge/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elchanio-76/sforge.git",
+    "directory": "packages/build"
+  },
+  "license": "MIT",
+  "author": "Eleftherios Chaniotakis",
+  "type": "module",
+  "exports": {
+    ".": {
+      "@staticforge/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": "^22.22.0 || >=24.8.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@staticforge/assets": "0.1.0",
+    "@staticforge/content": "0.1.0",
+    "@staticforge/core": "0.1.0",
+    "@staticforge/render": "0.1.0",
+    "hast-util-from-html": "^2.0.3",
+    "hast-util-minify-whitespace": "^1.0.1",
+    "hast-util-to-html": "^9.0.5",
+    "hastscript": "^9.0.1",
+    "unist-util-visit": "^5.1.0",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "@types/hast": "^3.0.5"
+  }
 }