@skdx/docs-kit 0.35.0

package/dist/themes/MidnightDark.ts

@@ -0,0 +1,19 @@
+/*
+ * 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 { createBrandTheme } from './createBrandTheme';
+
+/** Midnight purple dark theme: violet actions on deep indigo surfaces, generated via {@link createBrandTheme}. @public */
+export const midnightDark: Theme = createBrandTheme({
+  name: 'midnight-brand',
+  mode: 'dark',
+  primaryHue: 271,
+  primaryChroma: 91,
+  neutralHue: 265,
+  neutralChroma: 25,
+  override: { shadow: { color: '0 0 0', strength: '5.2' } },
+});

package/dist/themes/MidnightLight.md

@@ -0,0 +1,8 @@
+---
+upstream: none
+deviations: []
+---
+
+# themes/midnight-light.ts
+
+Exports **`midnightLight`** — a light theme registered as `data-skdx-theme="midnight-light"`, the `midnight` brand's light mode — the same violet primary ramp as `midnight-brand` on white surfaces (`background: #ffffff`, `surface: #f7f6f8`) with lavender-tinted borders and near-black violet text.

package/dist/themes/MidnightLight.ts

@@ -0,0 +1,23 @@
+/*
+ * 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 { createBrandTheme } from './createBrandTheme';
+
+/**
+ * Light counterpart of `midnight-brand` — violet primary ramp on white surfaces
+ * with lavender-tinted borders. Generated from the same seed as its dark twin.
+ *
+ * @public
+ */
+export const midnightLight: Theme = createBrandTheme({
+  name: 'midnight-light',
+  mode: 'light',
+  primaryHue: 271,
+  primaryChroma: 91,
+  neutralHue: 265,
+  neutralChroma: 25,
+});

package/dist/themes/NordDark.md

@@ -0,0 +1,28 @@
+---
+upstream: Nord
+deviations:
+  - token: success-50..400, success-800..950
+    upstream: none
+    ours: Tailwind green ramp, unchanged
+    reason: Nord defines one green (aurora nord14). An eleven-step status ramp has
+      no upstream to borrow, so only 500/600/700 carry the Nord value and the rest
+      keep Tailwind's ramp for even spacing.
+  - token: warning-50..400, warning-800..950
+    upstream: none
+    ours: Tailwind amber ramp, unchanged
+    reason: Same as success. Nord's aurora yellow (nord13) supplies the mid steps only.
+  - token: danger-50..400, danger-800..950
+    upstream: none
+    ours: Tailwind red ramp, unchanged
+    reason: Same as success. Nord's aurora red (nord11) supplies the mid steps only.
+  - token: danger-600
+    upstream: none
+    ours: #b6656d
+    reason: Read 2.28:1 against the theme background, under the 3:1 floor for status
+      ramps. Lightened on lightness alone, hue and saturation kept, to reach 3.02:1
+      contrast against the theme background.
+---
+
+# themes/nord-dark.ts
+
+Character: "polar night" surfaces (`background: #2e3440`, `surface: #3b4252`), frost-blue primary actions (`#5e81ac` at 500), aurora-inspired status hues on the success/warning/danger ramps, "snow storm" light text (`#eceff4`), and a neutral ramp whose dark steps are remapped to Nord's polar-night grays.

