@link-foundation/ui-themes 0.0.0-stage → 0.0.0

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.
Files changed (110) hide show
  1. package/LICENSE +24 -0
  2. package/README.md +121 -2
  3. package/package.json +52 -4
  4. package/src/classic/catalog.js +193 -0
  5. package/src/classic/effect-governor.js +199 -0
  6. package/src/classic/effect-quality.js +76 -0
  7. package/src/classic/frame-color.js +27 -0
  8. package/src/classic/frame-css-controls.js +65 -0
  9. package/src/classic/frame-css-corners.js +138 -0
  10. package/src/classic/frame-css-edge-geometry.js +74 -0
  11. package/src/classic/frame-css-edges.js +99 -0
  12. package/src/classic/frame-css-enums.js +65 -0
  13. package/src/classic/frame-css-geometry.js +133 -0
  14. package/src/classic/frame-css-modes.js +45 -0
  15. package/src/classic/frame-css-states.js +85 -0
  16. package/src/classic/frame-css-values.js +156 -0
  17. package/src/classic/frame-css.js +232 -0
  18. package/src/classic/frame-geometry.js +189 -0
  19. package/src/classic/frame-schema.js +328 -0
  20. package/src/classic/frame-vocabulary.js +10 -0
  21. package/src/classic/frames.d.ts +143 -0
  22. package/src/classic/frames.js +77 -0
  23. package/src/classic/material-visibility.js +94 -0
  24. package/src/classic/materials.d.ts +133 -0
  25. package/src/classic/materials.js +139 -0
  26. package/src/classic/optical-css.js +47 -0
  27. package/src/classic/optics.js +107 -0
  28. package/src/classic/refraction.js +145 -0
  29. package/src/fluent2/brand-aliases.js +157 -0
  30. package/src/fluent2/brand.js +84 -0
  31. package/src/fluent2/names.js +31 -0
  32. package/src/index.d.ts +54 -0
  33. package/src/index.js +79 -0
  34. package/src/mapping.js +135 -0
  35. package/src/material3/mapping.js +18 -0
  36. package/src/material3/mui.js +128 -0
  37. package/src/material3/seed.js +144 -0
  38. package/themes/base/theme.lino +35 -0
  39. package/themes/classic/README.md +90 -0
  40. package/themes/classic/deepcase/2025.lino +156 -0
  41. package/themes/classic/deepcase/classic.lino +86 -0
  42. package/themes/classic/deepcase/dark.lino +87 -0
  43. package/themes/classic/deepcase/deepcase-0.1.lino +63 -0
  44. package/themes/classic/deepcase/handler-windows.lino +22 -0
  45. package/themes/classic/deepcase/landing.lino +60 -0
  46. package/themes/classic/deepcase/perception.lino +88 -0
  47. package/themes/classic/formal-ai/chat-bubbles.lino +40 -0
  48. package/themes/classic/formal-ai/chat-cards.lino +40 -0
  49. package/themes/classic/formal-ai/chat-compact.lino +40 -0
  50. package/themes/classic/formal-ai/composer.lino +132 -0
  51. package/themes/classic/formal-ai/fa-contrast.lino +79 -0
  52. package/themes/classic/formal-ai/fa-flat.lino +79 -0
  53. package/themes/classic/formal-ai/fa-glass.lino +79 -0
  54. package/themes/classic/formal-ai/fa-material.lino +79 -0
  55. package/themes/classic/immortality/arwes.lino +59 -0
  56. package/themes/classic/immortality/palettes.lino +968 -0
  57. package/themes/classic/immortality/poseidon.lino +59 -0
  58. package/themes/classic/immortality/quiet.lino +59 -0
  59. package/themes/classic/konard/futuristic.lino +89 -0
  60. package/themes/classic/konard/glass.lino +89 -0
  61. package/themes/classic/konard/liquid.lino +89 -0
  62. package/themes/classic/meta-sovereign/chat-signal.lino +68 -0
  63. package/themes/classic/meta-sovereign/chat-t3.lino +68 -0
  64. package/themes/classic/meta-sovereign/chat-telegram.lino +74 -0
  65. package/themes/classic/meta-sovereign/chat-whatsapp.lino +68 -0
  66. package/themes/fluent2/LICENSE.txt +15 -0
  67. package/themes/fluent2/brand-aliases.lino +101 -0
  68. package/themes/fluent2/colors-dark.lino +1124 -0
  69. package/themes/fluent2/colors-high-contrast.lino +1109 -0
  70. package/themes/fluent2/colors.lino +1489 -0
  71. package/themes/fluent2/fluent-mapping.lino +120 -0
  72. package/themes/fluent2/motion-dark.lino +62 -0
  73. package/themes/fluent2/motion-high-contrast.lino +62 -0
  74. package/themes/fluent2/motion.lino +70 -0
  75. package/themes/fluent2/shadow-dark.lino +50 -0
  76. package/themes/fluent2/shadow-high-contrast.lino +50 -0
  77. package/themes/fluent2/shadow.lino +49 -0
  78. package/themes/fluent2/shape-dark.lino +47 -0
  79. package/themes/fluent2/shape-high-contrast.lino +47 -0
  80. package/themes/fluent2/shape.lino +46 -0
  81. package/themes/fluent2/spacing-dark.lino +68 -0
  82. package/themes/fluent2/spacing-high-contrast.lino +68 -0
  83. package/themes/fluent2/spacing.lino +67 -0
  84. package/themes/fluent2/styles.lino +511 -0
  85. package/themes/fluent2/templates.lino +60 -0
  86. package/themes/fluent2/theme.lino +31 -0
  87. package/themes/fluent2/type-dark.lino +83 -0
  88. package/themes/fluent2/type-high-contrast.lino +83 -0
  89. package/themes/fluent2/type.lino +82 -0
  90. package/themes/hig/colors.lino +54 -0
  91. package/themes/hig/materials.lino +7 -0
  92. package/themes/hig/motion.lino +13 -0
  93. package/themes/hig/shape.lino +5 -0
  94. package/themes/hig/spacing.lino +11 -0
  95. package/themes/hig/styles.lino +143 -0
  96. package/themes/hig/swiftui-mapping.lino +80 -0
  97. package/themes/hig/templates.lino +36 -0
  98. package/themes/hig/theme.lino +3 -0
  99. package/themes/hig/type.lino +26 -0
  100. package/themes/hig-ios/theme.lino +5 -0
  101. package/themes/hig-macos/theme.lino +5 -0
  102. package/themes/material3/colors.lino +320 -0
  103. package/themes/material3/elevation.lino +110 -0
  104. package/themes/material3/motion.lino +102 -0
  105. package/themes/material3/mui-mapping.lino +216 -0
  106. package/themes/material3/shape.lino +16 -0
  107. package/themes/material3/styles.lino +498 -0
  108. package/themes/material3/templates.lino +55 -0
  109. package/themes/material3/theme.lino +7 -0
  110. package/themes/material3/type.lino +336 -0
