@skdx/docs-kit 0.35.0

package/dist/themes/RosePine.md

@@ -0,0 +1,23 @@
+---
+upstream: Rosé Pine
+deviations:
+  - token: neutral-400
+    upstream: #908caa (subtle)
+    ours: #6e6a86 (muted)
+    reason: In dark mode this step is the disabled ink and nothing else, and holding
+      subtle made it identical to text-muted, so a disabled control was
+      indistinguishable from an enabled one. Remapped to Rosé Pine's own muted
+      rather than inventing a value; text-muted was later lightened off subtle,
+      see its own entry. Rosé Pine publishes nothing between subtle and muted,
+      so steps 400 and 500 now state the same colour.
+  - token: text-muted
+    upstream: #908caa (subtle)
+    ours: #a3a0b8
+    reason: Read 3.55:1 against selected, the primary-950 wash, under the 4.5:1
+      floor for body text. Lightened on lightness alone, hue and saturation kept,
+      to clear 4.5:1 against selected.
+---
+
+# themes/rose-pine.ts
+
+Character: `#191724` base with `#1f1d2e` surfaces, iris purple actions (`#c4a7e7` at 400) with dark inverted text, foam/gold/love hues on the success/warning/danger ramps, lavender text (`#e0def4`), and a neutral ramp built from the muted/subtle/overlay/highlight tones.

package/dist/themes/RosePine.ts

@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2026 SkandaDX
+ * This file is part of the SkandaDX organization.
+ * Licensed under the MIT License. See LICENSE in the repository root.
+ */
+
+import type { Theme } from '../utils/theme';
+
+/** Rosé Pine inspired dark theme: soho-vibes `#191724` base, iris purple actions, muted lavender grays. Palette source: rose-pine/rose-pine-theme (MIT). @public */
+export const rosePine: Theme = {
+  name: 'rose-pine',
+  mode: 'dark',
+  colors: {
+    primary: {
+      50: '#fbfafe',
+      100: '#f7f3fc',
+      200: '#ede5f8',
+      300: '#e2d3f3',
+      400: '#d7c3ef',
+      500: '#cdb5eb',
+      600: '#c4a7e7',
+      700: '#9f88bc',
+      800: '#816e99',
+      900: '#67597b',
+      950: '#3e364b',
+    },
+    neutral: {
+      50: '#f7f6fb',
+      100: '#edeaf6',
+      200: '#26233a',
+      300: '#403d52',
+      400: '#75718d',
+      500: '#6e6a86',
+      600: '#5b5876',
+      700: '#524f67',
+      800: '#26233a',
+      900: '#1f1d2e',
+      950: '#16141f',
+    },
+    success: {
+      50: '#f1f9fa',
+      100: '#def0f3',
+      200: '#c2e3e8',
+      300: '#9ccfd8',
+      400: '#6db4c2',
+      500: '#4d99a9',
+      600: '#3d7d8e',
+      700: '#366675',
+      800: '#325561',
+      900: '#2e4853',
+      950: '#1a2e37',
+    },
+    warning: {
+      50: '#fef9f0',
+      100: '#fdf0da',
+      200: '#fbdfb3',
+      300: '#f6c177',
+      400: '#f2a747',
+      500: '#ec8d24',
+      600: '#d67118',
+      700: '#b25416',
+      800: '#8f4219',
+      900: '#753818',
+      950: '#421c0a',
+    },
+    danger: {
+      50: '#fdf2f5',
+      100: '#fce7ec',
+      200: '#fad0db',
+      300: '#f5a8bc',
+      400: '#eb6f92',
+      500: '#dd4874',
+      600: '#c72e60',
+      700: '#a72150',
+      800: '#8b1f48',
+      900: '#771e42',
+      950: '#420b21',
+    },
+    semantic: {
+      background: '#191724',
+      surface: '#1f1d2e',
+      surfaceHover: '#26233a',
+      overlay: 'rgb(0 0 0 / 0.6)',
+      text: '#e0def4',
+      textMuted: '#a3a0b8',
+      textInverted: '#191724',
+      border: '#26233a',
+      borderStrong: '#6b668a',
+      focusRing: '#c4a7e7',
+    },
+  },
+  shadow: { color: '0 0 0', strength: '4.7' },
+};

package/dist/themes/RosePineDawn.md

