superlore-cli 0.7.1 → 0.7.3

package/dist/config.d.ts

@@ -35,6 +35,17 @@ interface SuperloreMcpConfig {
     /** Route the MCP is served at. Defaults to {@link DEFAULT_MCP_PATH}. */
     path?: string;
 }
+/** A navbar logo — light/dark image paths + an optional home link, the mint.json way. */
+interface SuperloreLogo {
+    light?: string;
+    dark?: string;
+    href?: string;
+}
+/** Brand typefaces — family names the layout wires to `--font-sans` / `--font-mono`. */
+interface SuperloreFont {
+    sans?: string;
+    mono?: string;
+}
 /** The parsed, validated shape of a `superlore.json` file. */
 interface SuperloreJson {
     /** Human-facing KB name. */
@@ -43,6 +54,14 @@ interface SuperloreJson {
     type: SuperloreType;
     /** Brand accent — any CSS colour. superlore derives the rest of the family (light + dark). */
     accent?: string;
+    /** Visual theme skin: "default" | "mint" (loose — forward-compatible with future skins). */
+    theme?: string;
+    /** Navbar logo — light/dark images + home link (mint.json-style). */
+    logo?: SuperloreLogo;
+    /** Favicon path (svg / png / ico). */
+    favicon?: string;
+    /** Brand typefaces (the layout wires these to `--font-sans` / `--font-mono`). */
+    font?: SuperloreFont;
     /** The human gate. Omitted ⇒ public. */
     auth?: SuperloreAuthConfig;
     /** The agent surface. Omitted ⇒ MCP enabled at the default path. */
@@ -84,4 +103,4 @@ declare function serializeSuperloreJson(config: SuperloreJson): string;
 /** Resolve the MCP path for a config, falling back to the default when enabled and unset. */
 declare function resolveMcpPath(config: SuperloreJson): string | undefined;
 
-export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreMcpConfig, type SuperloreType, parseSuperloreJson, resolveMcpPath, serializeSuperloreJson, validateSuperloreJson };
+export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreFont, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreLogo, type SuperloreMcpConfig, type SuperloreType, parseSuperloreJson, resolveMcpPath, serializeSuperloreJson, validateSuperloreJson };

package/dist/config.js

