@santi020k/theme 1.0.0

package/assets/logos/logo-santi020k.svg

@@ -0,0 +1,9 @@
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 504 80" role="img" aria-label="Santi020k">
+  <g transform="translate(0, 0)">
+    <rect width="80" height="80" rx="18" fill="#5a0fdb" />
+    <path d="M 26 28 L 40 40 L 26 52" fill="none" stroke="#FFFFFF" stroke-width="8" stroke-linecap="round" stroke-linejoin="round" />
+    <line x1="48" y1="52" x2="62" y2="52" stroke="#FFFFFF" stroke-width="8" stroke-linecap="round" />
+  </g>
+  <text x="100" y="54" font-family="Montserrat, Inter, sans-serif" font-weight="800" font-size="48" fill="#332e38" letter-spacing="-0.04em">Santi<tspan fill="#5a0fdb" font-weight="600" letter-spacing="-0.02em">020k</tspan></text>
+</svg>

package/assets/logos/logo-square.svg

@@ -0,0 +1,6 @@
+
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="S2K Mark">
+  <rect width="128" height="128" rx="28" fill="#5a0fdb" />
+  <path d="M 40 44 L 64 64 L 40 84" fill="none" stroke="#FFFFFF" stroke-width="12" stroke-linecap="round" stroke-linejoin="round" />
+  <line x1="74" y1="84" x2="96" y2="84" stroke="#FFFFFF" stroke-width="12" stroke-linecap="round" />
+</svg>

package/assets/vscode/icon.svg

@@ -0,0 +1,5 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" role="img" aria-label="Santi020k Theme terminal mark">
+  <rect width="128" height="128" rx="28" fill="#5a0fdb" />
+  <path d="M 40 44 L 64 64 L 40 84" fill="none" stroke="#ffffff" stroke-width="12" stroke-linecap="round" stroke-linejoin="round" />
+  <line x1="74" y1="84" x2="96" y2="84" stroke="#ffffff" stroke-width="12" stroke-linecap="round" />
+</svg>

package/assets/vscode/previews/preview-dark.svg

