dataface 0.1.2__py3-none-any.whl

dataface/core/defaults/palettes/diverging/blue-red.yml

@@ -0,0 +1,25 @@
+# Diverging palette — default blue-red
+#
+
+name: dft-div-blue-red
+family: diverging
+description: Default CVD-safe diverging. Blue (low) to red (high), light midpoint.
+design_notes: |
+  Symmetric arms about midpoint at step 6. RdBu-family editorial posture.
+  Passes CVD under deut/prot/trit at common subset counts (N=3, N=5).
+
+colors:
+  - "#002f55"    # step 1 — low extreme (blue)
+  - "#00508a"
+  - "#2575b9"
+  - "#689bcc"
+  - "#a3c0dd"
+  - "#e4e4e4"    # step 6 — midpoint (neutral light)
+  - "#dcb1a9"
+  - "#c88074"
+  - "#b04f41"
+  - "#852c21"
+  - "#590b05"    # step 11 — high extreme (red)
+
+# Diverging-specific: even-N subsets auto-skip the midpoint, odd-N include it.
+# The resolver handles this — no per-palette YAML data needed.

dataface/core/defaults/palettes/diverging/coolwarm.yml

@@ -0,0 +1,24 @@
+# Diverging palette — Moreland 2009 coolwarm
+#
+
+name: dft-div-coolwarm
+family: diverging
+description: Moreland 2009 coolwarm. Deep blue through light gray to deep red — canonical scientific diverging.
+design_notes: |
+  Referenced from Kenneth Moreland's 2009 paper "Diverging Color Maps for
+  Scientific Visualization". The canonical scientific visualization diverging
+  ramp, widely used in ParaView and VTK. Included for scientific data contexts.
+  Session 3 of M2 palette design.
+
+colors:
+  - "#3b4cc0"
+  - "#5977e3"
+  - "#7b9ef0"
+  - "#a2c3f7"
+  - "#cedcf4"
+  - "#dddddd"
+  - "#f2cbb7"
+  - "#f09482"
+  - "#db6555"
+  - "#b40426"
+  - "#8b0000"

dataface/core/defaults/palettes/diverging/crimson-green.yml

@@ -0,0 +1,23 @@
+# Diverging palette — crimson-green (financial loss/gain)
+#
+
+name: dft-div-crimson-green
+family: diverging
+description: Crimson (low/loss) to green (high/gain). Session 3 red-green exploration D2 design.
+design_notes: |
+  Hue pair H=355°/150° with light asymmetry (dark crimson + light green)
+  engineered to pass CVD where symmetric red-green normally fails. Paired
+  with icon/label in production use per R8 discipline.
+
+colors:
+  - "#540a31"
+  - "#7f2a51"
+  - "#a94c75"
+  - "#c37e99"
+  - "#d9afbe"
+  - "#e4e4e4"
+  - "#a9caae"
+  - "#72ac7e"
+  - "#338f4e"
+  - "#0a6b31"
+  - "#00481d"

dataface/core/defaults/palettes/diverging/orange-teal.yml

@@ -0,0 +1,23 @@
+# Diverging palette — orange-teal (non-politically-loaded)
+#
+
+name: dft-div-orange-teal
+family: diverging
+description: Warm orange (low) to teal (high). Symmetric arms; fully CVD-safe. Non-politically-loaded.
+design_notes: |
+  For contexts where red/blue carries unwanted political connotation.
+  Symmetric arms about step 6 midpoint. Passes CVD under deut/prot/trit.
+  Session 3 of M2 palette design.
+
+colors:
+  - "#4c1f00"
+  - "#7d3700"
+  - "#ab561d"
+  - "#c38562"
+  - "#d9b39f"
+  - "#e4e4e4"
+  - "#96c8c4"
+  - "#47a8a2"
+  - "#00827d"
+  - "#005b57"
+  - "#003634"

dataface/core/defaults/palettes/diverging/sunset.yml

@@ -0,0 +1,24 @@
+# Diverging palette — Paul Tol sunset
+#
+
+name: dft-div-sunset
+family: diverging
+description: Paul Tol's sunset scheme, resampled to 11 stops. SRON-published CVD-safe diverging.
+design_notes: |
+  Multi-hue diverging: teal → cyan → light → yellow → orange → red.
+  Referenced from Paul Tol (SRON) — well-studied CVD-safe diverging ramp.
+  Included for climate/atmospheric data contexts where it is conventional.
+  Session 3 of M2 palette design.
+
+colors:
+  - "#125a56"
+  - "#17858f"
+  - "#48abcd"
+  - "#92c9ee"
+  - "#cee0ea"
+  - "#eceada"
+  - "#f4dc8f"
+  - "#ffb350"
+  - "#f77d36"
+  - "#e03b16"
+  - "#a01813"

