pika-shared 1.4.12 → 1.5.0

package/dist/types/chatbot/theme-types.d.mts

@@ -0,0 +1,163 @@
+/**
+ * Theme Types for Pika UI Customization
+ *
+ * These types define the structure of theme configuration for clone projects.
+ * Import via: import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';
+ *
+ * @since 0.16.0
+ */
+/**
+ * Theme configuration for Pika Chat
+ *
+ * Clone projects copy sample-purple-theme.ts, customize it, and update themeConfigPath
+ * in pika-config.ts to point to their theme file.
+ *
+ * @example
+ * ```typescript
+ * import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';
+ *
+ * export const themeConfig: ThemeConfig = {
+ *     name: 'Acme Corp Theme',
+ *     fontFamily: '"Inter", sans-serif',
+ *     cssVariables: {
+ *         light: {
+ *             'primary': 'oklch(0.47 0.2 290)',
+ *             'primary-foreground': 'oklch(1 0 0)',
+ *         },
+ *         dark: {
+ *             'primary': 'oklch(0.70 0.18 290)',
+ *         }
+ *     }
+ * };
+ * ```
+ *
+ * @since 0.16.0
+ */
+interface ThemeConfig {
+    /**
+     * Schema version of this theme configuration.
+     * Used by `pika theme check` to notify you of new theme variables.
+     * See theme-schema.ts for the changelog of schema versions.
+     *
+     * @default 1 (if not specified)
+     * @example schemaVersion: 1
+     */
+    schemaVersion?: number;
+    /**
+     * Display name for this theme (for documentation/debugging)
+     * @example 'Acme Corp Brand Theme'
+     */
+    name?: string;
+    /**
+     * Font family override. Applied to --font-sans CSS variable.
+     * @example '"Figtree", Arial, Helvetica, sans-serif'
+     */
+    fontFamily?: string;
+    /**
+     * CSS custom properties to override.
+     * Keys are CSS variable names WITHOUT the -- prefix.
+     * Values should be valid CSS color values (oklch preferred for modern color handling).
+     *
+     * @example
+     * ```typescript
+     * cssVariables: {
+     *     light: {
+     *         'primary': 'oklch(0.47 0.2 290)',
+     *         'border': 'oklch(0.88 0.01 260)',
+     *     },
+     *     dark: {
+     *         'primary': 'oklch(0.70 0.18 290)',
+     *     }
+     * }
+     * ```
+     */
+    cssVariables?: {
+        /** Light mode variable overrides */
+        light?: Record<string, string>;
+        /** Dark mode variable overrides */
+        dark?: Record<string, string>;
+    };
+    /**
+     * Custom color palettes for your brand.
+     * Creates CSS variables like --{paletteName}-{shade}
+     *
+     * @example
+     * ```typescript
+     * customPalettes: {
+     *     brand: {
+     *         '50': 'oklch(0.97 0.01 290)',
+     *         '500': 'oklch(0.47 0.2 290)',
+     *         '900': 'oklch(0.20 0.08 290)',
+     *     }
+     * }
+     * ```
+     */
+    customPalettes?: Record<string, Record<string, string>>;
+    /**
+     * Custom header icon for chat apps. Replaces the default AI sparkle icon.
+     * The icon will be constrained to roughly 44x44px.
+     *
+     * Can be specified as:
+     * - A single string URL (used for both light and dark modes)
+     * - An object with separate light/dark URLs for mode-specific icons
+     *
+     * For sync-safe storage, place your icons in:
+     * `apps/pika-chat/static/custom/assets/`
+     *
+     * @example Single icon for both modes:
+     * ```typescript
+     * chatAppHeaderIcon: '/custom/assets/my-logo.svg'
+     * ```
+     *
+     * @example Separate icons for light/dark modes:
+     * ```typescript
+     * chatAppHeaderIcon: {
+     *     light: '/custom/assets/logo-dark.svg',   // Dark logo on light background
+     *     dark: '/custom/assets/logo-light.svg'    // Light logo on dark background
+     * }
+     * ```
+     *
+     * @since 0.16.4
+     */
+    chatAppHeaderIcon?: string | {
+        /** Icon URL for light mode */
+        light: string;
+        /** Icon URL for dark mode (falls back to light if not provided) */
+        dark?: string;
+    };
+}
+/**
+ * Configuration for the custom theme feature in pika-config.ts
+ *
+ * @since 0.16.0
+ */
+interface CustomThemeConfig {
+    /**
+     * Whether custom theming is enabled.
+     * If false, the default Pika theme is used and the theme config is not loaded.
+     */
+    enabled: boolean;
+    /**
+     * Path to theme config file relative to apps/pika-chat/
+     * The file must export a `themeConfig` object of type ThemeConfig.
+     *
+     * @default 'src/lib/custom/sample-purple-theme'
+     * @example 'src/lib/custom/my-theme' imports from 'apps/pika-chat/src/lib/custom/my-theme.ts'
+     */
+    themeConfigPath?: string;
+}
+/**
+ * Standard semantic variable names that can be overridden in a theme.
+ * These are the shadcn-svelte standard variables plus Pika extensions.
+ *
+ * @since 0.16.0
+ */
+type SemanticColorVariable = 'background' | 'foreground' | 'card' | 'card-foreground' | 'popover' | 'popover-foreground' | 'primary' | 'primary-foreground' | 'secondary' | 'secondary-foreground' | 'muted' | 'muted-foreground' | 'accent' | 'accent-foreground' | 'destructive' | 'destructive-foreground' | 'border' | 'input' | 'ring' | 'chart-1' | 'chart-2' | 'chart-3' | 'chart-4' | 'chart-5' | 'sidebar-background' | 'sidebar-foreground' | 'sidebar-primary' | 'sidebar-primary-foreground' | 'sidebar-accent' | 'sidebar-accent-foreground' | 'sidebar-border' | 'sidebar-ring' | 'success' | 'success-foreground' | 'success-bg' | 'warning' | 'warning-foreground' | 'warning-bg' | 'info' | 'info-foreground' | 'info-bg' | 'ai' | 'ai-foreground' | 'ai-bg' | 'danger-bg' | 'chat-app-icon' | 'chat-app-header-icon-height' | 'chat-app-header-icon-gap';
+/**
+ * All semantic variables as a readonly array for iteration
+ *
+ * @since 0.16.0
+ */
+declare const SEMANTIC_COLOR_VARIABLES: readonly SemanticColorVariable[];
+
+export { type CustomThemeConfig, SEMANTIC_COLOR_VARIABLES, type SemanticColorVariable, type ThemeConfig };