package/dist/themes/NordDark.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';
+
+/** Nord inspired dark theme: polar-night surfaces, frost blue actions, aurora status hues. @public */
+export const nordDark: Theme = {
+  name: 'nord-dark',
+  mode: 'dark',
+  colors: {
+    primary: {
+      50: '#f7f9fb',
+      100: '#edf2f6',
+      200: '#d9e3ec',
+      300: '#c0d0e0',
+      400: '#a9bfd5',
+      500: '#95b0cb',
+      600: '#81a1c1',
+      700: '#69839d',
+      800: '#566b81',
+      900: '#465668',
+      950: '#2b3441',
+    },
+    neutral: {
+      50: '#f8fafc',
+      100: '#f1f5f9',
+      200: '#434c5e',
+      300: '#4c566a',
+      400: '#94a3b8',
+      500: '#64748b',
+      600: '#475569',
+      700: '#334155',
+      800: '#1e293b',
+      900: '#191c25',
+      950: '#020617',
+    },
+    success: {
+      50: '#f0fdf4',
+      100: '#dcfce7',
+      200: '#bbf7d0',
+      300: '#86efac',
+      400: '#4ade80',
+      500: '#a3be8c',
+      600: '#8aa872',
+      700: '#74915e',
+      800: '#166534',
+      900: '#14532d',
+      950: '#052e16',
+    },
+    warning: {
+      50: '#fffbeb',
+      100: '#fef3c7',
+      200: '#fde68a',
+      300: '#fcd34d',
+      400: '#fbbf24',
+      500: '#ebcb8b',
+      600: '#d4b273',
+      700: '#b6955a',
+      800: '#92400e',
+      900: '#78350f',
+      950: '#451a03',
+    },
+    danger: {
+      50: '#fef2f2',
+      100: '#fee2e2',
+      200: '#fecaca',
+      300: '#fca5a5',
+      400: '#f87171',
+      500: '#bf616a',
+      600: '#b6656d',
+      700: '#8d4048',
+      800: '#991b1b',
+      900: '#7f1d1d',
+      950: '#450a0a',
+    },
+    semantic: {
+      background: '#2e3440',
+      surface: '#3b4252',
+      surfaceHover: '#434c5e',
+      overlay: 'rgb(0 0 0 / 0.6)',
+      text: '#eceff4',
+      textMuted: '#a6afc2',
+      textInverted: '#2e3440',
+      border: '#434c5e',
+      borderStrong: '#818da5',
+      focusRing: '#88c0d0',
+    },
+  },
+  shadow: { color: '0 0 0', strength: '4.7' },
+};

package/dist/themes/NordLight.md

@@ -0,0 +1,20 @@
+---
+upstream: Nord
+deviations:
+  - token: success-600
+    upstream: #8aa872
+    ours: #74935a
+    reason: Read 2.79:1 against the theme background, under the 3:1 floor for status
+      ramps. Darkened on lightness alone, hue and saturation kept, to reach 3.00:1
+      contrast against the theme background.
+  - token: warning-600
+    upstream: #d4b273
+    ours: #ac8235
+    reason: Read 2.76:1 against the theme background, under the 3:1 floor for status
+      ramps. Darkened on lightness alone, hue and saturation kept, to reach 3.04:1
+      contrast against the theme background.
+---
+
+# themes/nord-light.ts
+
+Exports **`nordLight`** — a light theme registered as `data-skdx-theme="nord-light"`, the `nord` brand's light mode, built on Nord's "snow storm" palette — `background: #eceff4`, `surface: #e5e9f0`, polar-night text (`#2e3440`), and the same frost-blue primary ramp as `nord-dark`.

package/dist/themes/NordLight.ts

@@ -0,0 +1,50 @@
+/*
+ * 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 { nordDark } from './NordDark';
+
+/** Light counterpart of `nord-dark`, on Nord's Snow Storm palette (#eceff4/#e5e9f0/#d8dee9) with Polar Night text; uses Frost's `nord10` where dark uses `nord9`. @public */
+export const nordLight: Theme = createTheme(
+  'nord-light',
+  {
+    mode: 'light',
+    colors: {
+      primary: {
+        50: '#f4f6f9',
+        100: '#e6ebf0',
+        200: '#cad3df',
+        300: '#a6b6ca',
+        400: '#869cb6',
+        500: '#5e81ac',
+        600: '#4d6d94',
+        700: '#405979',
+        800: '#354964',
+        900: '#2c3c52',
+        950: '#1d2634',
+      },
+      neutral: { 200: '#d8dee9', 300: '#c2c9d6' },
+      // Aurora green/yellow inherited from nord-dark fall under 3:1 (WCAG 1.4.11) on a light wash; darkened on lightness alone to hold the hue.
+      success: { 600: '#74935a' },
+      warning: { 600: '#ac8235' },
+      semantic: {
+        background: '#eceff4',
+        surface: '#e5e9f0',
+        surfaceHover: '#d8dee9',
+        overlay: 'rgb(46 52 64 / 0.4)',
+        text: '#2e3440',
+        textMuted: '#4c566a',
+        textInverted: '#eceff4',
+        border: '#d8dee9',
+        borderStrong: '#7685a3',
+        focusRing: '#5e81ac',
+      },
+    },
+    shadow: { color: '2 6 23', strength: '1' },
+  },
+  nordDark,
+);

package/dist/themes/OneDark.md