@@ -0,0 +1,328 @@
1
+ import { parseNested } from '@link-foundation/ui-core';
2
+ export { frameGeometry } from './frame-geometry.js';
3
+ import { corners, lines } from './frame-vocabulary.js';
4
+
5
+ export const FRAME_LEVELS = [
6
+ 'panel',
7
+ 'block',
8
+ 'control',
9
+ 'button',
10
+ 'field',
11
+ 'tab',
12
+ 'chip',
13
+ 'menu',
14
+ 'nav',
15
+ 'subnav',
16
+ 'table',
17
+ ];
18
+ export const FRAME_CORNERS = [
19
+ 'top-left',
20
+ 'top-right',
21
+ 'bottom-right',
22
+ 'bottom-left',
23
+ ];
24
+ export const FRAME_EDGES = ['top', 'right', 'bottom', 'left'];
25
+ export const FRAME_STATES = [
26
+ 'hover',
27
+ 'active',
28
+ 'selected',
29
+ 'focus',
30
+ 'disabled',
31
+ ];
32
+ const blank = () => ({ corners: {}, edges: {}, states: {} });
33
+ const atom = (link) => {
34
+ if (!link || link.values.length) {
35
+ throw new TypeError('Expected a frame atom');
36
+ }
37
+ return link.id;
38
+ };
39
+ const nonnegative = (value) => {
40
+ const n = Number(value);
41
+ if (!Number.isFinite(n) || n < 0) {
42
+ throw new RangeError('Frame dimensions must be nonnegative finite pixels');
43
+ }
44
+ return n;
45
+ };
46
+ export const FRAME_STYLES = ['solid', 'dashed', 'dotted', 'double'];
47
+ export const FRAME_MODES = ['frame', 'own', 'border'];
48
+ export const FRAME_LAYERS = ['above', 'below'];
49
+ const enums = {
50
+ style: FRAME_STYLES,
51
+ mode: FRAME_MODES,
52
+ layer: FRAME_LAYERS,
53
+ line: lines,
54
+ };
55
+ const levelKeys = [
56
+ 'style',
57
+ 'mode',
58
+ 'layer',
59
+ 'opacity',
60
+ 'stroke',
61
+ 'min-width',
62
+ 'max-width',
63
+ 'min-height',
64
+ 'max-height',
65
+ 'fitScale',
66
+ ];
67
+ const ranges = {
68
+ opacity: (n) => n <= 1,
69
+ fitScale: (n) => n <= 1,
70
+ scale: (n) => n >= 0.1 && n <= 1,
71
+ stroke: (n) => n <= 12,
72
+ 'min-width': (n) => n <= 1600,
73
+ 'max-width': (n) => n <= 1600,
74
+ 'min-height': (n) => n <= 1600,
75
+ 'max-height': (n) => n <= 1600,
76
+ };
77
+ function propertyValue(key, value) {
78
+ if (enums[key]) {
79
+ if (!enums[key].includes(value)) {
80
+ throw new TypeError(`Unknown frame ${key}: ${value}`);
81
+ }
82
+ return value;
83
+ }
84
+ if (key === 'color') {
85
+ return value;
86
+ }
87
+ if (
88
+ value === 'auto' &&
89
+ ['size', 'width', 'height', 'arm', 'stroke'].includes(key)
90
+ ) {
91
+ return value;
92
+ }
93
+ const n = nonnegative(value);
94
+ if (ranges[key] && !ranges[key](n)) {
95
+ throw new RangeError(`Invalid frame ${key}: ${value}`);
96
+ }
97
+ return n;
98
+ }
99
+ function readProperties(nodes, allowed) {
100
+ const result = {};
101
+ for (const node of nodes) {
102
+ const key = atom(node.values[0]);
103
+ if (
104
+ !allowed.includes(key) ||
105
+ node.values.length !== 2 ||
106
+ Object.hasOwn(result, key)
107
+ ) {
108
+ throw new TypeError(`Unknown or duplicate frame property: ${key}`);
109
+ }
110
+ result[key] = propertyValue(key, atom(node.values[1]));
111
+ }
112
+ return result;
113
+ }
114
+ function readPart(result, kind, name, shape, properties) {
115
+ const isCorner = kind === 'corner';
116
+ const names = isCorner ? FRAME_CORNERS : FRAME_EDGES;
117
+ const id = atom(name);
118
+ const value = atom(shape);
119
+ if (!names.includes(id) || !(isCorner ? corners : lines).includes(value)) {
120
+ throw new TypeError(`Unknown frame ${kind} name or shape: ${id} ${value}`);
121
+ }
122
+ const collection = isCorner ? result.corners : result.edges;
123
+ if (collection[id]) {
124
+ throw new TypeError(`Duplicate frame ${kind}: ${id}`);
125
+ }
126
+ collection[id] = {
127
+ [isCorner ? 'shape' : 'line']: value,
128
+ ...readProperties(
129
+ properties,
130
+ isCorner
131
+ ? ['size', 'width', 'height', 'stroke', 'color', 'line', 'arm']
132
+ : ['stroke', 'color', 'gap', 'style']
133
+ ),
134
+ };
135
+ if (
136
+ isCorner &&
137
+ typeof collection[id].stroke === 'number' &&
138
+ !Number.isInteger(collection[id].stroke * 2)
139
+ ) {
140
+ throw new RangeError('Corner strokes use half-pixel steps');
141
+ }
142
+ }
143
+ function readLevel(nodes, state = false) {
144
+ const result = blank();
145
+ for (const node of nodes) {
146
+ const [head, name, shape, ...properties] = node.values;
147
+ const kind = atom(head);
148
+ if (
149
+ kind === 'extends' &&
150
+ !state &&
151
+ node.values.length >= 2 &&
152
+ !result.extends
153
+ ) {
154
+ result.extends = atom(name);
155
+ Object.assign(result, readProperties(node.values.slice(2), ['scale']));
156
+ } else if (kind === 'state' && !state) {
157
+ const id = atom(name);
158
+ if (!FRAME_STATES.includes(id) || result.states[id]) {
159
+ throw new TypeError(`Unknown or duplicate frame state: ${id}`);
160
+ }
161
+ result.states[id] = readLevel(node.values.slice(2), true);
162
+ } else if (levelKeys.includes(kind) && !Object.hasOwn(result, kind)) {
163
+ Object.assign(result, readProperties([node], levelKeys));
164
+ } else if (kind === 'corner' || kind === 'edge') {
165
+ readPart(result, kind, name, shape, properties);
166
+ } else {
167
+ throw new TypeError(`Unknown frame declaration: ${kind}`);
168
+ }
169
+ }
170
+ return result;
171
+ }
172
+
173
+ /** Public frame vocabulary: docs/spec/frames.md. Parsed by links-notation. */
174
+ export function readFrames(text) {
175
+ const roots = parseNested(text);
176
+ if (roots.length !== 1 || atom(roots[0].values[0]) !== 'frames') {
177
+ throw new TypeError('Expected one frames root');
178
+ }
179
+ const result = new Map();
180
+ for (const level of roots[0].values.slice(1)) {
181
+ const name = level.values.length ? atom(level.values[0]) : atom(level);
182
+ if (!FRAME_LEVELS.includes(name)) {
183
+ throw new TypeError(`Unknown frame level: ${name}`);
184
+ }
185
+ if (result.has(name)) {
186
+ throw new TypeError(`Duplicate frame level: ${name}`);
187
+ }
188
+ const definition = readLevel(level.values.slice(1));
189
+ if (definition.extends && definition.scale === undefined) {
190
+ definition.scale = { block: 0.6, control: 0.35 }[name] ?? 1;
191
+ }
192
+ result.set(name, definition);
193
+ }
194
+ return result;
195
+ }
196
+ const merge = (target, patch) => {
197
+ for (const key of levelKeys) {
198
+ if (patch[key] !== undefined) {
199
+ target[key] = patch[key];
200
+ }
201
+ }
202
+ for (const part of ['corners', 'edges']) {
203
+ for (const [name, properties] of Object.entries(patch[part])) {
204
+ const explicit = Object.fromEntries(
205
+ Object.entries(properties).filter(
206
+ ([key, value]) => value !== 'auto' || key === 'stroke'
207
+ )
208
+ );
209
+ target[part][name] = { ...target[part][name], ...explicit };
210
+ }
211
+ }
212
+ };
213
+ const dimensions = ['size', 'width', 'height', 'arm'];
214
+ function scaleCorners(cs, scale) {
215
+ for (const c of Object.values(cs)) {
216
+ for (const key of dimensions) {
217
+ if (typeof c[key] === 'number') {
218
+ c[key] *= scale;
219
+ }
220
+ }
221
+ }
222
+ }
223
+ function completeFrame(result) {
224
+ for (const edge of Object.values(result.edges)) {
225
+ if (edge.stroke === 'auto') {
226
+ edge.stroke = result.stroke === 'auto' ? 1 : result.stroke;
227
+ }
228
+ if (edge.style === 'auto') {
229
+ edge.style = result.style;
230
+ }
231
+ }
232
+ FRAME_CORNERS.forEach((id, i) => {
233
+ if (result.corners[id].stroke === 'auto') {
234
+ result.corners[id].stroke = result.edges[FRAME_EDGES[i]].stroke;
235
+ }
236
+ });
237
+ }
238
+ function mergeStates(result, chain, states) {
239
+ for (const state of states) {
240
+ chain.forEach((entry, index) => {
241
+ if (!entry.states[state]) {
242
+ return;
243
+ }
244
+ const statePatch = entry.states[state];
245
+ const patch = {
246
+ ...statePatch,
247
+ corners: Object.fromEntries(
248
+ Object.entries(statePatch.corners).map(([id, c]) => [id, { ...c }])
249
+ ),
250
+ };
251
+ const scale = chain
252
+ .slice(index + 1)
253
+ .reduce((value, child) => value * (child.scale ?? 1), 1);
254
+ scaleCorners(patch.corners, scale);
255
+ merge(result, patch);
256
+ });
257
+ }
258
+ }
259
+ /** Explicit inheritance only; ordered states override their inherited state. */
260
+ export function resolveFrame(frames, level, states = []) {
261
+ for (const state of states) {
262
+ if (!FRAME_STATES.includes(state)) {
263
+ throw new TypeError(`Unknown frame state: ${state}`);
264
+ }
265
+ }
266
+ const chain = [];
267
+ const seen = new Set();
268
+ let name = level;
269
+ while (name) {
270
+ if (seen.has(name)) {
271
+ throw new TypeError('Frame inheritance cycle');
272
+ }
273
+ seen.add(name);
274
+ const entry = frames.get(name);
275
+ if (!entry) {
276
+ throw new TypeError(`Unknown frame level: ${name}`);
277
+ }
278
+ chain.unshift(entry);
279
+ name = entry.extends;
280
+ }
281
+ const result = {
282
+ mode: 'own',
283
+ layer: 'above',
284
+ opacity: 1,
285
+ style: 'solid',
286
+ stroke: 1,
287
+ 'min-width': 0,
288
+ 'max-width': 0,
289
+ 'min-height': 0,
290
+ 'max-height': 0,
291
+ fitScale: 0.5,
292
+ corners: Object.fromEntries(
293
+ FRAME_CORNERS.map((id) => [
294
+ id,
295
+ {
296
+ shape: 'square',
297
+ size: 0,
298
+ stroke: 'auto',
299
+ color: 'currentColor',
300
+ line: 'accent',
301
+ arm: 8,
302
+ },
303
+ ])
304
+ ),
305
+ edges: Object.fromEntries(
306
+ FRAME_EDGES.map((id) => [
307
+ id,
308
+ {
309
+ line: 'line',
310
+ stroke: 'auto',
311
+ color: 'currentColor',
312
+ gap: 8,
313
+ style: 'auto',
314
+ },
315
+ ])
316
+ ),
317
+ };
318
+ for (const entry of chain) {
319
+ scaleCorners(result.corners, entry.scale ?? 1);
320
+ merge(
321
+ result,
322
+ entry.mode === 'frame' ? { ...entry, corners: {}, edges: {} } : entry
323
+ );
324
+ }
325
+ mergeStates(result, chain, states);
326
+ completeFrame(result);
327
+ return result;
328
+ }
@@ -0,0 +1,10 @@
1
+ export const corners = [
2
+ 'square',
3
+ 'cut',
4
+ 'tall',
5
+ 'wide',
6
+ 'round',
7
+ 'scoop',
8
+ 'notch',
9
+ ];
10
+ export const lines = ['none', 'gap', 'line', 'accent', 'bracket'];
@@ -0,0 +1,143 @@
1
+ export type Corner =
2
+ | 'square'
3
+ | 'cut'
4
+ | 'tall'
5
+ | 'wide'
6
+ | 'round'
7
+ | 'scoop'
8
+ | 'notch';
9
+ export type Line = 'none' | 'gap' | 'line' | 'accent' | 'bracket';
10
+ export const corners: Corner[];
11
+ export const lines: Line[];
12
+ /** Returns style-rule LiNo. Size is 0–48 percent, or pixels for round corners. */
13
+ export function frameStyle(options?: {
14
+ corner?: Corner;
15
+ line?: Line;
16
+ size?: number;
17
+ }): string;
18
+
19
+ export type FrameLevel =
20
+ | 'panel'
21
+ | 'block'
22
+ | 'control'
23
+ | 'button'
24
+ | 'field'
25
+ | 'tab'
26
+ | 'chip'
27
+ | 'menu'
28
+ | 'nav'
29
+ | 'subnav'
30
+ | 'table';
31
+ export type FrameCornerName =
32
+ | 'top-left'
33
+ | 'top-right'
34
+ | 'bottom-right'
35
+ | 'bottom-left';
36
+ export type FrameEdgeName = 'top' | 'right' | 'bottom' | 'left';
37
+ export type FrameState = 'hover' | 'active' | 'selected' | 'focus' | 'disabled';
38
+ export interface FrameCorner {
39
+ shape: Corner;
40
+ size: number | 'auto';
41
+ width?: number | 'auto';
42
+ height?: number | 'auto';
43
+ line?: Line;
44
+ arm?: number | 'auto';
45
+ stroke: number | 'auto';
46
+ color: string;
47
+ }
48
+ export type FrameEdgeStyle = 'solid' | 'dashed' | 'dotted' | 'double';
49
+ export interface FrameEdge {
50
+ line: Line;
51
+ style?: FrameEdgeStyle;
52
+ stroke: number | 'auto';
53
+ color: string;
54
+ gap: number;
55
+ }
56
+ export interface FrameOptions {
57
+ mode?: 'frame' | 'own' | 'border';
58
+ layer?: 'above' | 'below';
59
+ opacity?: number;
60
+ style?: FrameEdgeStyle;
61
+ stroke?: number | 'auto';
62
+ 'min-width'?: number;
63
+ 'max-width'?: number;
64
+ 'min-height'?: number;
65
+ 'max-height'?: number;
66
+ fitScale?: number;
67
+ }
68
+ export interface ResolvedFrameCorner extends Omit<
69
+ FrameCorner,
70
+ 'size' | 'width' | 'height' | 'arm' | 'stroke' | 'line'
71
+ > {
72
+ size: number;
73
+ width?: number;
74
+ height?: number;
75
+ arm: number;
76
+ stroke: number;
77
+ line: Line;
78
+ }
79
+ export interface ResolvedFrameEdge extends Omit<FrameEdge, 'stroke' | 'style'> {
80
+ stroke: number;
81
+ style: FrameEdgeStyle;
82
+ }
83
+ export interface ResolvedFrame extends FrameOptions {
84
+ corners: Record<FrameCornerName, ResolvedFrameCorner>;
85
+ edges: Record<FrameEdgeName, ResolvedFrameEdge>;
86
+ }
87
+ export interface FrameDefinition extends FrameOptions {
88
+ extends?: FrameLevel;
89
+ scale?: number;
90
+ corners: Partial<Record<FrameCornerName, Partial<FrameCorner>>>;
91
+ edges: Partial<Record<FrameEdgeName, Partial<FrameEdge>>>;
92
+ states: Partial<Record<FrameState, FrameDefinition>>;
93
+ }
94
+ export const FRAME_LEVELS: FrameLevel[];
95
+ export const FRAME_CORNERS: FrameCornerName[];
96
+ export const FRAME_EDGES: FrameEdgeName[];
97
+ export function readFrames(text: string): Map<FrameLevel, FrameDefinition>;
98
+ export function resolveFrame(
99
+ frames: Map<FrameLevel, FrameDefinition>,
100
+ level: FrameLevel,
101
+ states?: FrameState[]
102
+ ): ResolvedFrame;
103
+ export function frameGeometry(
104
+ frame: ResolvedFrame,
105
+ width: number,
106
+ height: number
107
+ ): {
108
+ path: string;
109
+ clipPath: string;
110
+ corners: Record<
111
+ FrameCornerName,
112
+ ResolvedFrameCorner & { width: number; height: number }
113
+ >;
114
+ borderSvg: string;
115
+ };
116
+
117
+ export interface FramesCssOptions {
118
+ levels?: Partial<Record<FrameLevel, string[]>>;
119
+ prefix?: string;
120
+ scope?: string;
121
+ boundaryAttribute?: string;
122
+ selected?: string[];
123
+ }
124
+ export interface FrameControl {
125
+ level: FrameLevel;
126
+ property?: string;
127
+ syntax?: string;
128
+ inherits?: boolean;
129
+ attribute?: string;
130
+ choices?: string[];
131
+ }
132
+ export function framesCss(
133
+ frames: Map<FrameLevel, FrameDefinition>,
134
+ options?: FramesCssOptions
135
+ ): {
136
+ properties: string;
137
+ base: string;
138
+ levels: Partial<Record<FrameLevel, string>>;
139
+ fit: string;
140
+ controls: FrameControl[];
141
+ };
142
+ /** Insert first in a transparent, positioned frame host; content follows. */
143
+ export function frameLayers(): string;
@@ -0,0 +1,77 @@
1
+ import { formatLinks } from '@link-foundation/ui-core';
2
+
3
+ import { corners, lines } from './frame-vocabulary.js';
4
+ export { corners, lines };
5
+
6
+ /** A single clipped surface paints corners and edges together: no opaque overlays.
7
+ * @param {{corner?: string, line?: string, size?: number}} options
8
+ * @returns {string} style-rule LiNo, accepted by ui-style
9
+ */
10
+ export function frameStyle({
11
+ corner = 'square',
12
+ line = 'line',
13
+ size = 12,
14
+ } = {}) {
15
+ if (!corners.includes(corner) || !lines.includes(line)) {
16
+ throw new RangeError('Unknown frame corner or line');
17
+ }
18
+ if (!Number.isFinite(size) || size < 0 || size > 48) {
19
+ throw new RangeError('Frame size must be a number from 0 to 48 pixels');
20
+ }
21
+ // Percentages keep small panels valid; size is a bounded corner proportion.
22
+ const s = size;
23
+ const polygons = {
24
+ square: 'inset(0px)',
25
+ cut: `polygon(${s}% 0%, ${100 - s}% 0%, 100% ${s}%, 100% ${100 - s}%, ${100 - s}% 100%, ${s}% 100%, 0% ${100 - s}%, 0% ${s}%)`,
26
+ tall: `polygon(${s / 2}% 0%, ${100 - s / 2}% 0%, 100% ${s}%, 100% ${100 - s}%, ${100 - s / 2}% 100%, ${s / 2}% 100%, 0% ${100 - s}%, 0% ${s}%)`,
27
+ wide: `polygon(${s}% 0%, ${100 - s}% 0%, 100% ${s / 2}%, 100% ${100 - s / 2}%, ${100 - s}% 100%, ${s}% 100%, 0% ${100 - s / 2}%, 0% ${s / 2}%)`,
28
+ round: `inset(0px round ${s}px)`,
29
+ scoop: `polygon(${s}% 0%, ${100 - s}% 0%, ${100 - s}% ${s}%, 100% ${s}%, 100% ${100 - s}%, ${100 - s}% ${100 - s}%, ${100 - s}% 100%, ${s}% 100%, ${s}% ${100 - s}%, 0% ${100 - s}%, 0% ${s}%, ${s}% ${s}%)`,
30
+ notch: `polygon(0% 0%, ${s}% 0%, ${s}% ${s / 2}%, ${s * 2}% ${s / 2}%, ${s * 2}% 0%, 100% 0%, 100% 100%, 0% 100%)`,
31
+ };
32
+ return formatLinks([
33
+ {
34
+ id: `frame-${corner}-${line}`,
35
+ values: [
36
+ 'style',
37
+ ['selector', ['type', 'panel']],
38
+ ['clip-path', polygons[corner]],
39
+ ['radius', '0px'],
40
+ ['background', ['token', 'color.surface']],
41
+ ['border-color', ['token', 'color.primary']],
42
+ [
43
+ 'border-style',
44
+ {
45
+ none: 'none',
46
+ gap: 'dashed',
47
+ line: 'solid',
48
+ accent: 'solid',
49
+ bracket: 'double',
50
+ }[line],
51
+ ],
52
+ [
53
+ 'border-width',
54
+ line === 'none'
55
+ ? '0px'
56
+ : line === 'accent'
57
+ ? '3px'
58
+ : line === 'bracket'
59
+ ? '4px'
60
+ : '1px',
61
+ ],
62
+ ['opacity', ['token', 'surface.opacity']],
63
+ ],
64
+ },
65
+ ]);
66
+ }
67
+
68
+ export {
69
+ FRAME_LEVELS,
70
+ FRAME_CORNERS,
71
+ FRAME_EDGES,
72
+ readFrames,
73
+ resolveFrame,
74
+ frameGeometry,
75
+ } from './frame-schema.js';
76
+
77
+ export { framesCss, frameLayers } from './frame-css.js';
@@ -0,0 +1,94 @@
1
+ /** Screen-only, high-priority suppression without mutating the original declarations. */
2
+ export function observeMaterialVisibility(
3
+ root,
4
+ selector,
5
+ { margin = '200px 0px', onVisibility } = {}
6
+ ) {
7
+ const document = root.ownerDocument ?? root;
8
+ const view = document.defaultView;
9
+ if (!view?.IntersectionObserver) {
10
+ return { dispose() {} };
11
+ }
12
+ let suffix = 0;
13
+ while (document.querySelector(`style[data-material-budget="${suffix}"]`)) {
14
+ suffix++;
15
+ }
16
+ const marker = `data-ui-material-hidden-${suffix}`;
17
+ const style = document.createElement('style');
18
+ style.setAttribute('data-material-budget', String(suffix));
19
+ // An inline important rule also applies in print, so use an author stylesheet.
20
+ // Repeated IDs make this override every framework selector, including hover.
21
+ const priority = ':is(#ui-budget#ui-budget#ui-budget, *)';
22
+ style.textContent = `@media screen { [${marker}]${priority} { backdrop-filter: none !important; -webkit-backdrop-filter: none !important; } }`;
23
+ (document.head ?? document.documentElement).append(style);
24
+ const tracked = new Map();
25
+ const observer = new view.IntersectionObserver(
26
+ (entries) => {
27
+ for (const entry of entries) {
28
+ if (!tracked.has(entry.target)) {
29
+ continue;
30
+ }
31
+ entry.target.toggleAttribute(marker, !entry.isIntersecting);
32
+ onVisibility?.(entry.target, entry.isIntersecting);
33
+ }
34
+ },
35
+ { rootMargin: typeof margin === 'number' ? `${margin}px 0px` : margin }
36
+ );
37
+ const remove = (element) => {
38
+ if (!tracked.has(element)) {
39
+ return;
40
+ }
41
+ observer.unobserve(element);
42
+ element.removeAttribute(marker);
43
+ tracked.delete(element);
44
+ };
45
+ const scan = (node, add) => {
46
+ if (node.nodeType !== 1 && node !== root) {
47
+ return;
48
+ }
49
+ const visit = (element) => {
50
+ if (!add) {
51
+ remove(element);
52
+ return;
53
+ }
54
+ if (tracked.has(element)) {
55
+ return;
56
+ }
57
+ tracked.set(element, true);
58
+ element.setAttribute(marker, '');
59
+ observer.observe(element);
60
+ };
61
+ // Visible nodes have no suppression marker; release them even if their
62
+ // selector attributes changed before removal.
63
+ const query = add ? selector : '*';
64
+ if (node.matches?.(query)) {
65
+ visit(node);
66
+ }
67
+ node.querySelectorAll(query).forEach(visit);
68
+ };
69
+ scan(root, true);
70
+ const mutations = new view.MutationObserver((records) => {
71
+ for (const record of records) {
72
+ for (const node of record.removedNodes) {
73
+ if (!root.contains(node)) {
74
+ scan(node, false);
75
+ }
76
+ }
77
+ for (const node of record.addedNodes) {
78
+ scan(node, true);
79
+ }
80
+ }
81
+ });
82
+ mutations.observe(root, { childList: true, subtree: true });
83
+ return {
84
+ dispose() {
85
+ mutations.disconnect();
86
+ observer.disconnect();
87
+ for (const element of tracked.keys()) {
88
+ element.removeAttribute(marker);
89
+ }
90
+ tracked.clear();
91
+ style.remove();
92
+ },
93
+ };
94
+ }