@cogenta/cli 0.4.0 → 0.7.0

package/dist/commands/theme-css.js

@@ -90,12 +90,6 @@ export async function inlineImports(entry, options) {
     parts.push(css.slice(cursor));
     return parts.join('\n');
 }
-/**
- * The whole theme stylesheet as one minified string, or `null` when the theme
- * package cannot be resolved — a site then renders with the skin's custom
- * properties alone rather than refusing to serve, the same degradation
- * `loadSkinCss` already chose for a missing `theme.tokens.json`.
- */
 /**
  * FNV-1a, 32 bits. A cache key, never a security boundary — and deliberately
  * not `node:crypto`, to match the hash `@cogenta/render` already uses for the
@@ -109,13 +103,44 @@ export function cssEtag(css) {
     }
     return `"${value.toString(16).padStart(8, '0')}"`;
 }
-export async function loadThemeCss(options) {
+/**
+ * The whole theme stylesheet as one minified string, or `null` when the named
+ * theme package cannot be resolved — a site then renders with the skin's
+ * custom properties alone rather than refusing to serve, the same degradation
+ * `loadSkinCss` already chose for a missing `theme.tokens.json`.
+ *
+ * Every theme package publishes its stylesheet at the same `./styles/theme.css`
+ * export subpath (contract D, mirrored by every theme package's `package.json`)
+ * so this stays a one-line lookup regardless of which theme is active — a
+ * per-theme convention, not a per-theme code branch.
+ */
+export async function loadThemeCss(options, themeName) {
     try {
-        const entry = new URL(import.meta.resolve('@cogenta/theme-canonical/styles/theme.css'));
+        const entry = new URL(import.meta.resolve(`${themeName}/styles/theme.css`));
         return minifyCss(await inlineImports(entry, options));
     }
     catch {
         return null;
     }
 }
+/**
+ * A theme's own stylesheet is code, not data — installing a second theme
+ * package is a redeploy, unlike the skin tokens `resolveStyles` re-reads on
+ * every request. So each theme's CSS is loaded and flattened once per name
+ * and kept for the life of the process, memoised by this factory rather than
+ * reloaded on a request that merely switched *which* already-installed theme
+ * is active — switching is still live (fiche L23): only the file I/O is not
+ * repeated for a theme this process has already read.
+ */
+export function createThemeCssResolver(options) {
+    const cache = new Map();
+    return (themeName) => {
+        const cached = cache.get(themeName);
+        if (cached !== undefined)
+            return cached;
+        const promise = loadThemeCss(options, themeName);
+        cache.set(themeName, promise);
+        return promise;
+    };
+}
 //# sourceMappingURL=theme-css.js.map

package/dist/commands/theme-css.js.map

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

package/dist/commands/theme-registry.d.ts