package/dist/types/chatbot/theme-types.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Theme Types for Pika UI Customization
+ *
+ * These types define the structure of theme configuration for clone projects.
+ * Import via: import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';
+ *
+ * @since 0.16.0
+ */
+/**
+ * Theme configuration for Pika Chat
+ *
+ * Clone projects copy sample-purple-theme.ts, customize it, and update themeConfigPath
+ * in pika-config.ts to point to their theme file.
+ *
+ * @example
+ * ```typescript
+ * import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';
+ *
+ * export const themeConfig: ThemeConfig = {
+ *     name: 'Acme Corp Theme',
+ *     fontFamily: '"Inter", sans-serif',
+ *     cssVariables: {
+ *         light: {
+ *             'primary': 'oklch(0.47 0.2 290)',
+ *             'primary-foreground': 'oklch(1 0 0)',
+ *         },
+ *         dark: {
+ *             'primary': 'oklch(0.70 0.18 290)',
+ *         }
+ *     }
+ * };
+ * ```
+ *
+ * @since 0.16.0
+ */
+interface ThemeConfig {
+    /**
+     * Schema version of this theme configuration.
+     * Used by `pika theme check` to notify you of new theme variables.
+     * See theme-schema.ts for the changelog of schema versions.
+     *
+     * @default 1 (if not specified)
+     * @example schemaVersion: 1
+     */
+    schemaVersion?: number;
+    /**
+     * Display name for this theme (for documentation/debugging)
+     * @example 'Acme Corp Brand Theme'
+     */
+    name?: string;
+    /**
+     * Font family override. Applied to --font-sans CSS variable.
+     * @example '"Figtree", Arial, Helvetica, sans-serif'
+     */
+    fontFamily?: string;
+    /**
+     * CSS custom properties to override.
+     * Keys are CSS variable names WITHOUT the -- prefix.
+     * Values should be valid CSS color values (oklch preferred for modern color handling).
+     *
+     * @example
+     * ```typescript
+     * cssVariables: {
+     *     light: {
+     *         'primary': 'oklch(0.47 0.2 290)',
+     *         'border': 'oklch(0.88 0.01 260)',
+     *     },
+     *     dark: {
+     *         'primary': 'oklch(0.70 0.18 290)',
+     *     }
+     * }
+     * ```
+     */
+    cssVariables?: {
+        /** Light mode variable overrides */
+        light?: Record<string, string>;
+        /** Dark mode variable overrides */
+        dark?: Record<string, string>;
+    };
+    /**
+     * Custom color palettes for your brand.
+     * Creates CSS variables like --{paletteName}-{shade}
+     *
+     * @example
+     * ```typescript
+     * customPalettes: {
+     *     brand: {
+     *         '50': 'oklch(0.97 0.01 290)',
+     *         '500': 'oklch(0.47 0.2 290)',
+     *         '900': 'oklch(0.20 0.08 290)',
+     *     }
+     * }
+     * ```
+     */
+    customPalettes?: Record<string, Record<string, string>>;
+    /**
+     * Custom header icon for chat apps. Replaces the default AI sparkle icon.
+     * The icon will be constrained to roughly 44x44px.
+     *
+     * Can be specified as:
+     * - A single string URL (used for both light and dark modes)
+     * - An object with separate light/dark URLs for mode-specific icons
+     *
+     * For sync-safe storage, place your icons in:
+     * `apps/pika-chat/static/custom/assets/`
+     *
+     * @example Single icon for both modes:
+     * ```typescript
+     * chatAppHeaderIcon: '/custom/assets/my-logo.svg'
+     * ```
+     *
+     * @example Separate icons for light/dark modes:
+     * ```typescript
+     * chatAppHeaderIcon: {
+     *     light: '/custom/assets/logo-dark.svg',   // Dark logo on light background
+     *     dark: '/custom/assets/logo-light.svg'    // Light logo on dark background
+     * }
+     * ```
+     *
+     * @since 0.16.4
+     */
+    chatAppHeaderIcon?: string | {
+        /** Icon URL for light mode */
+        light: string;
+        /** Icon URL for dark mode (falls back to light if not provided) */
+        dark?: string;
+    };
+}
+/**
+ * Configuration for the custom theme feature in pika-config.ts
+ *
+ * @since 0.16.0
+ */
+interface CustomThemeConfig {
+    /**
+     * Whether custom theming is enabled.
+     * If false, the default Pika theme is used and the theme config is not loaded.
+     */
+    enabled: boolean;
+    /**
+     * Path to theme config file relative to apps/pika-chat/
+     * The file must export a `themeConfig` object of type ThemeConfig.
+     *
+     * @default 'src/lib/custom/sample-purple-theme'
+     * @example 'src/lib/custom/my-theme' imports from 'apps/pika-chat/src/lib/custom/my-theme.ts'
+     */
+    themeConfigPath?: string;
+}
+/**
+ * Standard semantic variable names that can be overridden in a theme.
+ * These are the shadcn-svelte standard variables plus Pika extensions.
+ *
+ * @since 0.16.0
+ */
+type SemanticColorVariable = 'background' | 'foreground' | 'card' | 'card-foreground' | 'popover' | 'popover-foreground' | 'primary' | 'primary-foreground' | 'secondary' | 'secondary-foreground' | 'muted' | 'muted-foreground' | 'accent' | 'accent-foreground' | 'destructive' | 'destructive-foreground' | 'border' | 'input' | 'ring' | 'chart-1' | 'chart-2' | 'chart-3' | 'chart-4' | 'chart-5' | 'sidebar-background' | 'sidebar-foreground' | 'sidebar-primary' | 'sidebar-primary-foreground' | 'sidebar-accent' | 'sidebar-accent-foreground' | 'sidebar-border' | 'sidebar-ring' | 'success' | 'success-foreground' | 'success-bg' | 'warning' | 'warning-foreground' | 'warning-bg' | 'info' | 'info-foreground' | 'info-bg' | 'ai' | 'ai-foreground' | 'ai-bg' | 'danger-bg' | 'chat-app-icon' | 'chat-app-header-icon-height' | 'chat-app-header-icon-gap';
+/**
+ * All semantic variables as a readonly array for iteration
+ *
+ * @since 0.16.0
+ */
+declare const SEMANTIC_COLOR_VARIABLES: readonly SemanticColorVariable[];
+
+export { type CustomThemeConfig, SEMANTIC_COLOR_VARIABLES, type SemanticColorVariable, type ThemeConfig };

