@design.estate/dees-domtools 2.4.0 → 2.5.1

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.
@@ -3,7 +3,7 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: '@design.estate/dees-domtools',
6
- version: '2.4.0',
6
+ version: '2.5.1',
7
7
  description: 'A package providing tools to simplify complex CSS structures and web development tasks, featuring TypeScript support and integration with various web technologies.'
8
8
  };
9
9
  //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSw4QkFBOEI7SUFDcEMsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLHFLQUFxSztDQUNuTCxDQUFBIn0=
@@ -11,8 +11,8 @@ export interface ICssForConstraints {
11
11
  }
12
12
  export declare const cssForViewport: (cssArg: CSSResult, condition: string) => CSSResult;
13
13
  export declare const cssForContainer: (cssArg: CSSResult, condition: string, containerName: string) => CSSResult;
14
- export declare const cssForCustom: (constraints: ICssForConstraints) => (cssArg: CSSResult) => CSSResult;
15
- export declare const cssForCustomContainer: (constraints: ICssForConstraints, containerName: string) => (cssArg: CSSResult) => CSSResult;
14
+ export declare const cssForConstraint: (constraints: ICssForConstraints) => (cssArg: CSSResult) => CSSResult;
15
+ export declare const cssForConstraintContainer: (constraints: ICssForConstraints, containerName: string) => (cssArg: CSSResult) => CSSResult;
16
16
  export declare const containerContextStyles: (containerName: string) => CSSResult;
17
17
  export declare const cssForDesktop: (cssArg: CSSResult) => CSSResult;
18
18
  export declare const cssForNotebook: (cssArg: CSSResult) => CSSResult;