@@ -0,0 +1,94 @@
+import type { BlockRegistry } from '@cogenta/blocks';
+import type { ThemeManifest } from '@cogenta/render';
+import type { ChromeInput, ChromeResult, FetchedEntries, HtmlElement, PageContent, RenderContext, TermArchiveInput } from '@cogenta/theme-kit';
+/**
+ * The theme registry — what makes more than one theme package installable at
+ * all (fiche L23). Before this, `theme-render.ts` imported `renderPage` and
+ * the chrome markup directly from `@cogenta/theme-canonical`; every site ran
+ * that one theme because nothing else could be named.
+ *
+ * A theme package's two theme-specific exports — everything else a rendered
+ * page needs (`RenderContext`, escaping, rich text, comments, entry helpers)
+ * now lives in `@cogenta/theme-kit`, shared and identical across every theme,
+ * so `theme-render.ts` never has to ask the registry for it.
+ */
+export interface ThemeModule {
+    readonly renderPage: (page: PageContent, ctx: RenderContext, entries?: FetchedEntries, 
+    /**
+     * The block registry a stored block's type is resolved against —
+     * `@cogenta/blocks`'s twelve-turned-seventeen by default. A site with
+     * blocks of its own (a theme, or a theme-shipping plugin) passes its own,
+     * wider registry, so an active theme that does not implement one of them
+     * still renders its declared `fallback` (fiche 43, sous-chantier C(ii))
+     * instead of a silently blank slot.
+     */
+    registry?: BlockRegistry) => HtmlElement;
+    readonly renderChrome: (input: ChromeInput) => ChromeResult;
+    /**
+     * The public archive page of one taxonomy term (contract D `theme@1.3`).
+     *
+     * **Optional**, and that is the whole point of it being here rather than
+     * beside `renderPage`: a theme installed before this existed, or a theme
+     * that simply does not want to own this layout, keeps working — the host
+     * renders a plain list inside that theme's own chrome instead. Making it
+     * required would have turned a new capability into a breaking change for
+     * every theme package on the day it shipped.
+     */
+    readonly renderTermArchive?: (input: TermArchiveInput) => HtmlElement;
+}
+export interface BuiltinTheme {
+    readonly name: string;
+    /** The gallery's own display name — not part of the manifest (fiche 48: a theme package does not get to name the card it is shown on). */
+    readonly label: string;
+    readonly load: () => Promise<ThemeModule>;
+    /** Loads `<package>/theme.config` — the manifest, separate from `load()` so a card can show version/description/author without pulling in the whole render module. */
+    readonly loadManifest: () => Promise<{
+        readonly default: ThemeManifest;
+    }>;
+}
+/**
+ * The theme packages this build of `@cogenta/cli` ships with — a real npm
+ * dependency of this package, never a filesystem scan: `cogenta serve` runs
+ * from a project that installed `@cogenta/cli`, and every theme it can offer
+ * has to be something that installation actually has in `node_modules`.
+ *
+ * Adding a theme package is one entry here, matched by one line in this
+ * package's own `dependencies` — the same "declare it once, the registry
+ * generalises the rest" shape `SITE_SETTINGS_REGISTRY` already uses for site
+ * settings.
+ */
+export declare const BUILTIN_THEMES: readonly BuiltinTheme[];
+export declare const DEFAULT_THEME_NAME = "@cogenta/theme-canonical";
+/** One entry of the appearance screen's theme gallery (fiche 48) — everything a card shows about a theme. */
+export interface AvailableThemeInfo {
+    readonly name: string;
+    readonly label: string;
+    /**
+     * `manifest.description`, when the theme declares one — the manifest is
+     * the source of truth (fiche 48 task 3: editing `theme.config.ts` alone
+     * changes this, no change to this file needed). Falls back to `label`
+     * for a theme that predates `theme@1.2` or simply omits `description`.
+     */
+    readonly description: string;
+    /** `manifest.version` — the theme contract's own version, not the npm package version (two different numbers; this is the one contract D already models). */
+    readonly version: string;
+    /** `manifest.author`, or `null` for a theme that does not declare one. */
+    readonly author: string | null;
+}
+/** Every theme this instance can offer — what the appearance screen's picker lists. */
+export declare function availableThemes(): Promise<readonly AvailableThemeInfo[]>;
+/**
+ * Resolves the active theme by name, defaulting to
+ * `@cogenta/theme-canonical` for `null`/`undefined`/an unrecognised name — a
+ * site whose stored `activeTheme` names a theme this build no longer ships
+ * (an uninstalled package, a typo restored from a backup) still serves,
+ * rather than refusing every request, which is what R1/R2's "never let an
+ * optional feature take the whole site down" spirit asks for here.
+ *
+ * Each theme's module is imported once and cached for the life of the
+ * process (Node's own ESM cache would do this anyway; the `Map` here just
+ * keys it by name instead of by specifier, and is what lets a second call
+ * with a different name resolve without waiting on the first).
+ */
+export declare function resolveTheme(name: string | null | undefined): Promise<ThemeModule>;
+//# sourceMappingURL=theme-registry.d.ts.map

package/dist/commands/theme-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-registry.d.ts","sourceRoot":"","sources":["../../src/commands/theme-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,aAAa,EACb,gBAAgB,EACjB,MAAM,oBAAoB,CAAA;AAE3B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,CACnB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,CAAC,EAAE,cAAc;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,aAAa,KACrB,WAAW,CAAA;IAChB,QAAQ,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,YAAY,CAAA;IAC3D;;;;;;;;;OASG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,WAAW,CAAA;CACtE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0IAA0I;IAC1I,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAA;IACzC,sKAAsK;IACtK,QAAQ,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAA;KAAE,CAAC,CAAA;CAC1E;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EA6DjD,CAAA;AAED,eAAO,MAAM,kBAAkB,6BAA6B,CAAA;AAI5D,6GAA6G;AAC7G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,6JAA6J;IAC7J,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAYD,uFAAuF;AACvF,wBAAsB,eAAe,IAAI,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAa9E;AAID;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBlF"}

package/dist/commands/theme-registry.js

