@riebeckite/honox 0.0.26 → 0.0.28

package/dist/src/ssg/build_output.d.ts

@@ -0,0 +1,15 @@
+export type ClientBuildArtifacts = {
+    stagingDirectory: string;
+    paths: readonly string[];
+    manifestFingerprint: string;
+};
+export declare const CLOUDFLARE_WORKER_ASSET_LIMIT: number;
+export declare function findOversizedAssets(directory: string, relativeDirectory?: string): Promise<{
+    path: string;
+    size: number;
+}[]>;
+export declare function formatBytes(bytes: number): string;
+export declare function emptyBuildOutputDirectory(outDir: string): Promise<void>;
+export declare function preserveClientBuildArtifacts(outDir: string): Promise<ClientBuildArtifacts | undefined>;
+export declare function restoreClientBuildArtifacts(outDir: string, artifacts: ClientBuildArtifacts | undefined): Promise<void>;
+export declare function discardClientBuildArtifacts(artifacts: ClientBuildArtifacts | undefined): Promise<void>;

package/dist/src/ssg/diagnostics.d.ts

@@ -0,0 +1,24 @@
+import type { SsgModule } from "./types.js";
+export declare function formatSsrNoExternal(): string;
+export declare function logSsgDiagnostics(logger: {
+    info(message: string): void;
+}, message: string): void;
+export declare function logGeneratedHtmlAssetDiagnostics(logger: {
+    info(message: string): void;
+}, pages: readonly {
+    path: string;
+    html: string;
+}[]): void;
+/**
+ * Runs post-SSG HTML inspections contributed by Core plugins. Structural rules
+ * that need the whole document (a11y, duplicate ids, anchors) cannot see the
+ * final page during the Core lifecycle, so `@riebeckite/honox` forwards every
+ * emitted HTML file to plugins that declare `inspectGeneratedHtml`.
+ */
+export declare function inspectGeneratedHtmlPages(module: SsgModule, pages: readonly {
+    path: string;
+    html: string;
+}[], log: {
+    warn: (message: string) => void;
+    info: (message: string) => void;
+}): void;

package/dist/src/ssg/file_system.d.ts

@@ -0,0 +1,4 @@
+export declare function isMissingDirectoryError(error: unknown): boolean;
+export declare function isNotFoundError(error: unknown): boolean;
+export declare function isAbsolutePath(path: string): boolean;
+export declare function resolveWithinDirectory(directory: string, relativePath: string, label: string): string;

package/dist/src/ssg/inventory.d.ts

@@ -0,0 +1,5 @@
+import type { NoChangeFastPathOutputMetrics } from "./types.js";
+export declare function computeAppFingerprint(root: string, configFile: string | undefined): Promise<string>;
+export declare function fingerprintDirectory(directory: string): Promise<string>;
+export declare function fingerprintOutputDirectory(directory: string, relativeDirectory?: string, metrics?: NoChangeFastPathOutputMetrics): Promise<Record<string, string>>;
+export declare function inventoriesEqual(left: Record<string, string>, right: Record<string, string>): boolean;

package/dist/src/ssg/output_cache.d.ts

@@ -0,0 +1,29 @@
+import type { NoChangeFastPathOutputMetrics, NoChangeFastPathResult, OutputCacheDecision, OutputCacheRejectionReason } from "./types.js";
+export type OutputCacheEntry = {
+    cachePath: string;
+    checksum: string;
+};
+export type OutputCacheState = {
+    version: 4;
+    appFingerprint?: string;
+    clientManifestFingerprint?: string;
+    outputs: Record<string, OutputCacheEntry>;
+    finalOutputInventory?: Record<string, string>;
+    publicDirectory?: string;
+    publicFingerprint?: string;
+    configFile?: string;
+};
+export declare function decideOutputCacheRejection(decision: OutputCacheDecision): OutputCacheRejectionReason | undefined;
+export declare function createNoChangeFastPathOutputMetrics(): NoChangeFastPathOutputMetrics;
+export declare function verifyNoChangeFastPath(input: {
+    readonly root: string;
+    readonly outputDirectory: string;
+    readonly expectedOutputPaths: readonly string[];
+    readonly metrics?: NoChangeFastPathOutputMetrics;
+}): Promise<NoChangeFastPathResult>;
+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, outputDirectory: string, timingsMs?: Record<string, number>): Promise<string>;
+export declare function decodeOutput(outputCachePath: string, entry: OutputCacheEntry): Promise<Uint8Array>;
+export declare function waitForFaultInjection(point: string): Promise<void>;