dataface/core/defaults/palettes/scaffold/dft-creams.yml

@@ -0,0 +1,38 @@
+# Scaffold palette — dft-creams (warm-canvas UI chrome)
+#
+# Cream-scaffold complement to dft-grays. Use on warm-canvas themes.
+# Theme assigns chrome: dft-creams to get the cream ladder via the same
+# alias vocabulary (chrome.ink, chrome.canvas, etc.) as dft-grays.
+#
+# Inherits the full alias graph from dft-grays via `extends:`. Integer
+# aliases (canvas: 1, ink: 11, etc.) resolve against this palette's own
+# colors array at resolve time — so chrome.ink → cream #2A2725, not gray #222222.
+# Only cream-specific hex overrides are listed below.
+
+name: dft-creams
+extends: dft-grays
+description: |
+  Warm cream-toned scaffold — UI structural framing for warm-canvas themes.
+  Eleven named steps from near-white (025) to near-black (90). Applied to
+  canvas backgrounds, borders, dividers, axis labels, table stripes, and
+  secondary text on editorial/print-styled themes.
+
+colors:
+  - "#FAF7F0"    # 1  canvas
+  - "#F5F2EB"    # 2  surface-subtle
+  - "#E9E1D2"    # 3  grid
+  - "#DDD3C0"    # 4  border
+  - "#CEC1AB"    # 5  grid-emphasis
+  - "#B2A691"    # 6  disabled
+  - "#918878"    # 7  subtitle
+  - "#6F685D"    # 8  muted
+  - "#56504A"    # 9  inactive
+  - "#403B37"    # 10 heading
+  - "#2A2725"    # 11 ink
+
+aliases:
+  # Cream-specific terminal hex overrides — inherited integer ladder from dft-grays
+  fill-muted: "#e8e0d4"
+  separator: "#ddd3bf"
+  spark-empty: "#d9cebf"
+  accent: "#2d74b3"

dataface/core/defaults/palettes/scaffold/dft-grays.yml

@@ -0,0 +1,53 @@
+# Scaffold palette — dft-grays (neutral gray UI chrome)
+#
+# Scaffolds are UI structural framing, NOT data encoding. They live in
+# their own directory to make the taxonomy honest:
+#   palettes/sequential/  — data, ordered magnitude
+#   palettes/diverging/   — data, signed/around midpoint
+#   palettes/categorical/ — data, unordered categories
+#   palettes/scaffold/    — UI structure (canvas/borders/text/stripes)
+#   palettes/tone/        — UI roles (negative/warning/positive)
+#
+# Theme role: chrome. Address form: chrome.ink, chrome.canvas, etc.
+
+name: dft-grays
+description: |
+  Neutral gray scaffold — UI chrome. Eleven named steps from
+  near-white (025) to near-black (90). Applied to canvas backgrounds,
+  borders, dividers, axis labels, table stripes, and secondary text.
+  Pairs with dft-creams for warm-canvas themes.
+
+colors:
+  - "#FAFAFA"    # 1  canvas
+  - "#F7F8FA"    # 2  surface-subtle
+  - "#EDEFF2"    # 3  grid
+  - "#DFE1E5"    # 4  border
+  - "#D0D3D9"    # 5  grid-emphasis
+  - "#B0B2B8"    # 6  disabled
+  - "#8A8C8F"    # 7  subtitle
+  - "#626366"    # 8  muted
+  - "#494A4C"    # 9  inactive
+  - "#313233"    # 10 heading
+  - "#222222"    # 11 ink
+
+aliases:
+  # UI ladder aliases — use these in new authoring
+  canvas: 1
+  surface-subtle: 2
+  grid: 3
+  border: 4
+  grid-emphasis: 5
+  disabled: 6
+  subtitle: 7
+  muted: 8
+  inactive: 9
+  heading: 10
+  ink: 11
+
+  # Extended UI aliases — terminal hex (themes themselves contain no hex)
+  canvas-stark: "#FFFFFF"
+  fill-muted: "#e5e7eb"
+  separator: "#e0e0e0"
+  spark-empty: "#d1d5db"
+  accent: "#3b82f6"
+  placeholder: "#666666"

dataface/core/defaults/palettes/sequential/amber.yml

@@ -0,0 +1,22 @@
+# Sequential palette — amber
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-amber
+family: sequential
+description: Single-hue amber (cream → honey → deep amber). Renamed from dft-seq-gold; mid-stops read as amber/honey rather than pure gold.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Hue anchored on cat-10 gold (H≈82.1°); c_max=0.12 (warm hues need more chroma to read as themselves). Session 8 retune + rename from dft-seq-gold.
+
+colors:
+  - "#f6edde"    # step 1 — lightest
+  - "#e8d5b2"
+  - "#d9bd8a"
+  - "#c8a565"
+  - "#b68e41"
+  - "#a2781a"    # step 6 — mid
+  - "#8b6400"
+  - "#725200"
+  - "#5a4000"
+  - "#432f00"
+  - "#2e1f00"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/blue.yml

