@treeseed/core 0.8.8 → 0.8.10

package/dist/utils/color-schemes/shared.js

@@ -0,0 +1,33 @@
+function completeTokens(tokens, mode) {
+  return {
+    ...tokens,
+    surfaceOverlay: mode === "dark" ? "rgba(7, 12, 8, 0.72)" : "rgba(255, 255, 255, 0.88)",
+    textSubtle: tokens.textMuted,
+    textInverse: mode === "dark" ? "#11170f" : "#ffffff",
+    link: tokens.info,
+    linkHover: tokens.accentHover,
+    borderMuted: tokens.border,
+    focus: tokens.info,
+    accentText: mode === "dark" ? "#10170f" : "#ffffff",
+    infoSoft: mode === "dark" ? colorMix(tokens.info, tokens.canvas, 22) : colorMix(tokens.info, tokens.surface, 18),
+    infoText: tokens.info,
+    infoBorder: colorMix(tokens.info, tokens.border, mode === "dark" ? 48 : 42),
+    successSoft: mode === "dark" ? colorMix(tokens.success, tokens.canvas, 24) : colorMix(tokens.success, tokens.surface, 18),
+    successText: tokens.success,
+    successBorder: colorMix(tokens.success, tokens.border, mode === "dark" ? 48 : 42),
+    warningSoft: mode === "dark" ? colorMix(tokens.warning, tokens.canvas, 24) : colorMix(tokens.warning, tokens.surface, 18),
+    warningText: tokens.warning,
+    warningBorder: colorMix(tokens.warning, tokens.border, mode === "dark" ? 48 : 42),
+    dangerSoft: mode === "dark" ? colorMix(tokens.danger, tokens.canvas, 24) : colorMix(tokens.danger, tokens.surface, 16),
+    dangerText: tokens.danger,
+    dangerBorder: colorMix(tokens.danger, tokens.border, mode === "dark" ? 48 : 42),
+    shadow: mode === "dark" ? "0 16px 36px rgba(0, 0, 0, 0.28)" : "0 1px 2px rgba(31, 35, 40, 0.08)",
+    grid: mode === "dark" ? "rgba(160, 180, 150, 0.12)" : "rgba(80, 100, 74, 0.12)"
+  };
+}
+function colorMix(first, second, firstPercent) {
+  return `color-mix(in srgb, ${first} ${firstPercent}%, ${second})`;
+}
+export {
+  completeTokens
+};

package/dist/utils/color-schemes/tidepool.js

@@ -0,0 +1,53 @@
+import { completeTokens } from "./shared.js";
+const tidepoolScheme = {
+  id: "tidepool",
+  name: "Tidepool Dusk",
+  swatches: ["#3f8582", "#286462", "#ffffff", "#1d2928"],
+  modeSwatches: {
+    light: ["#3f8582", "#286462", "#ffffff", "#1d2928"],
+    dark: ["#73c5bd", "#b8eee8", "#162123", "#e2eeee"]
+  },
+  tokens: {
+    light: completeTokens({
+      canvas: "#eff7f5",
+      canvasSubtle: "#dfecea",
+      surface: "#ffffff",
+      surfaceMuted: "#dfecea",
+      surfaceRaised: "#f7fbfa",
+      text: "#1d2928",
+      textMuted: "#4f615f",
+      border: "#c9d9d7",
+      borderStrong: "#a9bfbc",
+      accent: "#3f8582",
+      accentHover: "#32726f",
+      accentStrong: "#286462",
+      accentSoft: "#d5ece9",
+      info: "#4c7899",
+      success: "#3d7b62",
+      warning: "#8b6e2f",
+      danger: "#a6453d"
+    }, "light"),
+    dark: completeTokens({
+      canvas: "#0f1718",
+      canvasSubtle: "#162123",
+      surface: "#162123",
+      surfaceMuted: "#1c2b2d",
+      surfaceRaised: "#223235",
+      text: "#e2eeee",
+      textMuted: "#9fb6b6",
+      border: "#304649",
+      borderStrong: "#496265",
+      accent: "#73c5bd",
+      accentHover: "#a2e1d9",
+      accentStrong: "#b8eee8",
+      accentSoft: "#1c3838",
+      info: "#8bbce5",
+      success: "#7cc6a1",
+      warning: "#d3b66a",
+      danger: "#e28074"
+    }, "dark")
+  }
+};
+export {
+  tidepoolScheme
+};

package/dist/utils/content-status.js

