@c4a/context 0.7.15 → 0.7.17

package/docs/guides/package-outputs.md

@@ -93,8 +93,14 @@ The website uses a full-width VitePress theme with system fonts, compact navigat
 a wide reading area and a smaller article outline. It starts in
 light mode regardless of the operating system; an explicit reader choice is
 remembered in browser storage. Search runs locally, without a search service.
-Mermaid renders in the browser with a restrained theme; invalid diagrams retain
-their source instead of blocking publication. Code samples and raw HTML are
+Mermaid renders in the browser using the website theme, with fit, original-size,
+zoom, full-screen and source controls. Controls appear on hover or keyboard focus
+(and remain visible on touch devices). Layout and source/copy actions are on the
+left, sizing actions on the right. Source view replaces the diagram. Flowcharts default to ELK and can switch to Dagre without changing the article. Offline Review reports use the same
+viewer and include its resources only when a candidate contains Mermaid.
+Article provenance initially shows ten sources; Show more reveals the full list.
+Invalid diagrams and diagrams with embedded image/HTML resources retain their
+source with a rendering notice instead of blocking publication. Code samples and raw HTML are
 displayed as content, not executed as Vue components or scripts.
 
 The accepted `src/knowledge-map.yaml` controls sidebar organization. Entries
@@ -501,3 +507,31 @@ result instead of guessing a hostname. No new workspace configuration is needed.
 The address is an access hint, not proof of publication or content freshness.
 Query Skills use it only to append related links in the final summary, with no
 network probes or version checks. Packages without the map work as before.
+
+### Shared color theme
+
+Website builds create `src/site/theme.json` with the current default light and
+ dark palettes if the file is missing. Edit this optional JSON file to customize
+all websites and offline Review reports in the workspace. It is configuration,
+not a generated HTML file: builds never overwrite existing values. Deleting it
+restores built-in defaults; Review does not need the file or an existing website
+build. The next website build recreates it.
+
+Each `light`/`dark` object supports `brand`, `accent`, `background`, `surface`,
+`text`, `mutedText`, and `border`. Values are hexadecimal CSS colors (`#RGB`,
+`#RRGGBB`, or `#RRGGBBAA`). Partial objects inherit missing default colors. Invalid
+JSON or colors produce a configuration error identifying the optional file.
+
+A package may override these colors through `kbPackage({ site: { theme: {
+light: { brand: "#6750a4" }, dark: { brand: "#d0bcff" }
+} } })`. Precedence is built-in defaults, workspace file, then `site.theme`.
+A Review with one website package uses that package's overrides. With multiple
+website packages it uses the shared workspace theme, without selecting an
+arbitrary package. New/Modify/approve/reject status colors remain independent.
+
+The compiler projects tokens into VitePress and standalone Review CSS. Mermaid
+reads the same resolved colors. Changes to the theme invalidate website build
+receipts. Arbitrary extension CSS is not copied into Review; custom components
+can consume `--context-brand`, `--context-accent`, `--context-background`,
+`--context-surface`, `--context-text`, `--context-muted-text`, and
+`--context-border` rather than hard-coding colors.

package/index.d.ts

@@ -1,3 +1,4 @@
+export { siteThemeSchema, DEFAULT_SITE_THEME, type SiteTheme, type SiteThemeColors } from "./siteTheme.js";
 import { type PackageSiteDefinition } from "./packageSite.js";
 export { packageSiteSchema, type PackageSiteDefinition } from "./packageSite.js";
 import type { PackageNavigationDefinition, PackageSelectDefinition } from "./contracts.js";

package/index.js

@@ -10888,6 +10888,22 @@ var coerce = {
   date: (arg) => ZodDate.create({ ...arg, coerce: true })
 };
 var NEVER = INVALID;