@@ -0,0 +1,26 @@
+---
+upstream: Atom One Dark
+deviations:
+  - token: danger-600
+    upstream: none
+    ours: #c54c52
+    reason: Read 2.38:1 against the theme background, under the 3:1 floor for status
+      ramps. Lightened on lightness alone, hue and saturation kept, to reach 3.02:1
+      contrast against the theme background.
+  - token: success-600
+    upstream: none
+    ours: #528139
+    reason: Read 2.63:1 against the theme background, under the 3:1 floor for status
+      ramps. Lightened on lightness alone, hue and saturation kept, to reach 3.04:1
+      contrast against the theme background.
+  - token: text-muted
+    upstream: #919aa8
+    ours: #979fac
+    reason: Read 4.24:1 against selected, 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/one-dark.ts
+
+Character: the classic `#282c34` editor background with `#2c313a` surfaces, One Dark blue actions (`#61afef` at 400) with dark inverted text, One Dark green/yellow/red status hues, soft gray-blue text (`#abb2bf`), and a neutral ramp remapped to the One Dark gutter/comment grays.

package/dist/themes/OneDark.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';
+
+/** Atom One Dark inspired theme: the classic `#282c34` editor background, `#61afef` blue actions. Palette source: atom/one-dark-syntax (MIT). @public */
+export const oneDark: Theme = {
+  name: 'one-dark',
+  mode: 'dark',
+  colors: {
+    primary: {
+      50: '#f6fafe',
+      100: '#e9f4fd',
+      200: '#d0e7fa',
+      300: '#b0d7f7',
+      400: '#94c9f4',
+      500: '#7abcf2',
+      600: '#61afef',
+      700: '#508ec2',
+      800: '#42749e',
+      900: '#365d7f',
+      950: '#22384e',
+    },
+    neutral: {
+      50: '#f7f8fa',
+      100: '#eceef2',
+      200: '#3e4451',
+      300: '#4b5263',
+      400: '#abb2bf',
+      500: '#8e97a6',
+      600: '#5c6370',
+      700: '#3e4451',
+      800: '#2c313a',
+      900: '#21252b',
+      950: '#21252b',
+    },
+    success: {
+      50: '#f4f9f0',
+      100: '#e6f2dd',
+      200: '#cde5bf',
+      300: '#98c379',
+      400: '#7cb058',
+      500: '#609443',
+      600: '#528139',
+      700: '#3c5d2c',
+      800: '#324b27',
+      900: '#2b4023',
+      950: '#142310',
+    },
+    warning: {
+      50: '#fdf9f0',
+      100: '#faf0da',
+      200: '#f5e0b3',
+      300: '#e5c07b',
+      400: '#d8a44e',
+      500: '#c98a2e',
+      600: '#ae6f1f',
+      700: '#8b541c',
+      800: '#71431d',
+      900: '#5f381c',
+      950: '#351d0d',
+    },
+    danger: {
+      50: '#fdf3f4',
+      100: '#fbe5e7',
+      200: '#f8d0d3',
+      300: '#f2abb0',
+      400: '#e06c75',
+      500: '#d04a55',
+      600: '#c54c52',
+      700: '#952f35',
+      800: '#7c2b30',
+      900: '#6a292d',
+      950: '#391114',
+    },
+    semantic: {
+      background: '#282c34',
+      surface: '#2c313a',
+      surfaceHover: '#333842',
+      overlay: 'rgb(0 0 0 / 0.6)',
+      text: '#abb2bf',
+      textMuted: '#979fac',
+      textInverted: '#282c34',
+      border: '#3e4451',
+      borderStrong: '#717b94',
+      focusRing: '#61afef',
+    },
+  },
+  shadow: { color: '0 0 0', strength: '4.7' },
+};

package/dist/themes/OneLight.md

@@ -0,0 +1,20 @@
+---
+upstream: Atom One Light
+deviations:
+  - token: primary-600
+    upstream: #4078f2 (500)
+    ours: #2f66d4
+    reason: One Light's blue at 500 fails AA contrast for white label text on filled
+      buttons. Darkened one step in lightness only, a genuinely different blue from
+      one-dark's value.
+  - token: text-muted
+    upstream: #696c77
+    ours: #636670
+    reason: Read 4.16:1 against hover and 4.16: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/one-light.ts
+
+Exports **`oneLight`** — a light theme registered as `data-skdx-theme="one-light"`, the `one` brand's light mode, following Atom's One Light scheme — `background: #fafafa`, `#383a42` text, and One Light's own blue (`#4078f2` at 500) darkened to `#2f66d4` at 600 so white labels pass AA — a genuinely different blue from one-dark's `#61afef`.