package/dist/src/ssg/runtime_metrics.d.ts

@@ -0,0 +1,4 @@
+import type { SsgOutputMetrics } from "./types.js";
+export declare function measure<T>(timingsMs: Record<string, number> | undefined, name: string, fn: () => Promise<T>): Promise<T>;
+export declare function measureSync<T>(timingsMs: Record<string, number> | undefined, name: string, fn: () => T): T;
+export declare function writeSsgOutputMetrics(metrics: SsgOutputMetrics): Promise<void>;

package/dist/src/ssg/types.d.ts

@@ -0,0 +1,122 @@
+import type { toSSG } from "hono/ssg";
+export type GeneratedOutputAsset = {
+    type: "asset";
+    fileName: string;
+    source: string | Uint8Array;
+};
+export type SsgGeneratedHtmlDiagnostic = {
+    severity: "info" | "warning" | "error";
+    message: string;
+    code?: string;
+    filePath?: string;
+};
+export type SsgHtmlInspectorPlugin = {
+    name?: string;
+    inspectGeneratedHtml?: (page: {
+        path: string;
+        html: string;
+    }) => readonly SsgGeneratedHtmlDiagnostic[];
+};
+export type SsgModule = {
+    default: Parameters<typeof toSSG>[0];
+    content?: {
+        getManifest(): Promise<{
+            generatedOutputs?: readonly {
+                path: string;
+                content: string | Uint8Array;
+            }[];
+        }>;
+        getProcessedContentCount(): number;
+        getReusedContentCount(): number;
+        getManifestHookMetrics(): {
+            manifestHooksExecuted: number;
+            manifestHooksReused: number;
+            manifestHookCacheHit: number;
+            manifestHookCacheMiss: number;
+            manifestHookDurationMs: number;
+            byPlugin: Record<string, {
+                executed: number;
+                reused: number;
+                cacheHit: number;
+                cacheMiss: number;
+                durationMs: number;
+                reason: string;
+            }>;
+        };
+        getOutputChangeSet(): Promise<{
+            affected: readonly {
+                kind: string;
+                path: string;
+            }[];
+            removed: readonly {
+                kind: string;
+                path: string;
+            }[];
+            unchanged: readonly {
+                kind: string;
+                path: string;
+            }[];
+            fullRegenerationRequired: boolean;
+            candidateOutputCount: number;
+            affectedOutputCount: number;
+            removedOutputCount: number;
+            unchangedOutputCount: number;
+        }>;
+    };
+    config?: {
+        plugins?: readonly SsgHtmlInspectorPlugin[];
+    };
+};
+export type SsgOutputChangeSet = NonNullable<SsgModule["content"]> extends {
+    getOutputChangeSet(): Promise<infer T>;
+} ? T : never;
+export type SsgOutputMetrics = {
+    processedContentCount: number;
+    reusedContentCount: number;
+    candidateOutputCount: number;
+    affectedOutputCount: number;
+    removedOutputCount: number;
+    unchangedOutputCount: number;
+    renderedOutputCount: number;
+    emittedOutputCount: number;
+    reusedOutputCount: number;
+    deletedOutputCount: number;
+    shadowedOutputCount: number;
+    fullRegenerationRequired: boolean;
+    htmlOutputCount: number;
+    assetOutputCount: number;
+    cacheFileSizeBytes: number | null;
+    cacheEntriesRead: number;
+    cacheEntriesSerialized: number;
+    enumeratedRouteCount: number;
+    renderedRouteCount: number;
+    skippedRouteCount: number;
+    manifestHooksExecuted: number;
+    manifestHooksReused: number;
+    manifestHookCacheHit: number;
+    manifestHookCacheMiss: number;
+    manifestHookDurationMs: number;
+    manifestHookPlugins: Record<string, unknown>;
+    outputCacheDecision: OutputCacheDecision;
+    outputCacheRejectionReason: OutputCacheRejectionReason | null;
+    timingsMs: Record<string, number>;
+};
+export type OutputCacheRejectionReason = "change-set-unavailable" | "full-regeneration-required" | "output-cache-missing-or-invalid" | "app-fingerprint-changed" | "client-manifest-fingerprint-changed" | "unchanged-output-not-cached";
+export type OutputCacheDecision = {
+    readonly changeSetPresent: boolean;
+    readonly changeSetRequiresFullRegeneration: boolean;
+    readonly outputCacheLoaded: boolean;
+    readonly appFingerprintMatch: boolean;
+    readonly clientManifestFingerprintMatch: boolean;
+    readonly uncoveredUnchangedCount: number;
+};
+export type NoChangeFastPathResult = {
+    readonly used: boolean;
+    readonly blockReason?: string;
+};
+export type NoChangeFastPathOutputMetrics = {
+    outputInventoryValidationDurationMs: number;
+    outputHashValidationDurationMs: number;
+    outputFilesHashed: number;
+    outputBytesHashed: number;
+};