package/dist/types/chatbot/theme-types.js

@@ -0,0 +1,62 @@
+'use strict';
+
+// src/types/chatbot/theme-types.ts
+var SEMANTIC_COLOR_VARIABLES = [
+  // Core
+  "background",
+  "foreground",
+  "card",
+  "card-foreground",
+  "popover",
+  "popover-foreground",
+  "primary",
+  "primary-foreground",
+  "secondary",
+  "secondary-foreground",
+  "muted",
+  "muted-foreground",
+  "accent",
+  "accent-foreground",
+  "destructive",
+  "destructive-foreground",
+  "border",
+  "input",
+  "ring",
+  // Charts
+  "chart-1",
+  "chart-2",
+  "chart-3",
+  "chart-4",
+  "chart-5",
+  // Sidebar
+  "sidebar-background",
+  "sidebar-foreground",
+  "sidebar-primary",
+  "sidebar-primary-foreground",
+  "sidebar-accent",
+  "sidebar-accent-foreground",
+  "sidebar-border",
+  "sidebar-ring",
+  // Extended
+  "success",
+  "success-foreground",
+  "success-bg",
+  "warning",
+  "warning-foreground",
+  "warning-bg",
+  "info",
+  "info-foreground",
+  "info-bg",
+  "ai",
+  "ai-foreground",
+  "ai-bg",
+  "danger-bg",
+  // Header/branding
+  "chat-app-icon",
+  "chat-app-header-icon-height",
+  "chat-app-header-icon-gap"
+];
+
+exports.SEMANTIC_COLOR_VARIABLES = SEMANTIC_COLOR_VARIABLES;
+//# sourceMappingURL=theme-types.js.map
+//# sourceMappingURL=theme-types.js.map