package/dist/themes/OneLight.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 { oneDark } from './OneDark';
+
+/**
+ * Light counterpart of `one-dark`, following One Light's own scheme (#fafafa background, #383a42 text) and its own blue (#4078f2).
+ *
+ * @public
+ */
+export const oneLight: Theme = createTheme(
+  'one-light',
+  {
+    mode: 'light',
+    colors: {
+      primary: {
+        50: '#f3f6fc',
+        100: '#e2eaf9',
+        200: '#c1d1f2',
+        300: '#97b3ea',
+        400: '#7297e2',
+        500: '#4078f2',
+        600: '#2f66d4',
+        700: '#2854ad',
+        800: '#22458d',
+        900: '#1d3872',
+        950: '#142446',
+      },
+      neutral: { 200: '#e5e5e6', 300: '#d0d0d3' },
+      semantic: {
+        background: '#fafafa',
+        surface: '#f0f0f1',
+        surfaceHover: '#e5e5e6',
+        overlay: 'rgb(40 44 52 / 0.4)',
+        text: '#383a42',
+        textMuted: '#636670',
+        textInverted: '#ffffff',
+        border: '#e5e5e6',
+        borderStrong: '#898990',
+        focusRing: '#2f66d4',
+      },
+    },
+    shadow: { color: '2 6 23', strength: '1' },
+  },
+  oneDark,
+);

package/dist/themes/PrimerDark.md