@@ -29,6 +29,49 @@ function validateSuperloreJson(input) {
   if (accent !== void 0 && (typeof accent !== "string" || accent.trim().length === 0)) {
     issues.push({ path: "accent", message: "must be a non-empty string (a CSS colour)" });
   }
+  const theme = input.theme;
+  if (theme !== void 0 && (typeof theme !== "string" || theme.trim().length === 0)) {
+    issues.push({ path: "theme", message: "must be a non-empty string" });
+  }
+  const favicon = input.favicon;
+  if (favicon !== void 0 && (typeof favicon !== "string" || favicon.trim().length === 0)) {
+    issues.push({ path: "favicon", message: "must be a non-empty string (a path or URL)" });
+  }
+  let font;
+  if (input.font !== void 0) {
+    if (!isRecord(input.font)) {
+      issues.push({ path: "font", message: "must be an object" });
+    } else {
+      const f = input.font;
+      for (const k of ["sans", "mono"]) {
+        if (f[k] !== void 0 && (typeof f[k] !== "string" || f[k].trim().length === 0)) {
+          issues.push({ path: `font.${k}`, message: "must be a non-empty string" });
+        }
+      }
+      font = {
+        sans: typeof f.sans === "string" ? f.sans : void 0,
+        mono: typeof f.mono === "string" ? f.mono : void 0
+      };
+    }
+  }
+  let logo;
+  if (input.logo !== void 0) {
+    if (!isRecord(input.logo)) {
+      issues.push({ path: "logo", message: "must be an object" });
+    } else {
+      const l = input.logo;
+      for (const k of ["light", "dark", "href"]) {
+        if (l[k] !== void 0 && (typeof l[k] !== "string" || l[k].trim().length === 0)) {
+          issues.push({ path: `logo.${k}`, message: "must be a non-empty string" });
+        }
+      }
+      logo = {
+        light: typeof l.light === "string" ? l.light : void 0,
+        dark: typeof l.dark === "string" ? l.dark : void 0,
+        href: typeof l.href === "string" ? l.href : void 0
+      };
+    }
+  }
   let auth;
   if (input.auth !== void 0) {
     if (!isRecord(input.auth)) {
@@ -82,6 +125,10 @@ function validateSuperloreJson(input) {
     type
   };
   if (typeof accent === "string") value.accent = accent.trim();
+  if (typeof theme === "string") value.theme = theme.trim();
+  if (typeof favicon === "string") value.favicon = favicon.trim();
+  if (font && (font.sans || font.mono)) value.font = font;
+  if (logo && (logo.light || logo.dark || logo.href)) value.logo = logo;
   if (auth) value.auth = auth;
   if (mcp) value.mcp = mcp;
   return { ok: true, value };

package/dist/index.d.ts

@@ -37,6 +37,17 @@ interface SuperloreMcpConfig {
     /** Route the MCP is served at. Defaults to {@link DEFAULT_MCP_PATH}. */
     path?: string;
 }
+/** A navbar logo — light/dark image paths + an optional home link, the mint.json way. */
+interface SuperloreLogo {
+    light?: string;
+    dark?: string;
+    href?: string;
+}
+/** Brand typefaces — family names the layout wires to `--font-sans` / `--font-mono`. */
+interface SuperloreFont {
+    sans?: string;
+    mono?: string;
+}
 /** The parsed, validated shape of a `superlore.json` file. */
 interface SuperloreJson {
     /** Human-facing KB name. */
@@ -45,6 +56,14 @@ interface SuperloreJson {
     type: SuperloreType;
     /** Brand accent — any CSS colour. superlore derives the rest of the family (light + dark). */
     accent?: string;
+    /** Visual theme skin: "default" | "mint" (loose — forward-compatible with future skins). */
+    theme?: string;
+    /** Navbar logo — light/dark images + home link (mint.json-style). */
+    logo?: SuperloreLogo;
+    /** Favicon path (svg / png / ico). */
+    favicon?: string;
+    /** Brand typefaces (the layout wires these to `--font-sans` / `--font-mono`). */
+    font?: SuperloreFont;
     /** The human gate. Omitted ⇒ public. */
     auth?: SuperloreAuthConfig;
     /** The agent surface. Omitted ⇒ MCP enabled at the default path. */
@@ -87,10 +106,10 @@ declare function serializeSuperloreJson(config: SuperloreJson): string;
 declare function resolveMcpPath(config: SuperloreJson): string | undefined;
 
 /** The CLI version, kept in sync with package.json at build time. */
-declare const VERSION = "0.7.1";
+declare const VERSION = "0.7.3";
 /** Build the argument parser. Exported for tests; `run()` wires it to argv. */
 declare function buildCli(argv?: readonly string[]): cac.CAC;
 /** Parse argv and dispatch. Reports unknown commands and unexpected errors cleanly. */
 declare function run(argv?: readonly string[]): Promise<void>;
 
-export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreMcpConfig, type SuperloreType, VERSION, buildCli, parseSuperloreJson, resolveMcpPath, run, serializeSuperloreJson, validateSuperloreJson };
+export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreFont, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreLogo, type SuperloreMcpConfig, type SuperloreType, VERSION, buildCli, parseSuperloreJson, resolveMcpPath, run, serializeSuperloreJson, validateSuperloreJson };

package/dist/index.js

@@ -100,6 +100,49 @@ function validateSuperloreJson(input) {
   if (accent2 !== void 0 && (typeof accent2 !== "string" || accent2.trim().length === 0)) {
     issues.push({ path: "accent", message: "must be a non-empty string (a CSS colour)" });
   }
+  const theme = input.theme;
+  if (theme !== void 0 && (typeof theme !== "string" || theme.trim().length === 0)) {
+    issues.push({ path: "theme", message: "must be a non-empty string" });
+  }
+  const favicon = input.favicon;
+  if (favicon !== void 0 && (typeof favicon !== "string" || favicon.trim().length === 0)) {
+    issues.push({ path: "favicon", message: "must be a non-empty string (a path or URL)" });
+  }
+  let font;
+  if (input.font !== void 0) {
+    if (!isRecord(input.font)) {
+      issues.push({ path: "font", message: "must be an object" });
+    } else {
+      const f = input.font;
+      for (const k of ["sans", "mono"]) {
+        if (f[k] !== void 0 && (typeof f[k] !== "string" || f[k].trim().length === 0)) {
+          issues.push({ path: `font.${k}`, message: "must be a non-empty string" });
+        }
+      }
+      font = {
+        sans: typeof f.sans === "string" ? f.sans : void 0,
+        mono: typeof f.mono === "string" ? f.mono : void 0
+      };
+    }
+  }
+  let logo;
+  if (input.logo !== void 0) {
+    if (!isRecord(input.logo)) {
+      issues.push({ path: "logo", message: "must be an object" });
+    } else {
+      const l = input.logo;
+      for (const k of ["light", "dark", "href"]) {
+        if (l[k] !== void 0 && (typeof l[k] !== "string" || l[k].trim().length === 0)) {
+          issues.push({ path: `logo.${k}`, message: "must be a non-empty string" });
+        }
+      }
+      logo = {
+        light: typeof l.light === "string" ? l.light : void 0,
+        dark: typeof l.dark === "string" ? l.dark : void 0,
+        href: typeof l.href === "string" ? l.href : void 0
+      };
+    }
+  }
   let auth;
   if (input.auth !== void 0) {
     if (!isRecord(input.auth)) {
@@ -153,6 +196,10 @@ function validateSuperloreJson(input) {
     type
   };
   if (typeof accent2 === "string") value.accent = accent2.trim();
+  if (typeof theme === "string") value.theme = theme.trim();
+  if (typeof favicon === "string") value.favicon = favicon.trim();
+  if (font && (font.sans || font.mono)) value.font = font;
+  if (logo && (logo.light || logo.dark || logo.href)) value.logo = logo;
   if (auth) value.auth = auth;
   if (mcp) value.mcp = mcp;
   return { ok: true, value };
@@ -1940,14 +1987,22 @@ export default config;
     "app/layout.tsx",
     `import type { ReactNode } from "react";
 import { RootProvider } from "superlore/ui";
+import config from "../superlore.json";
 import "./global.css";
 
 export default function RootLayout({ children }: { children: ReactNode }) {
-  // Light and dark are co-equal; default to the system preference.
+  // Light and dark are co-equal; default to the system preference. From superlore.json: \`theme\`
+  // picks the visual skin (default | mint | geist | ledger | obsidian | prism | paste) and \`accent\`
+  // drives the whole brand palette \u2014 change them there, no code edits.
+  const theme = (config as { theme?: string }).theme;
   return (
-    <html lang="en" suppressHydrationWarning>
+    <html
+      lang="en"
+      suppressHydrationWarning
+      data-sl-theme={theme && theme !== "default" ? theme : undefined}
+    >
       <body>
-        <RootProvider>{children}</RootProvider>
+        <RootProvider accent={(config as { accent?: string }).accent}>{children}</RootProvider>
       </body>
     </html>
   );
@@ -2372,6 +2427,8 @@ async function initCommand(dir, flags) {
   const auth = authEnabled ? { enabled: true, provider: "google", ...allowedDomain ? { allowedDomain } : {} } : void 0;
   const draft = { name, type };
   if (accentColor) draft.accent = accentColor;
+  const themeName = flags.theme?.trim();
+  if (themeName) draft.theme = themeName;
   if (auth) draft.auth = auth;
   draft.mcp = { enabled: mcpEnabled, ...mcpEnabled ? { path: DEFAULT_MCP_PATH } : {} };
   const result = validateSuperloreJson(draft);
@@ -2486,7 +2543,7 @@ function printNextSteps(root, config) {
 }
 
 // src/index.ts
-var VERSION = "0.7.1";
+var VERSION = "0.7.3";
 function buildCli(argv = process3.argv) {
   const cli = cac("superlore");
   cli.command("init [dir]", "Scaffold a new superlore knowledge base").option("--name <name>", "KB name").option("--type <type>", "KB type: company-kb | product-docs | personal-kb").option("--auth", "Enable the Google SSO auth gate").option("--no-auth", "Disable the auth gate").option("--allowed-domain <domain>", "Restrict SSO to one email domain (implies --auth)").option("--accent <color>", "Brand accent colour (any CSS colour)").option("--no-mcp", "Disable the MCP endpoint (on by default)").option("--connect", "Install the editor extension after scaffolding (skip the prompt)").option("--no-connect", "Don't set up the editor extension").option("-y, --yes", "Skip prompts; use flags + defaults").example("superlore init my-kb --type product-docs").example("superlore init acme --type company-kb --auth --allowed-domain acme.com").example("superlore init me --type personal-kb").action(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlore-cli",
-  "version": "0.7.1",
+  "version": "0.7.3",
   "description": "The superlore CLI — scaffold, run, and build an agent-native knowledge base. One corpus. Humans and agents.",
   "license": "Apache-2.0",
   "author": "Krishnan S G",