@@ -0,0 +1,63 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" role="img" aria-labelledby="title desc">
+  <title id="title">santi020k dark theme preview</title>
+  <desc id="desc">A stylized VS Code editor preview using the santi020k dark color palette.</desc>
+  <rect width="1280" height="720" fill="#0e0919"/>
+  <rect x="0" y="0" width="1280" height="48" fill="#0e0919"/>
+  <rect x="0" y="48" width="76" height="672" fill="#0e0919"/>
+  <rect x="76" y="48" width="260" height="672" fill="#170f25"/>
+  <rect x="336" y="48" width="944" height="42" fill="#0e0919"/>
+  <rect x="336" y="90" width="944" height="630" fill="#120c1e"/>
+  <rect x="356" y="48" width="210" height="42" fill="#120c1e"/>
+  <rect x="356" y="88" width="210" height="2" fill="#8b52d6"/>
+  <text x="382" y="75" fill="#e8e0f0" font-family="Inter, Segoe UI, sans-serif" font-size="15">theme.ts</text>
+  <circle cx="28" cy="24" r="6" fill="#ea6962"/>
+  <circle cx="50" cy="24" r="6" fill="#e8b44a"/>
+  <circle cx="72" cy="24" r="6" fill="#7daea3"/>
+  <rect x="22" y="82" width="32" height="32" rx="8" fill="#261d3a"/>
+  <rect x="22" y="134" width="32" height="32" rx="8" fill="#1e1530"/>
+  <rect x="22" y="186" width="32" height="32" rx="8" fill="#1e1530"/>
+  <text x="104" y="92" fill="#b8a8d8" font-family="Inter, Segoe UI, sans-serif" font-size="13" font-weight="700">EXPLORER</text>
+  <text x="104" y="134" fill="#e8e0f0" font-family="Inter, Segoe UI, sans-serif" font-size="15">santi020k-theme</text>
+  <text x="126" y="176" fill="#c8b8e8" font-family="Inter, Segoe UI, sans-serif" font-size="14">themes</text>
+  <text x="146" y="214" fill="#d4a8ff" font-family="Inter, Segoe UI, sans-serif" font-size="14">santi020k-dark.json</text>
+  <text x="146" y="250" fill="#7868a0" font-family="Inter, Segoe UI, sans-serif" font-size="14">santi020k-light.json</text>
+  <text x="126" y="304" fill="#c8b8e8" font-family="Inter, Segoe UI, sans-serif" font-size="14">scripts</text>
+  <text x="126" y="340" fill="#c8b8e8" font-family="Inter, Segoe UI, sans-serif" font-size="14">website</text>
+  <g font-family="JetBrains Mono, SFMono-Regular, Consolas, monospace" font-size="20">
+    <text x="376" y="142" fill="#584878">01</text>
+    <text x="424" y="142" fill="#a06ee6" font-style="italic">const</text>
+    <text x="488" y="142" fill="#e8e0f0">palette</text>
+    <text x="584" y="142" fill="#9070c0">=</text>
+    <text x="620" y="142" fill="#9070c0">{</text>
+    <text x="376" y="184" fill="#584878">02</text>
+    <text x="464" y="184" fill="#b890f0">surface</text>
+    <text x="548" y="184" fill="#9070c0">:</text>
+    <text x="584" y="184" fill="#d4a8ff">'#120c1e'</text>
+    <text x="376" y="226" fill="#584878">03</text>
+    <text x="464" y="226" fill="#b890f0">accent</text>
+    <text x="536" y="226" fill="#9070c0">:</text>
+    <text x="572" y="226" fill="#d4a8ff">'#c090ff'</text>
+    <text x="376" y="268" fill="#584878">04</text>
+    <text x="464" y="268" fill="#b890f0">muted</text>
+    <text x="524" y="268" fill="#9070c0">:</text>
+    <text x="560" y="268" fill="#d4a8ff">'#7868a0'</text>
+    <text x="376" y="310" fill="#584878">05</text>
+    <text x="424" y="310" fill="#9070c0">}</text>
+    <text x="376" y="374" fill="#584878">06</text>
+    <text x="424" y="374" fill="#584878" font-style="italic">// Modern workbench surfaces stay violet and calm.</text>
+    <text x="376" y="416" fill="#584878">07</text>
+    <text x="424" y="416" fill="#a06ee6" font-style="italic">export</text>
+    <text x="512" y="416" fill="#a06ee6" font-style="italic">function</text>
+    <text x="624" y="416" fill="#c090ff">applyTheme</text>
+    <text x="748" y="416" fill="#9070c0">()</text>
+    <text x="788" y="416" fill="#9070c0">{</text>
+    <text x="376" y="458" fill="#584878">08</text>
+    <text x="464" y="458" fill="#a06ee6" font-style="italic">return</text>
+    <text x="548" y="458" fill="#e8e0f0">palette</text>
+    <text x="376" y="500" fill="#584878">09</text>
+    <text x="424" y="500" fill="#9070c0">}</text>
+  </g>
+  <rect x="336" y="660" width="944" height="60" fill="#0e0919"/>
+  <text x="376" y="696" fill="#b8a8d8" font-family="Inter, Segoe UI, sans-serif" font-size="15">santi020k dark</text>
+  <text x="1110" y="696" fill="#c090ff" font-family="Inter, Segoe UI, sans-serif" font-size="15">validated</text>
+</svg>

package/assets/vscode/previews/preview-light.svg

