@djangocfg/ui-core 2.1.566 → 2.1.569

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@djangocfg/ui-core",
3
- "version": "2.1.566",
3
+ "version": "2.1.569",
4
4
  "description": "Pure React UI component library without Next.js dependencies - for Electron, Vite, CRA apps",
5
5
  "keywords": [
6
6
  "ui-components",
@@ -130,7 +130,7 @@
130
130
  "check:contrast": "node scripts/check-preset-contrast.mjs"
131
131
  },
132
132
  "peerDependencies": {
133
- "@djangocfg/i18n": "^2.1.566",
133
+ "@djangocfg/i18n": "^2.1.569",
134
134
  "consola": "^3.4.2",
135
135
  "lucide-react": "^0.545.0",
136
136
  "moment": "^2.30.1",
@@ -206,9 +206,9 @@
206
206
  "vaul": "1.1.2"
207
207
  },
208
208
  "devDependencies": {
209
- "@djangocfg/eslint-config": "^2.1.566",
210
- "@djangocfg/i18n": "^2.1.566",
211
- "@djangocfg/typescript-config": "^2.1.566",
209
+ "@djangocfg/eslint-config": "^2.1.569",
210
+ "@djangocfg/i18n": "^2.1.569",
211
+ "@djangocfg/typescript-config": "^2.1.569",
212
212
  "@storybook/react-vite": "^10.5.0",
213
213
  "@types/node": "^24.13.3",
214
214
  "@types/react": "19.2.15",
@@ -104,6 +104,23 @@ An element inside an ancestor that already has `backdrop-filter` cannot blur the
104
104
  page behind that ancestor: the ancestor becomes a backdrop root. Render such
105
105
  surfaces through a body portal, positioned from their trigger.
106
106
 
107
+ `--overlay` is a modal BACKDROP — the wash between a dialog and the page. It is
108
+ not the colour of text laid over a photograph.
109
+
110
+ ### Text over a consumer's image
111
+
112
+ There is **no token for this, deliberately.** Every semantic pair answers "what
113
+ colour is text on OUR surface", and a photograph is not one: it is arbitrary
114
+ content the consumer supplies, kept legible by a scrim the component paints.
115
+ `--foreground` over a darkened photo inverts to near-black in light mode and
116
+ disappears into the picture.
117
+
118
+ So a component rendering over media fixes a literal light colour and pairs it
119
+ with a scrim it controls — `AuthLayout`'s `.auth-brand-panel` is the worked
120
+ example. This is the "branded assets or an explicitly documented case" escape
121
+ in the rule above; keep the literal next to the comment that explains it, and
122
+ do not invent a `--on-media` token for one component.
123
+
107
124
  ## Preset rules
108
125
 
109
126
  - Values live in `styles/css/presets/*.css`. `styles/presets/*.ts` holds names