@@ -37,10 +37,10 @@ export const cssForContainer = (cssArg, condition, containerName) => {
37
37
  `);
38
38
  };
39
39
  // ---------------------------------------------------------------------------
40
- // Custom constraints (curried)
40
+ // Constraint-based (curried)
41
41
  // ---------------------------------------------------------------------------
42
- export const cssForCustom = (constraints) => (cssArg) => cssForViewport(cssArg, buildCondition(constraints));
43
- export const cssForCustomContainer = (constraints, containerName) => (cssArg) => cssForContainer(cssArg, buildCondition(constraints), containerName);
42
+ export const cssForConstraint = (constraints) => (cssArg) => cssForViewport(cssArg, buildCondition(constraints));
43
+ export const cssForConstraintContainer = (constraints, containerName) => (cssArg) => cssForContainer(cssArg, buildCondition(constraints), containerName);
44
44
  // ---------------------------------------------------------------------------
45
45
  // Container context style factory — used by @containerResponsive()
46
46
  // ---------------------------------------------------------------------------
@@ -68,4 +68,4 @@ export const cssForPhablet = (cssArg) => {
68
68
  export const cssForPhone = (cssArg) => {
69
69
  return cssForViewport(cssArg, `(max-width: ${phone}px)`);
70
70
  };
71
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG9tdG9vbHMuY3NzLmJyZWFrcG9pbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvZG9tdG9vbHMuY3NzLmJyZWFrcG9pbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUUxRCxPQUFPLEVBQUUsR0FBRyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFaEQsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQztBQUM1QixNQUFNLENBQUMsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDO0FBQzdCLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUM7QUFDM0IsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLEdBQUcsQ0FBQztBQUMzQixNQUFNLENBQUMsTUFBTSxLQUFLLEdBQUcsR0FBRyxDQUFDO0FBYXpCLE1BQU0sY0FBYyxHQUFHLENBQUMsV0FBK0IsRUFBVSxFQUFFO0lBQ2pFLE1BQU0sS0FBSyxHQUFhLEVBQUUsQ0FBQztJQUMzQixJQUFJLFdBQVcsQ0FBQyxRQUFRO1FBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxlQUFlLFdBQVcsQ0FBQyxRQUFRLEtBQUssQ0FBQyxDQUFDO0lBQy9FLElBQUksV0FBVyxDQUFDLFFBQVE7UUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLGVBQWUsV0FBVyxDQUFDLFFBQVEsS0FBSyxDQUFDLENBQUM7SUFDL0UsT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBQzdCLENBQUMsQ0FBQztBQUVGLDhFQUE4RTtBQUM5RSx1REFBdUQ7QUFDdkQsOEVBQThFO0FBRTlFLE1BQU0sQ0FBQyxNQUFNLGNBQWMsR0FBRyxDQUFDLE1BQWlCLEVBQUUsU0FBaUIsRUFBRSxFQUFFO0lBQ3JFLE9BQU8sU0FBUyxDQUFDO2tDQUNlLFNBQVM7UUFDbkMsTUFBTSxDQUFDLE9BQU87O2FBRVQsU0FBUztRQUNkLE1BQU0sQ0FBQyxPQUFPOztHQUVuQixDQUFDLENBQUM7QUFDTCxDQUFDLENBQUM7QUFFRiw4RUFBOEU7QUFDOUUsMENBQTBDO0FBQzFDLDhFQUE4RTtBQUU5RSxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsQ0FBQyxNQUFpQixFQUFFLFNBQWlCLEVBQUUsYUFBcUIsRUFBRSxFQUFFO0lBQzdGLE9BQU8sU0FBUyxDQUFDO2lCQUNGLGFBQWEsSUFBSSxTQUFTO1FBQ25DLE1BQU0sQ0FBQyxPQUFPOztHQUVuQixDQUFDLENBQUM7QUFDTCxDQUFDLENBQUM7QUFFRiw4RUFBOEU7QUFDOUUsK0JBQStCO0FBQy9CLDhFQUE4RTtBQUU5RSxNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsQ0FBQyxXQUErQixFQUFFLEVBQUUsQ0FDOUQsQ0FBQyxNQUFpQixFQUFFLEVBQUUsQ0FBQyxjQUFjLENBQUMsTUFBTSxFQUFFLGNBQWMsQ0FBQyxXQUFXLENBQUMsQ0FBQyxDQUFDO0FBRTdFLE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLENBQUMsV0FBK0IsRUFBRSxhQUFxQixFQUFFLEVBQUUsQ0FDOUYsQ0FBQyxNQUFpQixFQUFFLEVBQUUsQ0FBQyxlQUFlLENBQUMsTUFBTSxFQUFFLGNBQWMsQ0FBQyxXQUFXLENBQUMsRUFBRSxhQUFhLENBQUMsQ0FBQztBQUU3Riw4RUFBOEU7QUFDOUUsbUVBQW1FO0FBQ25FLDhFQUE4RTtBQUU5RSxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyxDQUFDLGFBQXFCLEVBQUUsRUFBRSxDQUFDLEdBQUcsQ0FBQTs7O3NCQUc5QyxTQUFTLENBQUMsYUFBYSxDQUFDOztDQUU3QyxDQUFDO0FBRUYsOEVBQThFO0FBQzlFLHlFQUF5RTtBQUN6RSw4RUFBOEU7QUFFOUUsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLENBQUMsTUFBaUIsRUFBRSxFQUFFO0lBQ2pELE9BQU8sY0FBYyxDQUFDLE1BQU0sRUFBRSxlQUFlLE9BQU8sS0FBSyxDQUFDLENBQUM7QUFDN0QsQ0FBQyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLENBQUMsTUFBaUIsRUFBRSxFQUFFO0lBQ2xELE9BQU8sY0FBYyxDQUFDLE1BQU0sRUFBRSxlQUFlLFFBQVEsS0FBSyxDQUFDLENBQUM7QUFDOUQsQ0FBQyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0sWUFBWSxHQUFHLENBQUMsTUFBaUIsRUFBRSxFQUFFO0lBQ2hELE9BQU8sY0FBYyxDQUFDLE1BQU0sRUFBRSxlQUFlLE1BQU0sS0FBSyxDQUFDLENBQUM7QUFDNUQsQ0FBQyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0sYUFBYSxHQUFHLENBQUMsTUFBaUIsRUFBRSxFQUFFO0lBQ2pELE9BQU8sY0FBYyxDQUFDLE1BQU0sRUFBRSxlQUFlLE9BQU8sS0FBSyxDQUFDLENBQUM7QUFDN0QsQ0FBQyxDQUFDO0FBRUYsTUFBTSxDQUFDLE1BQU0sV0FBVyxHQUFHLENBQUMsTUFBaUIsRUFBRSxFQUFFO0lBQy9DLE9BQU8sY0FBYyxDQUFDLE1BQU0sRUFBRSxlQUFlLEtBQUssS0FBSyxDQUFDLENBQUM7QUFDM0QsQ0FBQyxDQUFDIn0=
71
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZG9tdG9vbHMuY3NzLmJyZWFrcG9pbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvZG9tdG9vbHMuY3NzLmJyZWFrcG9pbnRzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxRQUFRLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUUxRCxPQUFPLEVBQUUsR0FBRyxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsTUFBTSxLQUFLLENBQUM7QUFFaEQsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLElBQUksQ0FBQztBQUM1QixNQUFNLENBQUMsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDO0FBQzdCLE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUM7QUFDM0IsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLEdBQUcsQ0FBQztBQUMzQixNQUFNLENBQUMsTUFBTSxLQUFLLEdBQUcsR0FBRyxDQUFDO0FBYXpCLE1BQU0sY0FBYyxHQUFHLENBQUMsV0FBK0IsRUFBVSxFQUFFO0lBQ2pFLE1BQU0sS0FBSyxHQUFhLEVBQUUsQ0FBQztJQUMzQixJQUFJLFdBQVcsQ0FBQyxRQUFRO1FBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxlQUFlLFdBQVcsQ0FBQyxRQUFRLEtBQUssQ0FBQyxDQUFDO0lBQy9FLElBQUksV0FBVyxDQUFDLFFBQVE7UUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLGVBQWUsV0FBVyxDQUFDLFFBQVEsS0FBSyxDQUFDLENBQUM7SUFDL0UsT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO0FBQzdCLENBQUMsQ0FBQztBQUVGLDhFQUE4RTtBQUM5RSx1REFBdUQ7QUFDdkQsOEVBQThFO0FBRTlFLE1BQU0sQ0FBQyxNQUFNLGNBQWMsR0FBRyxDQUFDLE1BQWlCLEVBQUUsU0FBaUIsRUFBRSxFQUFFO0lBQ3JFLE9BQU8sU0FBUyxDQUFDO2tDQUNlLFNBQVM7UUFDbkMsTUFBTSxDQUFDLE9BQU87O2FBRVQsU0FBUztRQUNkLE1BQU0sQ0FBQyxPQUFPOztHQUVuQixDQUFDLENBQUM7QUFDTCxDQUFDLENBQUM7QUFFRiw4RUFBOEU7QUFDOUUsMENBQTBDO0FBQzFDLDhFQUE4RTtBQUU5RSxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsQ0FBQyxNQUFpQixFQUFFLFNBQWlCLEVBQUUsYUFBcUIsRUFBRSxFQUFFO0lBQzdGLE9BQU8sU0FBUyxDQUFDO2lCQUNGLGFBQWEsSUFBSSxTQUFTO1FBQ25DLE1BQU0sQ0FBQyxPQUFPOztHQUVuQixDQUFDLENBQUM7QUFDTCxDQUFDLENBQUM7QUFFRiw4RUFBOEU7QUFDOUUsNkJBQTZCO0FBQzdCLDhFQUE4RTtBQUU5RSxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLFdBQStCLEVBQUUsRUFBRSxDQUNsRSxDQUFDLE1BQWlCLEVBQUUsRUFBRSxDQUFDLGNBQWMsQ0FBQyxNQUFNLEVBQUUsY0FBYyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUM7QUFFN0UsTUFBTSxDQUFDLE1BQU0seUJBQXlCLEdBQUcsQ0FBQyxXQUErQixFQUFFLGFBQXFCLEVBQUUsRUFBRSxDQUNsRyxDQUFDLE1BQWlCLEVBQUUsRUFBRSxDQUFDLGVBQWUsQ0FBQyxNQUFNLEVBQUUsY0FBYyxDQUFDLFdBQVcsQ0FBQyxFQUFFLGFBQWEsQ0FBQyxDQUFDO0FBRTdGLDhFQUE4RTtBQUM5RSxtRUFBbUU7QUFDbkUsOEVBQThFO0FBRTlFLE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLENBQUMsYUFBcUIsRUFBRSxFQUFFLENBQUMsR0FBRyxDQUFBOzs7c0JBRzlDLFNBQVMsQ0FBQyxhQUFhLENBQUM7O0NBRTdDLENBQUM7QUFFRiw4RUFBOEU7QUFDOUUseUVBQXlFO0FBQ3pFLDhFQUE4RTtBQUU5RSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsQ0FBQyxNQUFpQixFQUFFLEVBQUU7SUFDakQsT0FBTyxjQUFjLENBQUMsTUFBTSxFQUFFLGVBQWUsT0FBTyxLQUFLLENBQUMsQ0FBQztBQUM3RCxDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSxjQUFjLEdBQUcsQ0FBQyxNQUFpQixFQUFFLEVBQUU7SUFDbEQsT0FBTyxjQUFjLENBQUMsTUFBTSxFQUFFLGVBQWUsUUFBUSxLQUFLLENBQUMsQ0FBQztBQUM5RCxDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSxZQUFZLEdBQUcsQ0FBQyxNQUFpQixFQUFFLEVBQUU7SUFDaEQsT0FBTyxjQUFjLENBQUMsTUFBTSxFQUFFLGVBQWUsTUFBTSxLQUFLLENBQUMsQ0FBQztBQUM1RCxDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsQ0FBQyxNQUFpQixFQUFFLEVBQUU7SUFDakQsT0FBTyxjQUFjLENBQUMsTUFBTSxFQUFFLGVBQWUsT0FBTyxLQUFLLENBQUMsQ0FBQztBQUM3RCxDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSxXQUFXLEdBQUcsQ0FBQyxNQUFpQixFQUFFLEVBQUU7SUFDL0MsT0FBTyxjQUFjLENBQUMsTUFBTSxFQUFFLGVBQWUsS0FBSyxLQUFLLENBQUMsQ0FBQztBQUMzRCxDQUFDLENBQUMifQ==
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@design.estate/dees-domtools",
3
- "version": "2.4.0",
3
+ "version": "2.5.1",
4
4
  "private": false,
5
5
  "description": "A package providing tools to simplify complex CSS structures and web development tasks, featuring TypeScript support and integration with various web technologies.",
6
6
  "main": "dist_ts/index.js",
package/readme.md CHANGED
@@ -110,7 +110,7 @@ const myStyles = litCss`
110
110
  `;
111
111
  ```
112
112
 
113
- **Available breakpoint helpers:**
113
+ **Preset viewport helpers** (emit both `@media` and `@container wccToolsViewport`):
114
114
 
115
115
  - `cssForDesktop(css)` - Styles for 1600px and above
116
116
  - `cssForNotebook(css)` - Styles for 1240px and below
@@ -118,6 +118,37 @@ const myStyles = litCss`
118
118
  - `cssForPhablet(css)` - Styles for 600px and below
119
119
  - `cssForPhone(css)` - Styles for 400px and below
120
120
 
121
+ **Low-level helpers** for custom constraints and component-scoped containers:
122
+
123
+ ```typescript
124
+ import { breakpoints } from '@design.estate/dees-domtools';
125
+ import { css as litCss } from 'lit';
126
+
127
+ // Viewport-level with custom constraints (emits @media + @container wccToolsViewport)
128
+ breakpoints.cssForConstraint({ maxWidth: 800 })(litCss`.box { padding: 8px; }`)
129
+
130
+ // Component-level — targets a named container (no @media fallback)
131
+ breakpoints.cssForContainer(
132
+ litCss`.grid { columns: 1; }`,
133
+ '(max-width: 600px)',
134
+ 'my-component' // CSS container-name
135
+ )
136
+
137
+ // Component-level with custom constraints (curried)
138
+ breakpoints.cssForConstraintContainer({ maxWidth: 500 }, 'my-component')(litCss`
139
+ .grid { gap: 8px; }
140
+ `)
141
+
142
+ // Generate containment styles for :host (used by @containerResponsive decorator)
143
+ breakpoints.containerContextStyles('my-component')
144
+ // → :host { container-type: inline-size; container-name: my-component; }
145
+ ```
146
+
147
+ **Exported types:**
148
+
149
+ - `ICssForConstraints` — `{ maxWidth?: number; minWidth?: number }`
150
+ - `TViewport` — `'native' | 'desktop' | 'tablet' | 'phablet' | 'phone'`
151
+
121
152
  ### Theme Management
122
153
 
123
154
  Automatic theme detection with system preference support:
@@ -3,6 +3,6 @@
3
3
  */
4
4
  export const commitinfo = {
5
5
  name: '@design.estate/dees-domtools',
6
- version: '2.4.0',
6
+ version: '2.5.1',
7
7
  description: 'A package providing tools to simplify complex CSS structures and web development tasks, featuring TypeScript support and integration with various web technologies.'
8
8
  }
@@ -54,13 +54,13 @@ export const cssForContainer = (cssArg: CSSResult, condition: string, containerN
54
54
  };
55
55
 
56
56
  // ---------------------------------------------------------------------------
57
- // Custom constraints (curried)
57
+ // Constraint-based (curried)
58
58
  // ---------------------------------------------------------------------------
59
59
 
60
- export const cssForCustom = (constraints: ICssForConstraints) =>
60
+ export const cssForConstraint = (constraints: ICssForConstraints) =>
61
61
  (cssArg: CSSResult) => cssForViewport(cssArg, buildCondition(constraints));
62
62
 
63
- export const cssForCustomContainer = (constraints: ICssForConstraints, containerName: string) =>
63
+ export const cssForConstraintContainer = (constraints: ICssForConstraints, containerName: string) =>
64
64
  (cssArg: CSSResult) => cssForContainer(cssArg, buildCondition(constraints), containerName);
65
65
 
66
66
  // ---------------------------------------------------------------------------