@@ -0,0 +1,20 @@
+---
+upstream: Rosé Pine Dawn
+deviations:
+  - token: primary-600
+    upstream: #907aa9 (500)
+    ours: #6f5c85
+    reason: Rosé Pine Dawn's iris at 500 fails AA contrast for white label text on
+      filled buttons. Darkened one step in lightness only, restating Dawn's own iris
+      rather than lightening Main's purple.
+  - token: text-muted
+    upstream: #716d8c
+    ours: #605d77
+    reason: Read 4.10:1 against hover and 3.55:1 against pressed, under the 4.5:1
+      floor for body text. Darkened on lightness alone, hue and saturation kept,
+      to clear 4.5:1 against both fills.
+---
+
+# themes/rose-pine-dawn.ts
+
+Exports **`rosePineDawn`** — a light theme registered as `data-skdx-theme="rose-pine-dawn"`, the `rose-pine` brand's light mode, built on the Rosé Pine Dawn variant — `background: #faf4ed`, muted iris text (`#575279`), and Dawn's own iris (`#907aa9` at 500) darkened to `#6f5c85` at 600 so white labels pass AA — Dawn restates iris rather than lightening Main's `#c4a7e7`.

package/dist/themes/RosePineDawn.ts

@@ -0,0 +1,51 @@
+/*
+ * Copyright (c) 2026 SkandaDX
+ * This file is part of the SkandaDX organization.
+ * Licensed under the MIT License. See LICENSE in the repository root.
+ */
+
+import type { Theme } from '../utils/theme';
+import { createTheme } from './DefaultTheme';
+import { rosePine } from './RosePine';
+
+/**
+ * Light counterpart of `rose-pine`, on Rosé Pine Dawn (#faf4ed base, #575279 text) with Dawn's own softer iris (#907aa9).
+ *
+ * @public
+ */
+export const rosePineDawn: Theme = createTheme(
+  'rose-pine-dawn',
+  {
+    mode: 'light',
+    colors: {
+      primary: {
+        50: '#f6f5f8',
+        100: '#ebe8ee',
+        200: '#d4ceda',
+        300: '#b7aec2',
+        400: '#9d90ac',
+        500: '#907aa9',
+        600: '#6f5c85',
+        700: '#5b4c6d',
+        800: '#4b3e5b',
+        900: '#3d334a',
+        950: '#262130',
+      },
+      neutral: { 200: '#dfdad9', 300: '#cecacd' },
+      semantic: {
+        background: '#faf4ed',
+        surface: '#fffaf3',
+        surfaceHover: '#f2e9e1',
+        overlay: 'rgb(25 23 36 / 0.4)',
+        text: '#575279',
+        textMuted: '#605d77',
+        textInverted: '#ffffff',
+        border: '#dfdad9',
+        borderStrong: '#938a91',
+        focusRing: '#6f5c85',
+      },
+    },
+    shadow: { color: '2 6 23', strength: '1' },
+  },
+  rosePine,
+);

package/dist/themes/SkandaDark.md

@@ -0,0 +1,8 @@
+---
+upstream: none
+deviations: []
+---
+
+# themes/skanda-dark.ts
+
+Exports **`skandaDark`** — a dark theme registered as `data-skdx-theme="skanda-dark"`, the `skanda` brand's dark mode — the same Skanda blue primary ramp as `skanda-light` on deep slate surfaces (`background: #0f172a`, `surface: #1e293b`), light slate text, and slate borders remapped onto the neutral 200/300 steps.

package/dist/themes/SkandaDark.ts