@@ -0,0 +1,22 @@
+# Sequential palette — blue
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-blue
+family: sequential
+description: Single-hue blue — default sequential. Sits between cat-10 blue and editorial-10 denim via chroma alone.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Hue anchored on cat-10 blue (H≈248.8°); c_max=0.11 (down from 0.13 to harmonize with editorial-10 themes). Session 8 retune.
+
+colors:
+  - "#e4f0fc"    # step 1 — lightest
+  - "#c1dbf5"
+  - "#9fc5eb"
+  - "#80b0de"
+  - "#649acf"
+  - "#4a85bc"    # step 6 — mid
+  - "#3270a8"
+  - "#1b5b92"
+  - "#04477a"
+  - "#00345d"
+  - "#002341"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/brown.yml

@@ -0,0 +1,22 @@
+# Sequential palette — brown
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-brown
+family: sequential
+description: Low-chroma warm ramp (cream → tan → warm-brown). Pairs with the cream theme. Renamed from dft-seq-warm; hexes unchanged.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Low chroma to harmonize with dft-creams scaffold on warm-canvas themes. Renamed from dft-seq-warm in Session 8; hexes unchanged.
+
+colors:
+  - "#f3eee6"    # step 1 — lightest
+  - "#e7d3cb"
+  - "#d6baad"
+  - "#c4a391"
+  - "#b08d76"
+  - "#9b785e"    # step 6 — mid
+  - "#856447"
+  - "#6e5233"
+  - "#584020"
+  - "#422f11"
+  - "#341911"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/gray.yml

@@ -0,0 +1,22 @@
+# Sequential palette — gray
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-gray
+family: sequential
+description: Pure gray — magnitude without hue connotation. Renamed from dft-seq-neutral; hexes unchanged.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25, chroma=0 (pure achromatic). Use when data magnitude must not imply hue meaning. Renamed from dft-seq-neutral in Session 8; hexes unchanged.
+
+colors:
+  - "#eeeeee"    # step 1 — lightest
+  - "#d7d7d7"
+  - "#c1c1c1"
+  - "#ababab"
+  - "#959595"
+  - "#808080"    # step 6 — mid
+  - "#6c6c6c"
+  - "#585858"
+  - "#454545"
+  - "#333333"
+  - "#222222"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/green.yml

@@ -0,0 +1,22 @@
+# Sequential palette — green
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-green
+family: sequential
+description: Single-hue green. Sits between cat-10 green and editorial-10 sage via chroma alone.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Hue anchored on cat-10 green (H≈161.3°); c_max=0.10 (down from 0.13). Session 8 retune.
+
+colors:
+  - "#e4f3ea"    # step 1 — lightest
+  - "#c0e1cf"
+  - "#9eceb4"
+  - "#7eba9b"
+  - "#60a684"
+  - "#44926e"    # step 6 — mid
+  - "#287d59"
+  - "#086946"
+  - "#005336"
+  - "#003e27"
+  - "#002a19"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/purple.yml

@@ -0,0 +1,22 @@
+# Sequential palette — purple
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-purple
+family: sequential
+description: Single-hue purple. Sits between cat-10 purple and editorial-10 plum via chroma alone.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Hue anchored on cat-10 purple (H≈319.1°); c_max=0.11 (down from 0.13). Session 8 retune.
+
+colors:
+  - "#f5eaf8"    # step 1 — lightest
+  - "#e5ceeb"
+  - "#d4b3dd"
+  - "#c29acd"
+  - "#af82bb"
+  - "#9b6ba8"    # step 6 — mid
+  - "#875694"
+  - "#72427e"
+  - "#5c3068"
+  - "#471f51"
+  - "#32113a"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/rust.yml

@@ -0,0 +1,22 @@
+# Sequential palette — rust
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-rust
+family: sequential
+description: Single-hue rust (cream-peach → terracotta → deep rust). Renamed from dft-seq-orange; mid-stops read as rust/terracotta rather than vivid orange.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Hue anchored on cat-10 orange (H≈41.0°); c_max=0.12. Session 8 retune + rename from dft-seq-orange.
+
+colors:
+  - "#fdeae3"    # step 1 — lightest
+  - "#f6cdbe"
+  - "#ebb29d"
+  - "#dd977d"
+  - "#cc7e61"
+  - "#b96648"    # step 6 — mid
+  - "#a45030"
+  - "#8d3c1b"
+  - "#752907"
+  - "#5a1b00"
+  - "#3e1000"    # step 11 — darkest