package/dist/types/chatbot/theme-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/types/chatbot/theme-types.ts"],"names":[],"mappings":";;;AA+NO,IAAM,wBAAA,GAA6D;AAAA;AAAA,EAEtE,YAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,iBAAA;AAAA,EACA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,WAAA;AAAA,EACA,sBAAA;AAAA,EACA,OAAA;AAAA,EACA,kBAAA;AAAA,EACA,QAAA;AAAA,EACA,mBAAA;AAAA,EACA,aAAA;AAAA,EACA,wBAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA;AAAA,EAEA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA;AAAA,EAEA,oBAAA;AAAA,EACA,oBAAA;AAAA,EACA,iBAAA;AAAA,EACA,4BAAA;AAAA,EACA,gBAAA;AAAA,EACA,2BAAA;AAAA,EACA,gBAAA;AAAA,EACA,cAAA;AAAA;AAAA,EAEA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,YAAA;AAAA,EACA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,iBAAA;AAAA,EACA,SAAA;AAAA,EACA,IAAA;AAAA,EACA,eAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA;AAAA,EAEA,eAAA;AAAA,EACA,6BAAA;AAAA,EACA;AACJ","file":"theme-types.js","sourcesContent":["/**\n * Theme Types for Pika UI Customization\n *\n * These types define the structure of theme configuration for clone projects.\n * Import via: import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';\n *\n * @since 0.16.0\n */\n\n/**\n * Theme configuration for Pika Chat\n *\n * Clone projects copy sample-purple-theme.ts, customize it, and update themeConfigPath\n * in pika-config.ts to point to their theme file.\n *\n * @example\n * ```typescript\n * import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';\n *\n * export const themeConfig: ThemeConfig = {\n *     name: 'Acme Corp Theme',\n *     fontFamily: '\"Inter\", sans-serif',\n *     cssVariables: {\n *         light: {\n *             'primary': 'oklch(0.47 0.2 290)',\n *             'primary-foreground': 'oklch(1 0 0)',\n *         },\n *         dark: {\n *             'primary': 'oklch(0.70 0.18 290)',\n *         }\n *     }\n * };\n * ```\n *\n * @since 0.16.0\n */\nexport interface ThemeConfig {\n    /**\n     * Schema version of this theme configuration.\n     * Used by `pika theme check` to notify you of new theme variables.\n     * See theme-schema.ts for the changelog of schema versions.\n     *\n     * @default 1 (if not specified)\n     * @example schemaVersion: 1\n     */\n    schemaVersion?: number;\n\n    /**\n     * Display name for this theme (for documentation/debugging)\n     * @example 'Acme Corp Brand Theme'\n     */\n    name?: string;\n\n    /**\n     * Font family override. Applied to --font-sans CSS variable.\n     * @example '\"Figtree\", Arial, Helvetica, sans-serif'\n     */\n    fontFamily?: string;\n\n    /**\n     * CSS custom properties to override.\n     * Keys are CSS variable names WITHOUT the -- prefix.\n     * Values should be valid CSS color values (oklch preferred for modern color handling).\n     *\n     * @example\n     * ```typescript\n     * cssVariables: {\n     *     light: {\n     *         'primary': 'oklch(0.47 0.2 290)',\n     *         'border': 'oklch(0.88 0.01 260)',\n     *     },\n     *     dark: {\n     *         'primary': 'oklch(0.70 0.18 290)',\n     *     }\n     * }\n     * ```\n     */\n    cssVariables?: {\n        /** Light mode variable overrides */\n        light?: Record<string, string>;\n        /** Dark mode variable overrides */\n        dark?: Record<string, string>;\n    };\n\n    /**\n     * Custom color palettes for your brand.\n     * Creates CSS variables like --{paletteName}-{shade}\n     *\n     * @example\n     * ```typescript\n     * customPalettes: {\n     *     brand: {\n     *         '50': 'oklch(0.97 0.01 290)',\n     *         '500': 'oklch(0.47 0.2 290)',\n     *         '900': 'oklch(0.20 0.08 290)',\n     *     }\n     * }\n     * ```\n     */\n    customPalettes?: Record<string, Record<string, string>>;\n\n    /**\n     * Custom header icon for chat apps. Replaces the default AI sparkle icon.\n     * The icon will be constrained to roughly 44x44px.\n     *\n     * Can be specified as:\n     * - A single string URL (used for both light and dark modes)\n     * - An object with separate light/dark URLs for mode-specific icons\n     *\n     * For sync-safe storage, place your icons in:\n     * `apps/pika-chat/static/custom/assets/`\n     *\n     * @example Single icon for both modes:\n     * ```typescript\n     * chatAppHeaderIcon: '/custom/assets/my-logo.svg'\n     * ```\n     *\n     * @example Separate icons for light/dark modes:\n     * ```typescript\n     * chatAppHeaderIcon: {\n     *     light: '/custom/assets/logo-dark.svg',   // Dark logo on light background\n     *     dark: '/custom/assets/logo-light.svg'    // Light logo on dark background\n     * }\n     * ```\n     *\n     * @since 0.16.4\n     */\n    chatAppHeaderIcon?: string | {\n        /** Icon URL for light mode */\n        light: string;\n        /** Icon URL for dark mode (falls back to light if not provided) */\n        dark?: string;\n    };\n}\n\n/**\n * Configuration for the custom theme feature in pika-config.ts\n *\n * @since 0.16.0\n */\nexport interface CustomThemeConfig {\n    /**\n     * Whether custom theming is enabled.\n     * If false, the default Pika theme is used and the theme config is not loaded.\n     */\n    enabled: boolean;\n\n    /**\n     * Path to theme config file relative to apps/pika-chat/\n     * The file must export a `themeConfig` object of type ThemeConfig.\n     *\n     * @default 'src/lib/custom/sample-purple-theme'\n     * @example 'src/lib/custom/my-theme' imports from 'apps/pika-chat/src/lib/custom/my-theme.ts'\n     */\n    themeConfigPath?: string;\n}\n\n/**\n * Standard semantic variable names that can be overridden in a theme.\n * These are the shadcn-svelte standard variables plus Pika extensions.\n *\n * @since 0.16.0\n */\nexport type SemanticColorVariable =\n    // Core shadcn variables\n    | 'background'\n    | 'foreground'\n    | 'card'\n    | 'card-foreground'\n    | 'popover'\n    | 'popover-foreground'\n    | 'primary'\n    | 'primary-foreground'\n    | 'secondary'\n    | 'secondary-foreground'\n    | 'muted'\n    | 'muted-foreground'\n    | 'accent'\n    | 'accent-foreground'\n    | 'destructive'\n    | 'destructive-foreground'\n    | 'border'\n    | 'input'\n    | 'ring'\n    // Chart colors\n    | 'chart-1'\n    | 'chart-2'\n    | 'chart-3'\n    | 'chart-4'\n    | 'chart-5'\n    // Sidebar variants\n    | 'sidebar-background'\n    | 'sidebar-foreground'\n    | 'sidebar-primary'\n    | 'sidebar-primary-foreground'\n    | 'sidebar-accent'\n    | 'sidebar-accent-foreground'\n    | 'sidebar-border'\n    | 'sidebar-ring'\n    // Pika extended semantic colors\n    | 'success'\n    | 'success-foreground'\n    | 'success-bg'\n    | 'warning'\n    | 'warning-foreground'\n    | 'warning-bg'\n    | 'info'\n    | 'info-foreground'\n    | 'info-bg'\n    | 'ai'\n    | 'ai-foreground'\n    | 'ai-bg'\n    | 'danger-bg'\n    // Header/branding\n    | 'chat-app-icon'\n    | 'chat-app-header-icon-height'\n    | 'chat-app-header-icon-gap';\n\n/**\n * All semantic variables as a readonly array for iteration\n *\n * @since 0.16.0\n */\nexport const SEMANTIC_COLOR_VARIABLES: readonly SemanticColorVariable[] = [\n    // Core\n    'background',\n    'foreground',\n    'card',\n    'card-foreground',\n    'popover',\n    'popover-foreground',\n    'primary',\n    'primary-foreground',\n    'secondary',\n    'secondary-foreground',\n    'muted',\n    'muted-foreground',\n    'accent',\n    'accent-foreground',\n    'destructive',\n    'destructive-foreground',\n    'border',\n    'input',\n    'ring',\n    // Charts\n    'chart-1',\n    'chart-2',\n    'chart-3',\n    'chart-4',\n    'chart-5',\n    // Sidebar\n    'sidebar-background',\n    'sidebar-foreground',\n    'sidebar-primary',\n    'sidebar-primary-foreground',\n    'sidebar-accent',\n    'sidebar-accent-foreground',\n    'sidebar-border',\n    'sidebar-ring',\n    // Extended\n    'success',\n    'success-foreground',\n    'success-bg',\n    'warning',\n    'warning-foreground',\n    'warning-bg',\n    'info',\n    'info-foreground',\n    'info-bg',\n    'ai',\n    'ai-foreground',\n    'ai-bg',\n    'danger-bg',\n    // Header/branding\n    'chat-app-icon',\n    'chat-app-header-icon-height',\n    'chat-app-header-icon-gap'\n] as const;\n"]}

