@riebeckite/honox 0.0.13 → 0.0.15

package/dist/server.d.ts

@@ -1,3 +1,3 @@
 export type { ResolvedContentRoute, ResolvedRiebeckiteRoute, } from "./src/content_route.js";
-export { contentRouteSsgParams, pluginPageSsgParams, resolveContentRoute, resolveRiebeckiteRoute, ssgEnumerableHandler, } from "./src/content_route.js";
+export { contentRouteSsgParams, pluginPageSsgParams, resolveContentRoute, resolveRiebeckiteRoute, riebeckiteSsgParams, ssgEnumerableHandler, } from "./src/content_route.js";
 export { mountRiebeckiteEndpoints } from "./src/endpoints.js";

package/dist/server.js

@@ -1,4 +1,5 @@
 // src/content_route.ts
+import { htmlOutputPath } from "@riebeckite/core";
 async function resolveRiebeckiteRoute(content, pathname) {
   const page = await content.resolvePage(pathname);
   if (page) return { kind: "page", page };
@@ -8,9 +9,27 @@ async function pluginPageSsgParams(content, parameter = "slug") {
   const paths = await content.getPagePaths();
   return paths.filter((path) => path !== "/").map((path) => ({ [parameter]: path.replace(/^\/+/, "") }));
 }
+async function riebeckiteSsgParams(content, parameter = "slug") {
+  const [manifest, changeSet] = await Promise.all([
+    content.getManifest({ incremental: true }),
+    content.getOutputChangeSet({ incremental: true })
+  ]);
+  if (changeSet.fullRegenerationRequired || process.env.RIEBECKITE_SSG_FULL_REGENERATION === "1") {
+    return [
+      ...manifest.publicEntries.filter((entry) => entry.permalink !== "/").map((entry) => ({ [parameter]: entry.permalink.replace(/^\/+/, "") })),
+      ...await pluginPageSsgParams(content, parameter)
+    ];
+  }
+  const affected = new Set(
+    changeSet.affected.filter((output) => output.kind !== "generated").map((output) => output.path)
+  );
+  const contentParams = manifest.publicEntries.filter((entry) => affected.has(routeOutputPath(entry.permalink))).map((entry) => ({ [parameter]: entry.permalink.replace(/^\/+/, "") }));
+  const pluginPageParams = (await content.getPagePaths()).filter((path) => affected.has(routeOutputPath(path))).filter((path) => path !== "/").map((path) => ({ [parameter]: path.replace(/^\/+/, "") }));
+  return [...contentParams, ...pluginPageParams];
+}
 function resolveContentRoute(manifest, pathname) {
   const path = normalizeRequestPath(pathname);
-  const entry = manifest.byPermalink.get(path);
+  const entry = manifest.byRoutablePermalink.get(path);
   if (entry) return { kind: "content", entry };
   const redirect = manifest.redirects.get(path);
   if (!redirect) return null;
@@ -45,6 +64,9 @@ function normalizeRequestPath(pathname) {
   const path = `/${segments.join("/")}`;
   return trailingSlash ? `${path}/` : path;
 }
+function routeOutputPath(pathname) {
+  return htmlOutputPath(normalizeRequestPath(pathname));
+}
 function decodeSegment(segment) {
   try {
     return decodeURIComponent(segment);
@@ -171,5 +193,6 @@ export {
   pluginPageSsgParams,
   resolveContentRoute,
   resolveRiebeckiteRoute,
+  riebeckiteSsgParams,
   ssgEnumerableHandler
 };

package/dist/src/content_assets.d.ts

@@ -0,0 +1,19 @@
+import type { Plugin } from "vite";
+export type RiebeckiteContentAssetsOptions = {
+    appRoot: () => string;
+    contentRoot: () => string;
+};
+type ContentAssetEntry = {
+    assets?: ReadonlyArray<{
+        path: string;
+    }>;
+};
+type PublicContentManifest = {
+    publicEntries?: ReadonlyArray<ContentAssetEntry>;
+};
+export declare function riebeckiteContentAssets(options: RiebeckiteContentAssetsOptions): Plugin;
+export declare function collectPublicImagePaths(manifest: PublicContentManifest): Set<string>;
+export declare function collectSiteOwnedOutputPaths(publicDir: string | false | undefined): Promise<Set<string>>;
+export declare function toContentPath(url: string | undefined, base: string): string | undefined;
+export declare function imageContentType(logicalPath: string): string | undefined;
+export {};

package/dist/src/content_route.d.ts

@@ -20,6 +20,7 @@ export type ResolvedRiebeckiteRoute = Exclude<ResolvedContentRoute, null> | {
 export declare function resolveRiebeckiteRoute(content: Pick<ContentManager, "resolvePage" | "getManifest">, pathname: string): Promise<ResolvedRiebeckiteRoute>;
 /** Returns catch-all parameters for every plugin page registered for SSG. */
 export declare function pluginPageSsgParams(content: Pick<ContentManager, "getPagePaths">, parameter?: string): Promise<Record<string, string>[]>;
+export declare function riebeckiteSsgParams(content: Pick<ContentManager, "getManifest" | "getOutputChangeSet" | "getPagePaths">, parameter?: string): Promise<Record<string, string>[]>;
 export declare function resolveContentRoute(manifest: ContentManifest, pathname: string): ResolvedContentRoute;
 type SsgParams = Record<string, string>[];
 /**

package/dist/src/content_watch.d.ts

@@ -0,0 +1,11 @@
+import type { Plugin, ViteDevServer } from "vite";
+export type RiebeckiteContentWatchOptions = {
+    appRoot: () => string;
+    contentRoot: () => string;
+    exclude: () => readonly string[];
+};
+export declare function riebeckiteContentWatch(options: RiebeckiteContentWatchOptions): Plugin;
+export declare function isSiteAssetPath(logicalPath: string): boolean;
+export declare function isPathInsideDirectory(directory: string, file: string): boolean;
+export declare function toLogicalPath(directory: string, file: string): string;
+export declare function invalidateApplicationRuntime(server: Pick<ViteDevServer, "environments">, appRoot: string): number;

package/dist/src/scaffold/app-templates.d.ts

@@ -12,4 +12,4 @@ export declare function renderer(preset: ScaffoldPreset): string;
 export declare function bareRenderer(): string;
 export declare function indexRoute(preset: ScaffoldPreset): string;
 export declare function staticIndexRoute(): string;
-export declare function slugRoute(): string;
+export declare function slugRoute(preset: ScaffoldPreset): string;

package/dist/src/scaffold/next-steps.d.ts

@@ -1 +1,7 @@
-export declare function formatScaffoldNextSteps(relativeDirectory: string): string;
+export type ScaffoldNextStepsOptions = {
+    /** First Markdown file to edit, when the scaffold wrote one. */
+    readonly editFile?: string;
+    /** The site keeps its content in a separate repository. */
+    readonly externalContent?: boolean;
+};
+export declare function formatScaffoldNextSteps(relativeDirectory: string, options?: ScaffoldNextStepsOptions): string;

package/dist/src/scaffold/version.d.ts

@@ -1 +1 @@
-export declare const RIEBECKITE_VERSION = "^0.0.13";
+export declare const RIEBECKITE_VERSION = "^0.0.15";

package/dist/src/scaffold/wrangler-defaults.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Single source of truth for Wrangler configuration defaults.
+ *
+ * This module is imported by:
+ * - scaffold generator (deployment.ts)
+ * - contract tests (to verify generated output)
+ * - templates/cloudflare/wrangler.jsonc is the human-readable canonical form
+ *
+ * When updating these values, update all three places:
+ * 1. This file (the programmatic source of truth)
+ * 2. templates/cloudflare/wrangler.jsonc (the human-readable template)
+ * 3. Contract tests will verify consistency automatically
+ */
+export declare const WRANGLER_DEFAULTS: {
+    /** JSON schema for IDE support and validation */
+    readonly $schema: "node_modules/wrangler/config-schema.json";
+    /** Worker name - becomes <name>.<account>.workers.dev */
+    readonly name: "riebeckite-site";
+    /** Compatibility date - update when Workers runtime changes require it */
+    readonly compatibility_date: "2026-06-09";
+    /** Required for Node.js APIs used by Riebeckite */
+    readonly compatibility_flags: readonly ["nodejs_compat"];
+    /** Static assets directory - Riebeckite builds to ./dist */
+    readonly assets: {
+        readonly directory: "./dist";
+    };
+};
+/** Type for the wrangler config object */
+export type WranglerDefaults = typeof WRANGLER_DEFAULTS;
+/** Expected secret names in GitHub Actions workflow */
+export declare const GITHUB_ACTIONS_SECRETS: {
+    /** Cloudflare API token with Workers Scripts: Edit permission */
+    readonly CLOUDFLARE_API_TOKEN: "CLOUDFLARE_API_TOKEN";
+    /** Cloudflare Account ID (found in Workers & Pages dashboard URL) */
+    readonly CLOUDFLARE_ACCOUNT_ID: "CLOUDFLARE_ACCOUNT_ID";
+    /** Optional: Token for content repo to dispatch to site repo */
+    readonly SITE_DISPATCH_TOKEN: "SITE_DISPATCH_TOKEN";
+    /** Optional: Token for site repo to read content repo */
+    readonly RIEBECKITE_CONTENT_READ_TOKEN: "RIEBECKITE_CONTENT_READ_TOKEN";
+};
+/** Package manager used by generated sites and workflows */
+export declare const PACKAGE_MANAGER: "npm";
+/** Lockfile name that must be committed */
+export declare const LOCKFILE_NAME: "package-lock.json";
+/** Files/directories that must be in .gitignore */
+export declare const GITIGNORE_REQUIRED: readonly ["node_modules/", "dist/", ".riebeckite/", "app/.riebeckite/"];
+/** Files that must NOT be in .gitignore */
+export declare const GITIGNORE_FORBIDDEN: readonly ["package-lock.json"];
+/** Default preset name used by create-riebeckite */
+export declare const DEFAULT_PRESET: "starter";
+/** Starter preset content pages (base names without language suffixes) */
+export declare const STARTER_CONTENT_PAGES: readonly ["index", "guide", "examples", "notes/planning", "notes/writing"];
+/** Starter preset languages */
+export declare const STARTER_LANGUAGES: readonly ["en", "ja", "zh-CN", "es", "de", "fr", "ko"];

package/dist/src/ssg_plugin.d.ts

@@ -1,10 +1,25 @@
 import { toSSG } from "hono/ssg";
-import { type Plugin } from "vite";
+import { type ConfigEnv, type Plugin } from "vite";
 type ToSsgOptions = NonNullable<Parameters<typeof toSSG>[2]>;
+type OutputCacheEntry = {
+    source: string;
+    encoding: "utf8" | "base64";
+};
+type OutputCacheState = {
+    version: 1;
+    appFingerprint?: string;
+    outputs: Record<string, OutputCacheEntry>;
+};
 export type RiebeckiteSsgOptions = {
     entry?: string;
     plugins?: ToSsgOptions["plugins"];
     extensionMap?: Record<string, string>;
 };
 export declare function riebeckiteSsg(options?: RiebeckiteSsgOptions): Plugin;
+export declare function shouldApplyRiebeckiteSsg(_config: unknown, env: ConfigEnv): boolean;
+export declare function findBuildOutputSiteCollisions(buildOutputPaths: Iterable<string>, siteOwnedOutputPaths: ReadonlySet<string>): readonly string[];
+export declare function loadOutputCache(path: string, timingsMs?: Record<string, number>, log?: (message: string) => void): Promise<(OutputCacheState & {
+    fileSizeBytes?: number;
+}) | undefined>;
+export declare function saveOutputCache(path: string, state: OutputCacheState, timingsMs?: Record<string, number>): Promise<void>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/honox",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -36,7 +36,7 @@
     "esbuild": "^0.28.2",
     "hono": "^4.12.25",
     "vite": "^8.0.9",
-    "@riebeckite/core": "0.0.13"
+    "@riebeckite/core": "0.0.15"
   },
   "publishConfig": {
     "access": "public"