dataface/core/defaults/palettes/sequential/teal.yml

@@ -0,0 +1,22 @@
+# Sequential palette — teal
+#
+# Hand-authored 11-stop spine. Downsamples drive seq palette resolution.
+
+name: dft-seq-teal
+family: sequential
+description: Single-hue teal/turquoise. Anchored between cat-10 cyan and editorial-10 teal; replaces dft-seq-cyan.
+design_notes: |
+  Monotonic L* from 0.95 → 0.25. Hue=205° (between editorial-10 teal at 194° and cat-10 cyan at 210°); c_max=0.11. New palette in Session 8.
+
+colors:
+  - "#dff3f5"    # step 1 — lightest
+  - "#b5e1e6"
+  - "#8cced6"
+  - "#64bac4"
+  - "#3aa6b2"
+  - "#00919d"    # step 6 — mid
+  - "#007a85"
+  - "#00646d"
+  - "#004f56"
+  - "#003b40"
+  - "#00272b"    # step 11 — darkest

dataface/core/defaults/palettes/tone/negative.yml

@@ -0,0 +1,32 @@
+# Tone palette — negative
+#
+# Six named role slots. No LUT, no interpolation.
+# Users reference slots directly: negative.solid, negative.text, etc.
+
+name: negative
+description: |
+  Critical errors, destructive actions, negative/loss states.
+  Western learned color convention: red = stop/bad/attention.
+  Session 4 of M2 palette design.
+
+design_notes: |
+  H=22° warm red (shifted slightly from pure red H=15° so light bg/subtle
+  slots read as warm-peach rather than pink). L=0.42 for solid — balanced
+  against positive.solid for CVD ΔE discipline (see r8_validation below).
+  All 6 slots designed so canonical pairs (text-on-bg, solid-on-white) pass
+  WCAG AA. Must be paired with icon + label; color alone is insufficient.
+
+aliases:
+  bg:           "#ffedec"    # very light peach tint for surface backgrounds
+  subtle:       "#ffdbd8"    # hover-on-bg or secondary fill
+  border:       "#e79491"    # mid-tone divider / outline
+  solid:        "#94001e"    # canonical "this is negative" fill
+  solid-hover:  "#6e0014"    # darker variant for button hover state
+  text:         "#4b000a"    # AA-contrast text color on .bg and on white
+
+r8_validation:
+  pair: "negative.solid ↔ positive.solid"
+  cvd_pass: true
+  note: |
+    ΔE under deut/prot/trit all pass R8 threshold. CVD checker is the
+    practical test; ΔL is the proxy. Ship with color + icon + label.

dataface/core/defaults/palettes/tone/positive.yml

@@ -0,0 +1,22 @@
+# Tone palette — positive
+#
+# Six named role slots. No LUT, no interpolation.
+
+name: positive
+description: |
+  Confirmed successful actions, gains, completions.
+  Western learned color convention: green = go/good/safe.
+  Session 4 of M2 palette design.
+
+design_notes: |
+  Blue-shifted green (H=155°), not pure green (H=135°). Picked so negative.solid
+  ↔ positive.solid pass CVD ΔE. solid L=0.55 matches category-10 green L≈0.57.
+  Paired with icon + label in production use.
+
+aliases:
+  bg:           "#e3f8e9"    # very light green background
+  subtle:       "#cff2da"    # secondary fill / hover-on-bg
+  border:       "#82cb9b"    # mid-tone divider / outline
+  solid:        "#00884d"    # canonical "all good" fill
+  solid-hover:  "#006d3c"    # darker variant for button hover state
+  text:         "#003e20"    # AA-contrast text color on .bg and on white

dataface/core/defaults/palettes/tone/warning.yml

@@ -0,0 +1,22 @@
+# Tone palette — warning
+#
+# Six named role slots. No LUT, no interpolation.
+
+name: warning
+description: |
+  Pay attention — something needs input, but nothing's broken.
+  Western learned color convention: amber/gold = caution/slow.
+  Session 4 of M2 palette design.
+
+design_notes: |
+  H=72° — midpoint of exploration candidates W2 and W3. Selected after
+  user feedback that H=60° read too yellow and H=90° too green. Slots
+  tuned for WCAG AA pairing (text-on-bg, solid-on-white).
+
+aliases:
+  bg:           "#fff3e5"    # very light cream-amber background
+  subtle:       "#ffe7ca"    # secondary fill / hover-on-bg
+  border:       "#f0b871"    # mid-tone divider / outline
+  solid:        "#e69812"    # canonical "pay attention" fill
+  solid-hover:  "#c68100"    # darker variant for button hover state
+  text:         "#643f00"    # AA-contrast text color on .bg and on white