@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) 2026 SkandaDX
+ * This file is part of the SkandaDX organization.
+ * Licensed under the MIT License. See LICENSE in the repository root.
+ */
+
+import type { Theme } from '../utils/theme';
+import { createTheme } from './DefaultTheme';
+import { skandaLight } from './SkandaLight';
+
+/**
+ * Dark counterpart of `skanda-light` — Skanda blue on deep slate.
+ * The ramp is shifted one step lighter; mid-blue tuned for white becomes
+ * too dark as an accent on `#0f172a`.
+ *
+ * @public
+ */
+export const skandaDark: Theme = createTheme(
+  'skanda-dark',
+  {
+    mode: 'dark',
+    colors: {
+      primary: {
+        50: '#f6f9fe',
+        100: '#e9f0fe',
+        200: '#d0dffc',
+        300: '#b0c9fa',
+        400: '#94b6f8',
+        500: '#7aa4f7',
+        600: '#6193f5',
+        700: '#5078c7',
+        800: '#4262a2',
+        900: '#364f82',
+        950: '#22304f',
+      },
+      // 800 shifted half a step off the unmodified ramp: it lands on the same hex as
+      // `semantic.surface` below otherwise, making disabled/hover fills that draw from
+      // the neutral ramp (see darkColorAliases) indistinguishable from the resting surface.
+      neutral: { 200: '#334155', 300: '#475569', 800: '#293548' },
+      semantic: {
+        background: '#0f172a',
+        surface: '#1e293b',
+        surfaceHover: '#334155',
+        overlay: 'rgb(2 6 23 / 0.7)',
+        text: '#f1f5f9',
+        // One notch brighter than slate-400, so muted text stays distinct from the disabled ink at that value.
+        textMuted: '#b0bdcc',
+        textInverted: '#0f172a',
+        border: '#334155',
+        borderStrong: '#60738e',
+        focusRing: '#6193f5',
+      },
+    },
+    shadow: { color: '0 0 0', strength: '4.7' },
+  },
+  skandaLight,
+);

package/dist/themes/SkandaLight.md

@@ -0,0 +1,8 @@
+---
+upstream: none
+deviations: []
+---
+
+# themes/skanda-light.ts
+
+Character: SkandaDX blue primary (`#3d6eef` at 500), slate neutrals, white background with slate text. Type, space, radii, shadow geometry and motion are the shared foundation every theme inherits; this theme is the reference tint for them (`shadow: { color: '2 6 23', strength: '1' }`).

package/dist/themes/SkandaLight.ts

@@ -0,0 +1,96 @@
+/*
+ * Copyright (c) 2026 SkandaDX
+ * This file is part of the SkandaDX organization.
+ * Licensed under the MIT License. See LICENSE in the repository root.
+ */
+
+import type { Theme } from '../utils/theme';
+
+/** The default SkandaDX light theme — identical to `defaultTheme`. @public */
+export const skandaLight: Theme = {
+  name: 'skanda-light',
+  mode: 'light',
+  colors: {
+    primary: {
+      50: '#eef4ff',
+      100: '#dce7fd',
+      200: '#c0d4fc',
+      300: '#94b8fa',
+      400: '#6193f5',
+      500: '#3d6eef',
+      600: '#274ee3',
+      700: '#1f3bd0',
+      800: '#2032a9',
+      900: '#1f2f85',
+      950: '#171f51',
+    },
+    neutral: {
+      50: '#f8fafc',
+      100: '#f1f5f9',
+      200: '#e2e8f0',
+      300: '#cbd5e1',
+      400: '#94a3b8',
+      500: '#64748b',
+      600: '#475569',
+      700: '#334155',
+      800: '#1e293b',
+      900: '#0f172a',
+      950: '#020617',
+    },
+    success: {
+      50: '#f0fdf4',
+      100: '#dcfce7',
+      200: '#bbf7d0',
+      300: '#86efac',
+      400: '#4ade80',
+      500: '#22c55e',
+      600: '#16a34a',
+      700: '#15803d',
+      800: '#166534',
+      900: '#14532d',
+      950: '#052e16',
+    },
+    warning: {
+      50: '#fffbeb',
+      100: '#fef3c7',
+      200: '#fde68a',
+      300: '#fcd34d',
+      400: '#fbbf24',
+      500: '#f59e0b',
+      600: '#d97706',
+      700: '#b45309',
+      800: '#92400e',
+      900: '#78350f',
+      950: '#451a03',
+    },
+    danger: {
+      50: '#fef2f2',
+      100: '#fee2e2',
+      200: '#fecaca',
+      300: '#fca5a5',
+      400: '#f87171',
+      500: '#ef4444',
+      600: '#dc2626',
+      700: '#b91c1c',
+      800: '#991b1b',
+      900: '#7f1d1d',
+      950: '#450a0a',
+    },
+    semantic: {
+      background: '#ffffff',
+      surface: '#f8fafc',
+      surfaceHover: '#f1f5f9',
+      overlay: 'rgb(2 6 23 / 0.5)',
+      text: '#0f172a',
+      // neutral-600, not 500: muted text also lands on tinted surfaces (selected cards,
+      // popovers), where 500 falls to 4.31:1.
+      textMuted: '#475569',
+      textInverted: '#ffffff',
+      border: '#e2e8f0',
+      // Darkened on lightness alone: borderStrong is a control boundary, needs 3:1 (WCAG 1.4.11).
+      borderStrong: '#7d8b9d',
+      focusRing: '#3d6eef',
+    },
+  },
+  shadow: { color: '2 6 23', strength: '1' },
+};