@@ -4,27 +4,27 @@ const CONTENT_STATUS_META = {
   live: {
     label: "Live",
     description: "Materially exists and is maintained.",
-    tone: "border-[color:var(--site-accent)]/35 bg-[color:var(--site-accent-soft)] text-[color:var(--site-accent-strong)]"
+    tone: "border-[color:var(--ts-color-accent)]/35 bg-[color:var(--ts-color-accent-soft)] text-[color:var(--ts-color-accent-strong)]"
   },
   "in progress": {
     label: "In Progress",
     description: "Actively being built or hardened.",
-    tone: "border-[color:var(--site-warm)]/40 bg-[color:rgba(215,176,123,0.18)] text-[color:var(--site-warm-strong)]"
+    tone: "border-[color:var(--ts-color-warning-border)] bg-[color:var(--ts-color-warning-soft)] text-[color:var(--ts-color-warning-text)]"
   },
   exploratory: {
     label: "Exploratory",
     description: "Directionally important, but still unsettled.",
-    tone: "border-[color:var(--site-blue)]/40 bg-[color:var(--site-blue-soft)] text-[color:var(--site-blue-strong)]"
+    tone: "border-[color:var(--ts-color-info)]/40 bg-[color:var(--ts-color-info-soft)] text-[color:var(--ts-color-info-text)]"
   },
   planned: {
     label: "Planned",
     description: "Intended, but not started in a meaningful way.",
-    tone: "border-[color:#9c9277]/35 bg-[color:rgba(156,146,119,0.14)] text-[color:#5f5743]"
+    tone: "border-[color:var(--ts-color-border-strong)] bg-[color:var(--ts-color-surface-muted)] text-[color:var(--ts-color-text-muted)]"
   },
   speculative: {
     label: "Speculative",
     description: "Conceptual or long-range, not a current commitment.",
-    tone: "border-[color:#a39b8e]/35 bg-[color:rgba(163,155,142,0.14)] text-[color:#4d4638]"
+    tone: "border-[color:var(--ts-color-border)] bg-[color:var(--ts-color-surface-muted)] text-[color:var(--ts-color-text-subtle)]"
   }
 };
 const PROJECT_STAGE = {

package/dist/utils/site-config.js

@@ -1,5 +1,5 @@
 import { RUNTIME_SITE_CONFIG, RUNTIME_TENANT } from "../tenant/runtime-config.js";
-import { buildTenantThemeCss } from "./theme.js";
+import { buildTreeseedThemeCss } from "./theme.js";
 function requireRuntimeSiteConfig() {
   if (!RUNTIME_SITE_CONFIG) {
     throw new Error(
@@ -30,7 +30,7 @@ const SITE_HEADER_MENU = SITE.headerMenu;
 const SITE_FOOTER_MENU = SITE.footerMenu;
 const SITE_FORMS = SITE.forms;
 const SITE_EMAIL_NOTIFICATIONS = SITE.emailNotifications;
-const SITE_THEME_CSS = buildTenantThemeCss(SITE.theme);
+const SITE_THEME_CSS = buildTreeseedThemeCss(SITE.theme);
 const PAGE_MODEL_DEFAULTS = SITE_CONFIG.models.pages.defaults;
 const NOTE_MODEL_DEFAULTS = SITE_CONFIG.models.notes.defaults;
 const QUESTION_MODEL_DEFAULTS = SITE_CONFIG.models.questions.defaults;

package/dist/utils/starlight-nav.js

@@ -1,3 +1,9 @@
+import {
+  BOOKS as RUNTIME_BOOKS,
+  BOOKS_LINK as RUNTIME_BOOKS_LINK,
+  TREESEED_LIBRARY_DOWNLOAD as RUNTIME_TREESEED_LIBRARY_DOWNLOAD,
+  TREESEED_LINKS as RUNTIME_TREESEED_LINKS
+} from "@treeseed/sdk/platform/books-data";
 const normalizeHref = (href) => href.endsWith("/") ? href : `${href}/`;
 function buildSidebarLink(href, label, currentPath) {
   return {
@@ -76,20 +82,20 @@ function getDocsDownloadForPathFromRuntime(runtime2, pathname) {
     downloadTitle: book.downloadTitle
   };
 }
-const BOOKS = [];
-const BOOKS_LINK = {
+const BOOKS = RUNTIME_BOOKS ?? [];
+const BOOKS_LINK = RUNTIME_BOOKS_LINK ?? {
   label: "Books",
-  link: "/knowledge/"
+  link: "/books/"
 };
-const TREESEED_LIBRARY_DOWNLOAD = {
+const TREESEED_LIBRARY_DOWNLOAD = RUNTIME_TREESEED_LIBRARY_DOWNLOAD ?? {
   downloadFileName: "treeseed-knowledge.md",
   downloadHref: "/books/treeseed-knowledge.md",
   downloadTitle: "TreeSeed Knowledge Library"
 };
-const TREESEED_LINKS = {
-  home: "/knowledge/"
+const TREESEED_LINKS = RUNTIME_TREESEED_LINKS ?? {
+  home: "/books/"
 };
-const runtime = { BOOKS, BOOKS_LINK, TREESEED_LIBRARY_DOWNLOAD, TREESEED_LINKS };
+const runtime = typeof __TREESEED_BOOK_RUNTIME__ !== "undefined" ? __TREESEED_BOOK_RUNTIME__ : { BOOKS, BOOKS_LINK, TREESEED_LIBRARY_DOWNLOAD, TREESEED_LINKS };
 function buildBookSidebar(bookSlug) {
   return buildBookSidebarFromRuntime(runtime, bookSlug);
 }

package/dist/utils/theme.js

@@ -1,49 +1,141 @@
-const THEME_TOKEN_MAP = {
-  "surfaces.background": "--site-bg",
-  "surfaces.backgroundElevated": "--site-bg-elevated",
-  "surfaces.backgroundSoft": "--site-bg-soft",
-  "surfaces.panel": "--site-panel",
-  "surfaces.panelStrong": "--site-panel-strong",
-  "text.body": "--site-text",
-  "text.muted": "--site-text-muted",
-  "text.soft": "--site-text-soft",
-  "border.base": "--site-border",
-  "border.strong": "--site-border-strong",
-  "border.grid": "--site-grid",
-  "accent.base": "--site-accent",
-  "accent.strong": "--site-accent-strong",
-  "accent.soft": "--site-accent-soft",
-  "info.base": "--site-blue",
-  "info.strong": "--site-blue-strong",
-  "info.soft": "--site-blue-soft",
-  "warm.base": "--site-warm",
-  "warm.strong": "--site-warm-strong"
-};
-function getThemeValue(theme, dottedPath) {
-  if (!theme) return void 0;
-  return dottedPath.split(".").reduce((value, segment) => {
-    if (!value || typeof value !== "object") {
-      return void 0;
+import { BUILT_IN_COLOR_SCHEMES } from "./color-schemes/index.js";
+const DEFAULT_SCHEME = "fern";
+const DEFAULT_MODE = "system";
+const THEME_MODES = /* @__PURE__ */ new Set(["light", "dark", "system"]);
+const BUILT_IN_SCHEME_SUMMARIES = BUILT_IN_COLOR_SCHEMES.map((scheme) => ({
+  id: scheme.id,
+  name: scheme.name,
+  swatches: scheme.swatches,
+  modeSwatches: scheme.modeSwatches
+}));
+const BUILT_IN_SCHEMES = Object.fromEntries(
+  BUILT_IN_COLOR_SCHEMES.map((scheme) => [scheme.id, scheme.tokens])
+);
+function mergeTokens(base, override) {
+  return {
+    ...base,
+    ...override ?? {}
+  };
+}
+function mergeScheme(base, override) {
+  return {
+    light: mergeTokens(base.light, override?.light),
+    dark: mergeTokens(base.dark, override?.dark)
+  };
+}
+function normalizeSchemeId(value, fallback) {
+  return typeof value === "string" && /^[a-z][a-z0-9-]*$/u.test(value) ? value : fallback;
+}
+function cssVariableName(tokenName) {
+  return `--ts-color-${tokenName.replace(/[A-Z]/g, (character) => `-${character.toLowerCase()}`)}`;
+}
+function buildTokenDeclarations(tokens) {
+  return Object.entries(tokens).map(([tokenName, value]) => `	${cssVariableName(tokenName)}: ${value};`).join("\n");
+}
+function schemeSelector(schemeId, mode) {
+  return `html[data-ts-scheme="${schemeId}"][data-ts-mode="${mode}"]`;
+}
+function systemSchemeSelector(schemeId) {
+  return `html[data-ts-scheme="${schemeId}"][data-ts-mode="system"]`;
+}
+function getBuiltInColorSchemes() {
+  return BUILT_IN_SCHEME_SUMMARIES.map((summary) => ({
+    ...summary,
+    swatches: [...summary.swatches],
+    modeSwatches: {
+      light: [...summary.modeSwatches.light],
+      dark: [...summary.modeSwatches.dark]
     }
-    return value[segment];
-  }, theme);
+  }));
 }
-function buildTenantThemeCss(theme) {
-  if (!theme) {
-    return "";
-  }
-  const declarations = Object.entries(THEME_TOKEN_MAP).map(([themePath, cssVariable]) => {
-    const value = getThemeValue(theme, themePath);
-    return typeof value === "string" && value.trim().length > 0 ? `	${cssVariable}: ${value.trim()};` : null;
-  }).filter((entry) => Boolean(entry));
-  if (declarations.length === 0) {
-    return "";
+function resolveTreeseedThemeConfig(input) {
+  const schemes = { ...BUILT_IN_SCHEMES };
+  for (const [schemeId, scheme] of Object.entries(input?.schemes ?? {})) {
+    const base = schemes[schemeId] ?? schemes[DEFAULT_SCHEME];
+    schemes[schemeId] = mergeScheme(base, scheme);
   }
-  return `:root {
-${declarations.join("\n")}
+  const defaultScheme = normalizeSchemeId(input?.defaultScheme, DEFAULT_SCHEME);
+  const resolvedDefaultScheme = schemes[defaultScheme] ? defaultScheme : DEFAULT_SCHEME;
+  const defaultMode = input?.defaultMode && THEME_MODES.has(input.defaultMode) ? input.defaultMode : DEFAULT_MODE;
+  const customSummaries = Object.keys(input?.schemes ?? {}).filter((schemeId) => !BUILT_IN_SCHEME_SUMMARIES.some((summary) => summary.id === schemeId)).map((schemeId) => ({
+    id: schemeId,
+    name: schemeId.split("-").map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" "),
+    swatches: [
+      schemes[schemeId].light.accent,
+      schemes[schemeId].light.accentStrong,
+      schemes[schemeId].light.surface,
+      schemes[schemeId].light.text
+    ],
+    modeSwatches: {
+      light: [
+        schemes[schemeId].light.accent,
+        schemes[schemeId].light.accentStrong,
+        schemes[schemeId].light.surface,
+        schemes[schemeId].light.text
+      ],
+      dark: [
+        schemes[schemeId].dark.accent,
+        schemes[schemeId].dark.accentStrong,
+        schemes[schemeId].dark.surface,
+        schemes[schemeId].dark.text
+      ]
+    }
+  }));
+  return {
+    defaultScheme: resolvedDefaultScheme,
+    defaultMode,
+    schemes,
+    summaries: [...getBuiltInColorSchemes(), ...customSummaries]
+  };
 }
+function normalizeThemePreference(input) {
+  const record = input && typeof input === "object" ? input : {};
+  return {
+    scheme: normalizeSchemeId(record.scheme ?? record.colorScheme, DEFAULT_SCHEME),
+    mode: typeof (record.mode ?? record.themeMode) === "string" && THEME_MODES.has(record.mode ?? record.themeMode) ? record.mode ?? record.themeMode : DEFAULT_MODE
+  };
+}
+function buildTreeseedThemeCss(input) {
+  const resolved = resolveTreeseedThemeConfig(input);
+  const defaultTokens = resolved.schemes[resolved.defaultScheme][resolved.defaultMode === "dark" ? "dark" : "light"];
+  const darkDefaultTokens = resolved.schemes[resolved.defaultScheme].dark;
+  const blocks = [
+    `:root {
+${buildTokenDeclarations(defaultTokens)}
+	color-scheme: ${resolved.defaultMode === "dark" ? "dark" : "light"};
+}`
+  ];
+  if (resolved.defaultMode === "system") {
+    blocks.push(`@media (prefers-color-scheme: dark) {
+	:root {
+${buildTokenDeclarations(darkDefaultTokens).replaceAll("\n", "\n	")}
+		color-scheme: dark;
+	}
+}`);
+  }
+  for (const [schemeId, scheme] of Object.entries(resolved.schemes)) {
+    blocks.push(`${schemeSelector(schemeId, "light")},
+${systemSchemeSelector(schemeId)} {
+${buildTokenDeclarations(scheme.light)}
+	color-scheme: light;
+}`);
+    blocks.push(`${schemeSelector(schemeId, "dark")} {
+${buildTokenDeclarations(scheme.dark)}
+	color-scheme: dark;
+}`);
+    blocks.push(`@media (prefers-color-scheme: dark) {
+	${systemSchemeSelector(schemeId)} {
+${buildTokenDeclarations(scheme.dark).replaceAll("\n", "\n	")}
+		color-scheme: dark;
+	}
+}`);
+  }
+  return `${blocks.join("\n\n")}
 `;
 }
 export {
-  buildTenantThemeCss
+  buildTreeseedThemeCss,
+  getBuiltInColorSchemes,
+  normalizeThemePreference,
+  resolveTreeseedThemeConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@treeseed/core",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "description": "Treeseed web framework package for Astro/Starlight site runtimes.",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -70,7 +70,7 @@
     "@astrojs/sitemap": "3.7.0",
     "@astrojs/starlight": "0.37.6",
     "@tailwindcss/vite": "^4.1.4",
-    "@treeseed/sdk": "0.8.8",
+    "@treeseed/sdk": "0.8.10",
     "astro": "^5.6.1",
     "esbuild": "^0.28.0",
     "katex": "^0.16.22",
@@ -159,6 +159,40 @@
     "./components/site/PathCard.astro": "./dist/components/site/PathCard.astro",
     "./components/site/TrustCallout.astro": "./dist/components/site/TrustCallout.astro",
     "./components/content/ContentStatusLegend.astro": "./dist/components/content/ContentStatusLegend.astro",
+    "./components/ui/theme/ThemeScript.astro": "./dist/components/ui/theme/ThemeScript.astro",
+    "./components/ui/theme/ThemeSelector.astro": "./dist/components/ui/theme/ThemeSelector.astro",
+    "./components/ui/theme/ThemeMenu.astro": "./dist/components/ui/theme/ThemeMenu.astro",
+    "./components/ui/theme/ThemePreviewSwatch.astro": "./dist/components/ui/theme/ThemePreviewSwatch.astro",
+    "./components/ui/forms/Button.astro": "./dist/components/ui/forms/Button.astro",
+    "./components/ui/forms/Field.astro": "./dist/components/ui/forms/Field.astro",
+    "./components/ui/forms/TextInput.astro": "./dist/components/ui/forms/TextInput.astro",
+    "./components/ui/forms/Select.astro": "./dist/components/ui/forms/Select.astro",
+    "./components/ui/forms/Textarea.astro": "./dist/components/ui/forms/Textarea.astro",
+    "./components/ui/forms/RadioGroup.astro": "./dist/components/ui/forms/RadioGroup.astro",
+    "./components/ui/forms/FormActions.astro": "./dist/components/ui/forms/FormActions.astro",
+    "./components/ui/forms/PasswordMeter.astro": "./dist/components/ui/forms/PasswordMeter.astro",
+    "./components/ui/surface/Panel.astro": "./dist/components/ui/surface/Panel.astro",
+    "./components/ui/surface/Card.astro": "./dist/components/ui/surface/Card.astro",
+    "./components/ui/surface/EmptyState.astro": "./dist/components/ui/surface/EmptyState.astro",
+    "./components/ui/data/Badge.astro": "./dist/components/ui/data/Badge.astro",
+    "./components/ui/data/StatusPill.astro": "./dist/components/ui/data/StatusPill.astro",
+    "./components/ui/data/MetricCard.astro": "./dist/components/ui/data/MetricCard.astro",
+    "./components/ui/data/MetricGrid.astro": "./dist/components/ui/data/MetricGrid.astro",
+    "./components/ui/data/ActionList.astro": "./dist/components/ui/data/ActionList.astro",
+    "./components/ui/data/KeyValueList.astro": "./dist/components/ui/data/KeyValueList.astro",
+    "./components/ui/data/DataTable.astro": "./dist/components/ui/data/DataTable.astro",
+    "./components/ui/layout/PageHeader.astro": "./dist/components/ui/layout/PageHeader.astro",
+    "./components/ui/shell/AppShell.astro": "./dist/components/ui/shell/AppShell.astro",
+    "./components/ui/shell/PublicShell.astro": "./dist/components/ui/shell/PublicShell.astro",
+    "./components/ui/shell/PublicFooter.astro": "./dist/components/ui/shell/PublicFooter.astro",
+    "./components/ui/shell/RailNav.astro": "./dist/components/ui/shell/RailNav.astro",
+    "./components/ui/shell/BottomNav.astro": "./dist/components/ui/shell/BottomNav.astro",
+    "./components/ui/shell/TopBar.astro": "./dist/components/ui/shell/TopBar.astro",
+    "./components/ui/shell/ProjectHeader.astro": "./dist/components/ui/shell/ProjectHeader.astro",
+    "./styles/theme.css": "./dist/styles/theme.css",
+    "./styles/ui.css": "./dist/styles/ui.css",
+    "./styles/forms.css": "./dist/styles/forms.css",
+    "./styles/app-shell.css": "./dist/styles/app-shell.css",
     "./components/starlight": {
       "types": "./dist/components/starlight.d.ts",
       "default": "./dist/components/starlight.js"