@@ -0,0 +1,63 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="1280" height="720" viewBox="0 0 1280 720" role="img" aria-labelledby="title desc">
+  <title id="title">santi020k light theme preview</title>
+  <desc id="desc">A stylized VS Code editor preview using the santi020k light color palette.</desc>
+  <rect width="1280" height="720" fill="#e3dff0"/>
+  <rect x="0" y="0" width="1280" height="48" fill="#e3dff0"/>
+  <rect x="0" y="48" width="76" height="672" fill="#e3dff0"/>
+  <rect x="76" y="48" width="260" height="672" fill="#f0edf9"/>
+  <rect x="336" y="48" width="944" height="42" fill="#e3dff0"/>
+  <rect x="336" y="90" width="944" height="630" fill="#f8f6fd"/>
+  <rect x="356" y="48" width="210" height="42" fill="#f8f6fd"/>
+  <rect x="356" y="88" width="210" height="2" fill="#6319be"/>
+  <text x="382" y="75" fill="#302e36" font-family="Inter, Segoe UI, sans-serif" font-size="15">theme.ts</text>
+  <circle cx="28" cy="24" r="6" fill="#c0392b"/>
+  <circle cx="50" cy="24" r="6" fill="#c07a10"/>
+  <circle cx="72" cy="24" r="6" fill="#28a745"/>
+  <rect x="22" y="82" width="32" height="32" rx="8" fill="#ddd8f0"/>
+  <rect x="22" y="134" width="32" height="32" rx="8" fill="#eae7f5"/>
+  <rect x="22" y="186" width="32" height="32" rx="8" fill="#eae7f5"/>
+  <text x="104" y="92" fill="#5a1ab0" font-family="Inter, Segoe UI, sans-serif" font-size="13" font-weight="700">EXPLORER</text>
+  <text x="104" y="134" fill="#302e36" font-family="Inter, Segoe UI, sans-serif" font-size="15">santi020k-theme</text>
+  <text x="126" y="176" fill="#403850" font-family="Inter, Segoe UI, sans-serif" font-size="14">themes</text>
+  <text x="146" y="214" fill="#6319be" font-family="Inter, Segoe UI, sans-serif" font-size="14">santi020k-light.json</text>
+  <text x="146" y="250" fill="#9880c0" font-family="Inter, Segoe UI, sans-serif" font-size="14">santi020k-dark.json</text>
+  <text x="126" y="304" fill="#403850" font-family="Inter, Segoe UI, sans-serif" font-size="14">scripts</text>
+  <text x="126" y="340" fill="#403850" font-family="Inter, Segoe UI, sans-serif" font-size="14">website</text>
+  <g font-family="JetBrains Mono, SFMono-Regular, Consolas, monospace" font-size="20">
+    <text x="376" y="142" fill="#9880c0">01</text>
+    <text x="424" y="142" fill="#5a1ab0" font-style="italic">const</text>
+    <text x="488" y="142" fill="#302e36">palette</text>
+    <text x="584" y="142" fill="#8b52d6">=</text>
+    <text x="620" y="142" fill="#8b52d6">{</text>
+    <text x="376" y="184" fill="#9880c0">02</text>
+    <text x="464" y="184" fill="#6020b8">surface</text>
+    <text x="548" y="184" fill="#8b52d6">:</text>
+    <text x="584" y="184" fill="#7030b0">'#f8f6fd'</text>
+    <text x="376" y="226" fill="#9880c0">03</text>
+    <text x="464" y="226" fill="#6020b8">accent</text>
+    <text x="536" y="226" fill="#8b52d6">:</text>
+    <text x="572" y="226" fill="#7030b0">'#6319be'</text>
+    <text x="376" y="268" fill="#9880c0">04</text>
+    <text x="464" y="268" fill="#6020b8">muted</text>
+    <text x="524" y="268" fill="#8b52d6">:</text>
+    <text x="560" y="268" fill="#7030b0">'#9880c0'</text>
+    <text x="376" y="310" fill="#9880c0">05</text>
+    <text x="424" y="310" fill="#8b52d6">}</text>
+    <text x="376" y="374" fill="#9880c0">06</text>
+    <text x="424" y="374" fill="#9880c0" font-style="italic">// Modern workbench surfaces stay violet and crisp.</text>
+    <text x="376" y="416" fill="#9880c0">07</text>
+    <text x="424" y="416" fill="#5a1ab0" font-style="italic">export</text>
+    <text x="512" y="416" fill="#5a1ab0" font-style="italic">function</text>
+    <text x="624" y="416" fill="#5a18a8">applyTheme</text>
+    <text x="748" y="416" fill="#8b52d6">()</text>
+    <text x="788" y="416" fill="#8b52d6">{</text>
+    <text x="376" y="458" fill="#9880c0">08</text>
+    <text x="464" y="458" fill="#5a1ab0" font-style="italic">return</text>
+    <text x="548" y="458" fill="#302e36">palette</text>
+    <text x="376" y="500" fill="#9880c0">09</text>
+    <text x="424" y="500" fill="#8b52d6">}</text>
+  </g>
+  <rect x="336" y="660" width="944" height="60" fill="#6319be"/>
+  <text x="376" y="696" fill="#ffffff" font-family="Inter, Segoe UI, sans-serif" font-size="15">santi020k light</text>
+  <text x="1110" y="696" fill="#ffffff" font-family="Inter, Segoe UI, sans-serif" font-size="15">validated</text>
+</svg>