package/dist/themes/SolarizedDark.md

@@ -0,0 +1,8 @@
+---
+upstream: Solarized
+deviations: []
+---
+
+# themes/solarized-dark.ts
+
+Character: deep `#002b36` background with `#073642` surfaces, Solarized blue actions (`#268bd2` at 600), the same green/yellow/red status ramps as `solarized-light`, gray-cyan text (`#93a1a1`), and dark inverted text (`#271d03`) on filled actions.

package/dist/themes/SolarizedDark.ts

@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2026 SkandaDX
+ * This file is part of the SkandaDX organization.
+ * Licensed under the MIT License. See LICENSE in the repository root.
+ */
+
+import type { Theme } from '../utils/theme';
+
+/** Solarized Dark inspired theme: deep `#002b36` background, `#268bd2` blue actions. Palette source: altercation/solarized (MIT). @public */
+export const solarizedDark: Theme = {
+  name: 'solarized-dark',
+  mode: 'dark',
+  colors: {
+    primary: {
+      50: '#f0f7fc',
+      100: '#ddeef9',
+      200: '#c0e0f4',
+      300: '#94cbec',
+      400: '#61b0e2',
+      500: '#3399d9',
+      600: '#268bd2',
+      700: '#1f6fb0',
+      800: '#1e5c8f',
+      900: '#1e4d76',
+      950: '#143049',
+    },
+    neutral: {
+      50: '#f5f9fa',
+      100: '#eaf1f2',
+      200: '#073642',
+      300: '#155463',
+      400: '#93a1a1',
+      500: '#839496',
+      600: '#657b83',
+      700: '#586e75',
+      800: '#073642',
+      900: '#001d24',
+      950: '#001d24',
+    },
+    success: {
+      50: '#f8faeb',
+      100: '#eef3d3',
+      200: '#dde8ac',
+      300: '#c5d87c',
+      400: '#a9c353',
+      500: '#96ad14',
+      600: '#859900',
+      700: '#67770a',
+      800: '#535f0e',
+      900: '#465011',
+      950: '#252c05',
+    },
+    warning: {
+      50: '#fdf9e9',
+      100: '#faf0c6',
+      200: '#f5df90',
+      300: '#eec850',
+      400: '#e5ad22',
+      500: '#d49812',
+      600: '#b58900',
+      700: '#92670a',
+      800: '#78500f',
+      900: '#664213',
+      950: '#3b2208',
+    },
+    danger: {
+      50: '#fdf3f2',
+      100: '#fce4e3',
+      200: '#facdcc',
+      300: '#f5aaa8',
+      400: '#ee7a77',
+      500: '#e2504c',
+      600: '#dc322f',
+      700: '#b92623',
+      800: '#992320',
+      900: '#7f2321',
+      950: '#450e0d',
+    },
+    semantic: {
+      background: '#002b36',
+      surface: '#073642',
+      surfaceHover: '#0a4152',
+      overlay: 'rgb(0 0 0 / 0.6)',
+      text: '#93a1a1',
+      textMuted: '#8b9b9d',
+      textInverted: '#271d03',
+      border: '#0d4354',
+      borderStrong: '#20869d',
+      focusRing: '#268bd2',
+    },
+  },
+  shadow: { color: '0 0 0', strength: '4.7' },
+};

package/dist/themes/SolarizedLight.md