package/dist/types/chatbot/theme-types.mjs

@@ -0,0 +1,60 @@
+// src/types/chatbot/theme-types.ts
+var SEMANTIC_COLOR_VARIABLES = [
+  // Core
+  "background",
+  "foreground",
+  "card",
+  "card-foreground",
+  "popover",
+  "popover-foreground",
+  "primary",
+  "primary-foreground",
+  "secondary",
+  "secondary-foreground",
+  "muted",
+  "muted-foreground",
+  "accent",
+  "accent-foreground",
+  "destructive",
+  "destructive-foreground",
+  "border",
+  "input",
+  "ring",
+  // Charts
+  "chart-1",
+  "chart-2",
+  "chart-3",
+  "chart-4",
+  "chart-5",
+  // Sidebar
+  "sidebar-background",
+  "sidebar-foreground",
+  "sidebar-primary",
+  "sidebar-primary-foreground",
+  "sidebar-accent",
+  "sidebar-accent-foreground",
+  "sidebar-border",
+  "sidebar-ring",
+  // Extended
+  "success",
+  "success-foreground",
+  "success-bg",
+  "warning",
+  "warning-foreground",
+  "warning-bg",
+  "info",
+  "info-foreground",
+  "info-bg",
+  "ai",
+  "ai-foreground",
+  "ai-bg",
+  "danger-bg",
+  // Header/branding
+  "chat-app-icon",
+  "chat-app-header-icon-height",
+  "chat-app-header-icon-gap"
+];
+
+export { SEMANTIC_COLOR_VARIABLES };
+//# sourceMappingURL=theme-types.mjs.map
+//# sourceMappingURL=theme-types.mjs.map