+// src/siteTheme.ts
+var color = exports_external.string().regex(/^#(?:[\da-f]{3}|[\da-f]{6}|[\da-f]{8})$/iu, "Use a hexadecimal CSS color (#RGB, #RRGGBB or #RRGGBBAA)");
+var siteThemeColorsSchema = exports_external.object({
+  brand: color.optional(),
+  accent: color.optional(),
+  background: color.optional(),
+  surface: color.optional(),
+  text: color.optional(),
+  mutedText: color.optional(),
+  border: color.optional()
+}).strict();
+var siteThemeSchema = exports_external.object({ light: siteThemeColorsSchema.optional(), dark: siteThemeColorsSchema.optional() }).strict();
+var DEFAULT_SITE_THEME = {
+  light: { brand: "#2563eb", accent: "#00bec8", background: "#ffffff", surface: "#f8f9fc", text: "#161e2e", mutedText: "#646b7c", border: "#e7e9ef" },
+  dark: { brand: "#8eb7ff", accent: "#b3cfff", background: "#171b24", surface: "#1b1d24", text: "#e2e4ed", mutedText: "#a1a6b7", border: "#303440" }
+};
 // src/packageSite.ts
 var siteHrefSchema = exports_external.string().trim().min(1).refine((value) => /^(?:https?:\/\/|mailto:|\/(?!\/)|#)/u.test(value), "Use an https URL, mailto URL, root-relative path, or page anchor");
 var packageSiteHomeActionSchema = exports_external.object({
@@ -10913,6 +10929,7 @@ var packageSiteHomeSchema = exports_external.object({
   resources: exports_external.array(packageSiteHomeResourceSchema).optional()
 }).strict();
 var packageSiteSchema = exports_external.object({
+  theme: siteThemeSchema.optional(),
   title: exports_external.string().trim().min(1).optional(),
   description: exports_external.string().optional(),
   lang: exports_external.string().min(1).default("en-US"),
@@ -32413,6 +32430,7 @@ export {
   startIndexerMainRun,
   sourceUpdateSemanticInputSchema,
   source,
+  siteThemeSchema,
   sessionChangesSchema,
   sessionChangeSchema,
   sameIndexerParserExecutionPlan,
@@ -32987,6 +33005,7 @@ export {
   DOCUMENT_SECTION_CONTENT_MODES,
   DOCUMENT_EVIDENCE_SECTION_VALIDATION_STAGES,
   DOCUMENT_COMPILE_ACTION_SCHEMA_VERSION,
+  DEFAULT_SITE_THEME,
   DEFAULT_REPO_SOURCES_REGISTRY_PATH,
   DEFAULT_PACKAGE_NAVIGATION,
   DEFAULT_LARK_SOURCES_REGISTRY_PATH,

package/indexerArtifactPolicy.d.ts

@@ -10,11 +10,11 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
         path: z.ZodString;
         value: z.ZodType<IndexerJson, z.ZodTypeDef, IndexerJson>;
     }, "strict", z.ZodTypeAny, {
-        path: string;
         value: IndexerJson;
-    }, {
         path: string;
+    }, {
         value: IndexerJson;
+        path: string;
     }>, "many">;
     provider_supported_variants: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
     eligible_variants: z.ZodArray<z.ZodObject<{
@@ -71,8 +71,8 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
     profile_id: string;
     profile_contract_digest: string;
     canonical_facts: {
-        path: string;
         value: IndexerJson;
+        path: string;
     }[];
     provider_supported_variants: string[];
     eligible_variants: {
@@ -94,8 +94,8 @@ export declare const indexerArtifactPolicyEligibilitySchema: z.ZodObject<{
     profile_id: string;
     profile_contract_digest: string;
     canonical_facts: {
-        path: string;
         value: IndexerJson;
+        path: string;
     }[];
     provider_supported_variants: string[];
     eligible_variants: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context",
-  "version": "0.7.15",
+  "version": "0.7.17",
   "type": "module",
   "description": "Declarative SDK for Context knowledge sources, workflows, review, and package outputs",
   "license": "MIT",

package/packageSite.d.ts

@@ -1,6 +1,96 @@
 import { z } from "zod";
 /** Static website in a sibling dist/<name-without-trailing-kb>-site directory. */
 export declare const packageSiteSchema: z.ZodObject<{
+    theme: z.ZodOptional<z.ZodObject<{
+        light: z.ZodOptional<z.ZodObject<{
+            brand: z.ZodOptional<z.ZodString>;
+            accent: z.ZodOptional<z.ZodString>;
+            background: z.ZodOptional<z.ZodString>;
+            surface: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            mutedText: z.ZodOptional<z.ZodString>;
+            border: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        }, {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        }>>;
+        dark: z.ZodOptional<z.ZodObject<{
+            brand: z.ZodOptional<z.ZodString>;
+            accent: z.ZodOptional<z.ZodString>;
+            background: z.ZodOptional<z.ZodString>;
+            surface: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            mutedText: z.ZodOptional<z.ZodString>;
+            border: z.ZodOptional<z.ZodString>;
+        }, "strict", z.ZodTypeAny, {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        }, {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        light?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+        dark?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+    }, {
+        light?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+        dark?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+    }>>;
     title: z.ZodOptional<z.ZodString>;
     description: z.ZodOptional<z.ZodString>;
     lang: z.ZodDefault<z.ZodString>;
@@ -140,6 +230,26 @@ export declare const packageSiteSchema: z.ZodObject<{
 }, "strict", z.ZodTypeAny, {
     lang: string;
     base: string;
+    theme?: {
+        light?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+        dark?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+    } | undefined;
     title?: string | undefined;
     description?: string | undefined;
     home?: {
@@ -172,6 +282,26 @@ export declare const packageSiteSchema: z.ZodObject<{
         pages?: Record<string, string> | undefined;
     } | undefined;
 }, {
+    theme?: {
+        light?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+        dark?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+    } | undefined;
     title?: string | undefined;
     description?: string | undefined;
     lang?: string | undefined;
@@ -210,6 +340,26 @@ export type PackageSiteDefinition = z.input<typeof packageSiteSchema>;
 export declare function normalizePackageSite(value: PackageSiteDefinition | undefined): {
     lang: string;
     base: string;
+    theme?: {
+        light?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+        dark?: {
+            brand?: string | undefined;
+            accent?: string | undefined;
+            background?: string | undefined;
+            surface?: string | undefined;
+            text?: string | undefined;
+            mutedText?: string | undefined;
+            border?: string | undefined;
+        } | undefined;
+    } | undefined;
     title?: string | undefined;
     description?: string | undefined;
     home?: {

package/siteTheme.d.ts

@@ -0,0 +1,122 @@
+import { z } from "zod";
+export declare const siteThemeColorsSchema: z.ZodObject<{
+    brand: z.ZodOptional<z.ZodString>;
+    accent: z.ZodOptional<z.ZodString>;
+    background: z.ZodOptional<z.ZodString>;
+    surface: z.ZodOptional<z.ZodString>;
+    text: z.ZodOptional<z.ZodString>;
+    mutedText: z.ZodOptional<z.ZodString>;
+    border: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    brand?: string | undefined;
+    accent?: string | undefined;
+    background?: string | undefined;
+    surface?: string | undefined;
+    text?: string | undefined;
+    mutedText?: string | undefined;
+    border?: string | undefined;
+}, {
+    brand?: string | undefined;
+    accent?: string | undefined;
+    background?: string | undefined;
+    surface?: string | undefined;
+    text?: string | undefined;
+    mutedText?: string | undefined;
+    border?: string | undefined;
+}>;
+export declare const siteThemeSchema: z.ZodObject<{
+    light: z.ZodOptional<z.ZodObject<{
+        brand: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        mutedText: z.ZodOptional<z.ZodString>;
+        border: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    }, {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    }>>;
+    dark: z.ZodOptional<z.ZodObject<{
+        brand: z.ZodOptional<z.ZodString>;
+        accent: z.ZodOptional<z.ZodString>;
+        background: z.ZodOptional<z.ZodString>;
+        surface: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        mutedText: z.ZodOptional<z.ZodString>;
+        border: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    }, {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    light?: {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    } | undefined;
+    dark?: {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    } | undefined;
+}, {
+    light?: {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    } | undefined;
+    dark?: {
+        brand?: string | undefined;
+        accent?: string | undefined;
+        background?: string | undefined;
+        surface?: string | undefined;
+        text?: string | undefined;
+        mutedText?: string | undefined;
+        border?: string | undefined;
+    } | undefined;
+}>;
+export type SiteTheme = z.infer<typeof siteThemeSchema>;
+export type SiteThemeColors = Required<z.infer<typeof siteThemeColorsSchema>>;
+export declare const DEFAULT_SITE_THEME: {
+    light: SiteThemeColors;
+    dark: SiteThemeColors;
+};