package/dist/src/ssg_plugin.d.ts

@@ -1,48 +1,14 @@
 import { toSSG } from "hono/ssg";
 import { type ConfigEnv, type Plugin } from "vite";
+export { emptyBuildOutputDirectory } from "./ssg/build_output.js";
+export { createNoChangeFastPathOutputMetrics, decideOutputCacheRejection, loadOutputCache, saveOutputCache, verifyNoChangeFastPath, } from "./ssg/output_cache.js";
+export type { NoChangeFastPathOutputMetrics, NoChangeFastPathResult, OutputCacheDecision, OutputCacheRejectionReason, } from "./ssg/types.js";
 type ToSsgOptions = NonNullable<Parameters<typeof toSSG>[2]>;
-type OutputCacheEntry = {
-    cachePath: string;
-    checksum: string;
-};
-type OutputCacheState = {
-    version: 4;
-    appFingerprint?: string;
-    clientManifestFingerprint?: string;
-    outputs: Record<string, OutputCacheEntry>;
-    finalOutputInventory?: Record<string, string>;
-    publicDirectory?: string;
-    publicFingerprint?: string;
-    configFile?: string;
-};
-export type NoChangeFastPathResult = {
-    readonly used: boolean;
-    readonly blockReason?: string;
-};
-export type NoChangeFastPathOutputMetrics = {
-    outputInventoryValidationDurationMs: number;
-    outputHashValidationDurationMs: number;
-    outputFilesHashed: number;
-    outputBytesHashed: number;
-};
-export declare function createNoChangeFastPathOutputMetrics(): NoChangeFastPathOutputMetrics;
 export type RiebeckiteSsgOptions = {
     entry?: string;
     plugins?: ToSsgOptions["plugins"];
     extensionMap?: Record<string, string>;
 };
 export declare function riebeckiteSsg(options?: RiebeckiteSsgOptions): Plugin;
-export declare function emptyBuildOutputDirectory(outDir: string): Promise<void>;
 export declare function shouldApplyRiebeckiteSsg(_config: unknown, env: ConfigEnv): boolean;
 export declare function findBuildOutputSiteCollisions(buildOutputPaths: Iterable<string>, siteOwnedOutputPaths: ReadonlySet<string>): readonly string[];
-export declare function verifyNoChangeFastPath(input: {
-    readonly root: string;
-    readonly outputDirectory: string;
-    readonly expectedOutputPaths: readonly string[];
-    readonly metrics?: NoChangeFastPathOutputMetrics;
-}): Promise<NoChangeFastPathResult>;
-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, outputDirectory: string, timingsMs?: Record<string, number>): Promise<string>;
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riebeckite/honox",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,13 +44,13 @@
     "hono": "^4.12.25",
     "honox": "0.1.56",
     "vite": "^8.0.9",
-    "@riebeckite/core": "0.0.26",
-    "@riebeckite/plugin-color-mode": "0.0.26",
-    "@riebeckite/ui": "0.0.26"
+    "@riebeckite/core": "0.0.28",
+    "@riebeckite/ui": "0.0.28",
+    "@riebeckite/plugin-color-mode": "0.0.28"
   },
   "devDependencies": {
     "tsx": "^4.22.4",
-    "@riebeckite/test": "0.0.26"
+    "@riebeckite/test": "0.0.28"
   },
   "publishConfig": {
     "access": "public"

package/style.css

@@ -1,3 +1,17 @@
+@layer base, components;
+
+@layer base {
+  *,
+  *::before,
+  *::after {
+    box-sizing: border-box;
+  }
+
+  body {
+    margin: 0;
+  }
+}
+
 @layer components {
   .rb-article-layout {
     display: grid;