package/dist/types/chatbot/theme-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/types/chatbot/theme-types.ts"],"names":[],"mappings":";AA+NO,IAAM,wBAAA,GAA6D;AAAA;AAAA,EAEtE,YAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,iBAAA;AAAA,EACA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,WAAA;AAAA,EACA,sBAAA;AAAA,EACA,OAAA;AAAA,EACA,kBAAA;AAAA,EACA,QAAA;AAAA,EACA,mBAAA;AAAA,EACA,aAAA;AAAA,EACA,wBAAA;AAAA,EACA,QAAA;AAAA,EACA,OAAA;AAAA,EACA,MAAA;AAAA;AAAA,EAEA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA,EACA,SAAA;AAAA;AAAA,EAEA,oBAAA;AAAA,EACA,oBAAA;AAAA,EACA,iBAAA;AAAA,EACA,4BAAA;AAAA,EACA,gBAAA;AAAA,EACA,2BAAA;AAAA,EACA,gBAAA;AAAA,EACA,cAAA;AAAA;AAAA,EAEA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,YAAA;AAAA,EACA,SAAA;AAAA,EACA,oBAAA;AAAA,EACA,YAAA;AAAA,EACA,MAAA;AAAA,EACA,iBAAA;AAAA,EACA,SAAA;AAAA,EACA,IAAA;AAAA,EACA,eAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA;AAAA;AAAA,EAEA,eAAA;AAAA,EACA,6BAAA;AAAA,EACA;AACJ","file":"theme-types.mjs","sourcesContent":["/**\n * Theme Types for Pika UI Customization\n *\n * These types define the structure of theme configuration for clone projects.\n * Import via: import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';\n *\n * @since 0.16.0\n */\n\n/**\n * Theme configuration for Pika Chat\n *\n * Clone projects copy sample-purple-theme.ts, customize it, and update themeConfigPath\n * in pika-config.ts to point to their theme file.\n *\n * @example\n * ```typescript\n * import type { ThemeConfig } from 'pika-shared/types/chatbot/theme-types';\n *\n * export const themeConfig: ThemeConfig = {\n *     name: 'Acme Corp Theme',\n *     fontFamily: '\"Inter\", sans-serif',\n *     cssVariables: {\n *         light: {\n *             'primary': 'oklch(0.47 0.2 290)',\n *             'primary-foreground': 'oklch(1 0 0)',\n *         },\n *         dark: {\n *             'primary': 'oklch(0.70 0.18 290)',\n *         }\n *     }\n * };\n * ```\n *\n * @since 0.16.0\n */\nexport interface ThemeConfig {\n    /**\n     * Schema version of this theme configuration.\n     * Used by `pika theme check` to notify you of new theme variables.\n     * See theme-schema.ts for the changelog of schema versions.\n     *\n     * @default 1 (if not specified)\n     * @example schemaVersion: 1\n     */\n    schemaVersion?: number;\n\n    /**\n     * Display name for this theme (for documentation/debugging)\n     * @example 'Acme Corp Brand Theme'\n     */\n    name?: string;\n\n    /**\n     * Font family override. Applied to --font-sans CSS variable.\n     * @example '\"Figtree\", Arial, Helvetica, sans-serif'\n     */\n    fontFamily?: string;\n\n    /**\n     * CSS custom properties to override.\n     * Keys are CSS variable names WITHOUT the -- prefix.\n     * Values should be valid CSS color values (oklch preferred for modern color handling).\n     *\n     * @example\n     * ```typescript\n     * cssVariables: {\n     *     light: {\n     *         'primary': 'oklch(0.47 0.2 290)',\n     *         'border': 'oklch(0.88 0.01 260)',\n     *     },\n     *     dark: {\n     *         'primary': 'oklch(0.70 0.18 290)',\n     *     }\n     * }\n     * ```\n     */\n    cssVariables?: {\n        /** Light mode variable overrides */\n        light?: Record<string, string>;\n        /** Dark mode variable overrides */\n        dark?: Record<string, string>;\n    };\n\n    /**\n     * Custom color palettes for your brand.\n     * Creates CSS variables like --{paletteName}-{shade}\n     *\n     * @example\n     * ```typescript\n     * customPalettes: {\n     *     brand: {\n     *         '50': 'oklch(0.97 0.01 290)',\n     *         '500': 'oklch(0.47 0.2 290)',\n     *         '900': 'oklch(0.20 0.08 290)',\n     *     }\n     * }\n     * ```\n     */\n    customPalettes?: Record<string, Record<string, string>>;\n\n    /**\n     * Custom header icon for chat apps. Replaces the default AI sparkle icon.\n     * The icon will be constrained to roughly 44x44px.\n     *\n     * Can be specified as:\n     * - A single string URL (used for both light and dark modes)\n     * - An object with separate light/dark URLs for mode-specific icons\n     *\n     * For sync-safe storage, place your icons in:\n     * `apps/pika-chat/static/custom/assets/`\n     *\n     * @example Single icon for both modes:\n     * ```typescript\n     * chatAppHeaderIcon: '/custom/assets/my-logo.svg'\n     * ```\n     *\n     * @example Separate icons for light/dark modes:\n     * ```typescript\n     * chatAppHeaderIcon: {\n     *     light: '/custom/assets/logo-dark.svg',   // Dark logo on light background\n     *     dark: '/custom/assets/logo-light.svg'    // Light logo on dark background\n     * }\n     * ```\n     *\n     * @since 0.16.4\n     */\n    chatAppHeaderIcon?: string | {\n        /** Icon URL for light mode */\n        light: string;\n        /** Icon URL for dark mode (falls back to light if not provided) */\n        dark?: string;\n    };\n}\n\n/**\n * Configuration for the custom theme feature in pika-config.ts\n *\n * @since 0.16.0\n */\nexport interface CustomThemeConfig {\n    /**\n     * Whether custom theming is enabled.\n     * If false, the default Pika theme is used and the theme config is not loaded.\n     */\n    enabled: boolean;\n\n    /**\n     * Path to theme config file relative to apps/pika-chat/\n     * The file must export a `themeConfig` object of type ThemeConfig.\n     *\n     * @default 'src/lib/custom/sample-purple-theme'\n     * @example 'src/lib/custom/my-theme' imports from 'apps/pika-chat/src/lib/custom/my-theme.ts'\n     */\n    themeConfigPath?: string;\n}\n\n/**\n * Standard semantic variable names that can be overridden in a theme.\n * These are the shadcn-svelte standard variables plus Pika extensions.\n *\n * @since 0.16.0\n */\nexport type SemanticColorVariable =\n    // Core shadcn variables\n    | 'background'\n    | 'foreground'\n    | 'card'\n    | 'card-foreground'\n    | 'popover'\n    | 'popover-foreground'\n    | 'primary'\n    | 'primary-foreground'\n    | 'secondary'\n    | 'secondary-foreground'\n    | 'muted'\n    | 'muted-foreground'\n    | 'accent'\n    | 'accent-foreground'\n    | 'destructive'\n    | 'destructive-foreground'\n    | 'border'\n    | 'input'\n    | 'ring'\n    // Chart colors\n    | 'chart-1'\n    | 'chart-2'\n    | 'chart-3'\n    | 'chart-4'\n    | 'chart-5'\n    // Sidebar variants\n    | 'sidebar-background'\n    | 'sidebar-foreground'\n    | 'sidebar-primary'\n    | 'sidebar-primary-foreground'\n    | 'sidebar-accent'\n    | 'sidebar-accent-foreground'\n    | 'sidebar-border'\n    | 'sidebar-ring'\n    // Pika extended semantic colors\n    | 'success'\n    | 'success-foreground'\n    | 'success-bg'\n    | 'warning'\n    | 'warning-foreground'\n    | 'warning-bg'\n    | 'info'\n    | 'info-foreground'\n    | 'info-bg'\n    | 'ai'\n    | 'ai-foreground'\n    | 'ai-bg'\n    | 'danger-bg'\n    // Header/branding\n    | 'chat-app-icon'\n    | 'chat-app-header-icon-height'\n    | 'chat-app-header-icon-gap';\n\n/**\n * All semantic variables as a readonly array for iteration\n *\n * @since 0.16.0\n */\nexport const SEMANTIC_COLOR_VARIABLES: readonly SemanticColorVariable[] = [\n    // Core\n    'background',\n    'foreground',\n    'card',\n    'card-foreground',\n    'popover',\n    'popover-foreground',\n    'primary',\n    'primary-foreground',\n    'secondary',\n    'secondary-foreground',\n    'muted',\n    'muted-foreground',\n    'accent',\n    'accent-foreground',\n    'destructive',\n    'destructive-foreground',\n    'border',\n    'input',\n    'ring',\n    // Charts\n    'chart-1',\n    'chart-2',\n    'chart-3',\n    'chart-4',\n    'chart-5',\n    // Sidebar\n    'sidebar-background',\n    'sidebar-foreground',\n    'sidebar-primary',\n    'sidebar-primary-foreground',\n    'sidebar-accent',\n    'sidebar-accent-foreground',\n    'sidebar-border',\n    'sidebar-ring',\n    // Extended\n    'success',\n    'success-foreground',\n    'success-bg',\n    'warning',\n    'warning-foreground',\n    'warning-bg',\n    'info',\n    'info-foreground',\n    'info-bg',\n    'ai',\n    'ai-foreground',\n    'ai-bg',\n    'danger-bg',\n    // Header/branding\n    'chat-app-icon',\n    'chat-app-header-icon-height',\n    'chat-app-header-icon-gap'\n] as const;\n"]}