package/docs/brand-guidelines.md

@@ -0,0 +1,7 @@
+# Santi020k Theme Brand Guidelines
+
+The canonical brand source of truth now lives at:
+
+[`../../../docs/brand-guidelines.md`](../../../docs/brand-guidelines.md)
+
+Keep brand direction, product names, palette rules, voice guidance, asset usage, and AI agent instructions there so the VS Code theme, Chrome theme, shared packages, and all websites stay aligned over time.

package/index.d.ts

@@ -0,0 +1,100 @@
+import type {
+  AssetManifest,
+  BrandAsset,
+  BrandAssetCategory,
+  BrandConfig,
+  BrandSurface,
+  ColorToken,
+  TypographyConfig,
+  VoiceConfig
+} from '@santi020k/theme-core'
+
+export declare const packageName: '@santi020k/theme'
+export declare const chromeThemeVariants: ['dark', 'light']
+export declare const chromeThemeVariantManifests: Record<
+  ChromeThemeVariant,
+  {
+    manifest: string
+    output: string
+  }
+>
+export declare const chromeThemeImageRequirements: Record<
+  string,
+  {
+    format: 'png'
+    minWidth: number
+    minHeight: number
+  }
+>
+export declare const chromeThemeSourceTokenRoles: {
+  chrome: string
+  source: string
+  transform?: string
+}[]
+export declare const chromeThemeContrastPairs: {
+  fg: string
+  bg: string
+  label: string
+  minRatio?: number
+}[]
+export declare const chromeRuntimeAssetEntries: {
+  destination: string
+  source: string
+}[]
+export type ChromeThemeVariant = typeof chromeThemeVariants[number]
+export type RgbColor = [number, number, number]
+export declare const colors: ColorToken[]
+export declare const typography: TypographyConfig
+export declare const fontFamily: {
+  sans: string
+  display: string
+  mono: string
+}
+export declare const staticAssets: Record<string, string>
+export declare const assets: BrandAsset[]
+export declare const manifest: AssetManifest
+export interface ProjectImageMetadata {
+  src: string
+  horizontal: string
+  vertical: string
+  logo: string
+  logoAspect: 'square' | 'portrait' | 'landscape'
+  logoSurface: 'dark' | 'light' | 'transparent'
+  alt: string
+}
+export interface ProjectMetadata {
+  slug: string
+  title: string
+  description: string
+  role: string
+  startingDate: string
+  githubUrl: string
+  liveDemoUrl: string
+  typesId: string
+  impactMetrics: string[]
+  technologies: string[]
+  coverImage: ProjectImageMetadata
+  previewImage: string
+}
+export declare const projects: {
+  santi020kTheme: ProjectMetadata
+}
+export declare const voice: VoiceConfig
+export declare const config: BrandConfig
+export declare function isChromeThemeVariant(variant: string): variant is ChromeThemeVariant
+export declare function hexToRgb(hex: string): RgbColor
+export declare function darkenRgb(rgb: RgbColor | number[], factor: number): RgbColor
+export declare function darkenHex(hex: string, factor: number): RgbColor
+export declare function clampRgb(rgb: RgbColor | number[]): RgbColor
+export declare function getRgbLuminance(rgb: RgbColor | number[]): number
+export declare function getRgbContrastRatio(rgb1: RgbColor | number[], rgb2: RgbColor | number[]): number
+export declare function createChromeThemeFromVSCodeColors(
+  vscodeColors: Record<string, string>,
+  variant?: ChromeThemeVariant
+): {
+  colors: Record<string, RgbColor>
+  properties: Record<string, string | number>
+}
+export declare function getAsset(path: string): BrandAsset | undefined
+export declare function getAssets(category: BrandAssetCategory): BrandAsset[]
+export declare function getSurfaceAssets(surface: BrandSurface): BrandAsset[]