@@ -0,0 +1,130 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * The theme packages this build of `@cogenta/cli` ships with — a real npm
+ * dependency of this package, never a filesystem scan: `cogenta serve` runs
+ * from a project that installed `@cogenta/cli`, and every theme it can offer
+ * has to be something that installation actually has in `node_modules`.
+ *
+ * Adding a theme package is one entry here, matched by one line in this
+ * package's own `dependencies` — the same "declare it once, the registry
+ * generalises the rest" shape `SITE_SETTINGS_REGISTRY` already uses for site
+ * settings.
+ */
+export const BUILTIN_THEMES = [
+    {
+        name: '@cogenta/theme-canonical',
+        label: 'Canonical',
+        load: () => import('@cogenta/theme-canonical'),
+        loadManifest: () => import('@cogenta/theme-canonical/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-ecommerce',
+        label: 'Storefront',
+        load: () => import('@cogenta/theme-ecommerce'),
+        loadManifest: () => import('@cogenta/theme-ecommerce/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-portfolio',
+        label: 'Portfolio',
+        load: () => import('@cogenta/theme-portfolio'),
+        loadManifest: () => import('@cogenta/theme-portfolio/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-entreprise',
+        label: 'Entreprise',
+        load: () => import('@cogenta/theme-entreprise'),
+        loadManifest: () => import('@cogenta/theme-entreprise/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-magazine',
+        label: 'Magazine',
+        load: () => import('@cogenta/theme-magazine'),
+        loadManifest: () => import('@cogenta/theme-magazine/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-blog',
+        label: 'Blog',
+        load: () => import('@cogenta/theme-blog'),
+        loadManifest: () => import('@cogenta/theme-blog/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-saas',
+        label: 'SaaS',
+        load: () => import('@cogenta/theme-saas'),
+        loadManifest: () => import('@cogenta/theme-saas/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-docs',
+        label: 'Documentation',
+        load: () => import('@cogenta/theme-docs'),
+        loadManifest: () => import('@cogenta/theme-docs/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-restaurant',
+        label: 'Restaurant',
+        load: () => import('@cogenta/theme-restaurant'),
+        loadManifest: () => import('@cogenta/theme-restaurant/theme.config'),
+    },
+    {
+        name: '@cogenta/theme-association',
+        label: 'Association',
+        load: () => import('@cogenta/theme-association'),
+        loadManifest: () => import('@cogenta/theme-association/theme.config'),
+    },
+];
+export const DEFAULT_THEME_NAME = '@cogenta/theme-canonical';
+const BY_NAME = new Map(BUILTIN_THEMES.map((theme) => [theme.name, theme]));
+const manifestCache = new Map();
+function loadManifestOf(theme) {
+    const cached = manifestCache.get(theme.name);
+    if (cached !== undefined)
+        return cached;
+    const promise = theme.loadManifest().then((mod) => mod.default);
+    manifestCache.set(theme.name, promise);
+    return promise;
+}
+/** Every theme this instance can offer — what the appearance screen's picker lists. */
+export async function availableThemes() {
+    return Promise.all(BUILTIN_THEMES.map(async (theme) => {
+        const manifest = await loadManifestOf(theme);
+        return {
+            name: theme.name,
+            label: theme.label,
+            description: manifest.description ?? theme.label,
+            version: manifest.version,
+            author: manifest.author ?? null,
+        };
+    }));
+}
+const loaded = new Map();
+/**
+ * Resolves the active theme by name, defaulting to
+ * `@cogenta/theme-canonical` for `null`/`undefined`/an unrecognised name — a
+ * site whose stored `activeTheme` names a theme this build no longer ships
+ * (an uninstalled package, a typo restored from a backup) still serves,
+ * rather than refusing every request, which is what R1/R2's "never let an
+ * optional feature take the whole site down" spirit asks for here.
+ *
+ * Each theme's module is imported once and cached for the life of the
+ * process (Node's own ESM cache would do this anyway; the `Map` here just
+ * keys it by name instead of by specifier, and is what lets a second call
+ * with a different name resolve without waiting on the first).
+ */
+export function resolveTheme(name) {
+    const theme = (name !== null && name !== undefined ? BY_NAME.get(name) : undefined) ??
+        BY_NAME.get(DEFAULT_THEME_NAME);
+    if (theme === undefined) {
+        throw new CogentaError({
+            code: 'THEME_NOT_FOUND',
+            message: 'No theme is registered, not even the built-in default.',
+            hint: 'This is a packaging error in @cogenta/cli, not a site configuration problem.',
+        });
+    }
+    const cached = loaded.get(theme.name);
+    if (cached !== undefined)
+        return cached;
+    const promise = theme.load();
+    loaded.set(theme.name, promise);
+    return promise;
+}
+//# sourceMappingURL=theme-registry.js.map

package/dist/commands/theme-registry.js.map

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