@@ -0,0 +1,26 @@
+---
+upstream: GitHub Primer
+deviations:
+  - token: danger-600
+    upstream: #b62324 (red-6, dark scale)
+    ours: #b92425
+    reason: Read 2.93:1 against the theme background, under the 3:1 floor for status
+      ramps. Lightened on lightness alone, hue and saturation kept, to reach 3.01:1
+      contrast against the theme background.
+  - token: success-600
+    upstream: #196c2e (green-6, dark scale)
+    ours: #1a6f2f
+    reason: Read 2.91:1 against the theme background, under the 3:1 floor for status
+      ramps. Lightened on lightness alone, hue and saturation kept, to reach 3.03:1
+      contrast against the theme background.
+  - token: warning-600
+    upstream: #845306 (yellow-6, dark scale)
+    ours: #885506
+    reason: Read 2.90:1 against the theme background, under the 3:1 floor for status
+      ramps. Lightened on lightness alone, hue and saturation kept, to reach 3.02:1
+      contrast against the theme background.
+---
+
+# themes/primer-dark.ts
+
+Character: `#0d1117` canvas with `#161b22` surfaces, Primer accent blue actions (`#1f6feb` at 600, GitHub's own dark `accent.emphasis`), the Primer dark green/yellow/red functional scales, near-white text (`#e6edf3`), GitHub's 6px corners (md `0.375rem`), and deep near-black shadows. Typography follows the default theme.

package/dist/themes/PrimerDark.ts

@@ -0,0 +1,99 @@
+/*
+ * 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';
+
+/**
+ * Primer Dark inspired theme: GitHub's dark mode — `#0d1117` canvas,
+ * `#1f6feb` accent blue, and the Primer dark green/yellow/red scales.
+ *
+ * @public
+ */
+export const primerDark: Theme = {
+  name: 'primer-dark',
+  mode: 'dark',
+  colors: {
+    primary: {
+      50: '#f2f6fe',
+      100: '#e0ebfc',
+      200: '#bcd4f9',
+      300: '#8fb7f5',
+      400: '#679df1',
+      // Primer's accent.emphasis (the fill its own buttons paint) sits at 500, the step this system paints.
+      500: '#1f6feb',
+      600: '#1c62cd',
+      700: '#1b5bbf',
+      800: '#174b9c',
+      900: '#153d7d',
+      950: '#10264d',
+    },
+    neutral: {
+      50: '#f0f6fc',
+      100: '#c9d1d9',
+      200: '#30363d',
+      300: '#484f58',
+      400: '#6e7681',
+      500: '#484f58',
+      600: '#3d444d',
+      700: '#30363d',
+      800: '#21262d',
+      900: '#161b22',
+      950: '#0d1117',
+    },
+    success: {
+      50: '#aff5b4',
+      100: '#7ee787',
+      200: '#56d364',
+      300: '#3fb950',
+      400: '#2ea043',
+      500: '#238636',
+      600: '#1a6f2f',
+      700: '#0f5323',
+      800: '#033a16',
+      900: '#04260f',
+      950: '#021a0a',
+    },
+    warning: {
+      50: '#f8e3a1',
+      100: '#f2cc60',
+      200: '#e3b341',
+      300: '#d29922',
+      400: '#bb8009',
+      500: '#9e6a03',
+      600: '#885506',
+      700: '#693e00',
+      800: '#4b2900',
+      900: '#341a00',
+      950: '#2a1400',
+    },
+    danger: {
+      50: '#ffdcd7',
+      100: '#ffc1ba',
+      200: '#ffa198',
+      300: '#ff7b72',
+      400: '#f85149',
+      500: '#da3633',
+      600: '#b92425',
+      700: '#8e1519',
+      800: '#67060c',
+      900: '#490202',
+      950: '#370101',
+    },
+    semantic: {
+      background: '#0d1117',
+      surface: '#161b22',
+      surfaceHover: '#21262d',
+      overlay: 'rgb(1 4 9 / 0.8)',
+      text: '#e6edf3',
+      textMuted: '#8b949e',
+      textInverted: '#ffffff',
+      border: '#30363d',
+      borderStrong: '#5f6874',
+      focusRing: '#388bfd',
+    },
+  },
+  shadow: { color: '1 4 9', strength: '3.8' },
+};

package/dist/themes/PrimerLight.md

@@ -0,0 +1,14 @@
+---
+upstream: GitHub Primer
+deviations:
+  - token: text-muted
+    upstream: #656d76
+    ours: #575e65
+    reason: Read 3.61:1 against pressed, under the 4.5:1 floor for body text
+      (hover sat exactly at 4.50:1). Darkened on lightness alone, hue and
+      saturation kept, to clear 4.5:1 against pressed.
+---
+
+# themes/primer-light.ts
+
+Character: white canvas with `#f6f8fa` surfaces, Primer accent blue actions (`#0969da` at 500), the Primer green/yellow/red functional scales on the status ramps, near-black text (`#1f2328`), GitHub's 6px corners (md `0.375rem`), and Primer's soft diffuse shadows. Typography follows the default theme.

package/dist/themes/PrimerLight.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';
+
+/** Primer Light inspired theme: GitHub's light mode — white canvas, `#0969da` accent blue, 6px corners. Palette source: primer/primitives (MIT). @public */
+export const primerLight: Theme = {
+  name: 'primer-light',
+  mode: 'light',
+  colors: {
+    primary: {
+      50: '#ddf4ff',
+      100: '#b6e3ff',
+      200: '#80ccff',
+      300: '#54aeff',
+      400: '#218bff',
+      500: '#0969da',
+      600: '#0550ae',
+      700: '#033d8b',
+      800: '#0a3069',
+      900: '#002155',
+      950: '#001a43',
+    },
+    neutral: {
+      50: '#f6f8fa',
+      100: '#eaeef2',
+      200: '#d0d7de',
+      300: '#afb8c1',
+      400: '#8c959f',
+      500: '#6e7781',
+      600: '#57606a',
+      700: '#424a53',
+      800: '#32383f',
+      900: '#24292f',
+      950: '#171b1f',
+    },
+    success: {
+      50: '#dafbe1',
+      100: '#aceebb',
+      200: '#6fdd8b',
+      300: '#4ac26b',
+      400: '#2da44e',
+      500: '#1a7f37',
+      600: '#116329',
+      700: '#044f1e',
+      800: '#003d16',
+      900: '#002d11',
+      950: '#00230d',
+    },
+    warning: {
+      50: '#fff8c5',
+      100: '#fae17d',
+      200: '#eac54f',
+      300: '#d4a72c',
+      400: '#bf8700',
+      500: '#9a6700',
+      600: '#7d4e00',
+      700: '#633c01',
+      800: '#4d2d00',
+      900: '#3b2300',
+      950: '#2e1a00',
+    },
+    danger: {
+      50: '#ffebe9',
+      100: '#ffcecb',
+      200: '#ffaba8',
+      300: '#ff8182',
+      400: '#fa4549',
+      500: '#cf222e',
+      600: '#a40e26',
+      700: '#82071e',
+      800: '#660018',
+      900: '#4c0014',
+      950: '#3c000f',
+    },
+    semantic: {
+      background: '#ffffff',
+      surface: '#f6f8fa',
+      surfaceHover: '#eaeef2',
+      overlay: 'rgb(31 35 40 / 0.5)',
+      text: '#1f2328',
+      textMuted: '#575e65',
+      textInverted: '#ffffff',
+      border: '#d0d7de',
+      borderStrong: '#818f9d',
+      focusRing: '#0969da',
+    },
+  },
+  shadow: { color: '31 35 40', strength: '1.2' },
+};