@@ -0,0 +1,32 @@
+---
+upstream: Solarized
+deviations:
+  - token: success-600
+    upstream: #859900
+    ours: #849800
+    reason: Read 2.97:1 against the theme background, under the 3:1 floor for status
+      ramps. Darkened on lightness alone, hue and saturation kept, to reach 3.01:1
+      contrast against the theme background.
+  - token: warning-600
+    upstream: #b58900
+    ours: #b48800
+    reason: Read 2.98:1 against the theme background, under the 3:1 floor for status
+      ramps. Darkened on lightness alone, hue and saturation kept, to reach 3.01:1
+      contrast against the theme background.
+  - token: text-muted
+    upstream: #586b72
+    ours: #516269
+    reason: Read 4.11:1 against hover and 3.99:1 against pressed, under the 4.5:1
+      floor for body text. Darkened on lightness alone, hue and saturation kept,
+      to clear 4.5:1 against both fills.
+  - token: primary-700
+    upstream: #1f6fb0
+    ours: #1c65a0
+    reason: Solarized blue's link ink read 4.33:1 against surface and 3.91:1
+      against hover, under the 4.5:1 floor for body text. Darkened on lightness
+      alone, hue and saturation kept, to clear 4.5:1 against both fills.
+---
+
+# themes/solarized-light.ts
+
+Character: the classic cream background (`#fdf6e3`) with `#eee8d5` surfaces, Solarized blue actions (`#268bd2` at 600), the green/yellow/red accent hues on the status ramps, deep teal text (`#073642`), and a neutral ramp blending the warm base2 tones with the base01–base03 darks.

package/dist/themes/SolarizedLight.ts

@@ -0,0 +1,93 @@
+/*
+ * Copyright (c) 2026 SkandaDX
+ * This file is part of the SkandaDX organization.
+ * Licensed under the MIT License. See LICENSE in the repository root.
+ */
+
+import type { Theme } from '../utils/theme';
+
+/** Solarized Light inspired theme: the classic `#fdf6e3` cream background, `#268bd2` blue actions. Palette source: altercation/solarized (MIT). @public */
+export const solarizedLight: Theme = {
+  name: 'solarized-light',
+  mode: 'light',
+  colors: {
+    primary: {
+      50: '#f0f7fc',
+      100: '#ddeef9',
+      200: '#c0e0f4',
+      300: '#94cbec',
+      400: '#61b0e2',
+      500: '#3399d9',
+      600: '#268bd2',
+      700: '#1c65a0',
+      800: '#1e5c8f',
+      900: '#1e4d76',
+      950: '#143049',
+    },
+    neutral: {
+      50: '#fdf9ec',
+      100: '#eee8d5',
+      200: '#e0dac6',
+      300: '#c8c2b0',
+      400: '#93a1a1',
+      500: '#839496',
+      600: '#657b83',
+      700: '#586e75',
+      800: '#073642',
+      900: '#002b36',
+      950: '#00212b',
+    },
+    success: {
+      50: '#f8faeb',
+      100: '#eef3d3',
+      200: '#dde8ac',
+      300: '#c5d87c',
+      400: '#a9c353',
+      500: '#96ad14',
+      600: '#849800',
+      700: '#67770a',
+      800: '#535f0e',
+      900: '#465011',
+      950: '#252c05',
+    },
+    warning: {
+      50: '#fdf9e9',
+      100: '#faf0c6',
+      200: '#f5df90',
+      300: '#eec850',
+      400: '#e5ad22',
+      500: '#d49812',
+      600: '#b48800',
+      700: '#92670a',
+      800: '#78500f',
+      900: '#664213',
+      950: '#3b2208',
+    },
+    danger: {
+      50: '#fdf3f2',
+      100: '#fce4e3',
+      200: '#facdcc',
+      300: '#f5aaa8',
+      400: '#ee7a77',
+      500: '#e2504c',
+      600: '#dc322f',
+      700: '#b92623',
+      800: '#992320',
+      900: '#7f2321',
+      950: '#450e0d',
+    },
+    semantic: {
+      background: '#fdf6e3',
+      surface: '#eee8d5',
+      surfaceHover: '#e4ddc8',
+      overlay: 'rgb(0 43 54 / 0.5)',
+      text: '#073642',
+      textMuted: '#516269',
+      textInverted: '#271d03',
+      border: '#ddd6c1',
+      borderStrong: '#90835b',
+      focusRing: '#268bd2',
+    },
+  },
+  shadow: { color: '0 43 54', strength: '1.3' },
+};

package/dist/themes/SynthwaveDark.md

@@ -0,0 +1,8 @@
+---
+upstream: daisyUI Synthwave
+deviations: []
+---
+
+# themes/synthwave-dark.ts
+
+Character: deep indigo `#1a103d` background with violet surfaces (`#251b4f`, `#2f2465`), hot-pink actions (`#e779c1` at 400) with dark inverted text, mint success / retro-sunset yellow / rose danger status ramps, near-white text with periwinkle muted text (`#a89ed8`), and heavy indigo-black shadows.