@letsprogram/ng-oat-mcp 0.2.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 (30) hide show
  1. package/README.md +177 -0
  2. package/dist/data/components.d.ts +30 -0
  3. package/dist/data/components.d.ts.map +1 -0
  4. package/dist/data/components.js +647 -0
  5. package/dist/data/components.js.map +1 -0
  6. package/dist/data/recipes.d.ts +17 -0
  7. package/dist/data/recipes.d.ts.map +1 -0
  8. package/dist/data/recipes.js +245 -0
  9. package/dist/data/recipes.js.map +1 -0
  10. package/dist/data/setup.d.ts +13 -0
  11. package/dist/data/setup.d.ts.map +1 -0
  12. package/dist/data/setup.js +132 -0
  13. package/dist/data/setup.js.map +1 -0
  14. package/dist/data/theming.d.ts +14 -0
  15. package/dist/data/theming.d.ts.map +1 -0
  16. package/dist/data/theming.js +228 -0
  17. package/dist/data/theming.js.map +1 -0
  18. package/dist/data/tokens.d.ts +17 -0
  19. package/dist/data/tokens.d.ts.map +1 -0
  20. package/dist/data/tokens.js +93 -0
  21. package/dist/data/tokens.js.map +1 -0
  22. package/dist/data/utilities.d.ts +20 -0
  23. package/dist/data/utilities.d.ts.map +1 -0
  24. package/dist/data/utilities.js +557 -0
  25. package/dist/data/utilities.js.map +1 -0
  26. package/dist/index.d.ts +12 -0
  27. package/dist/index.d.ts.map +1 -0
  28. package/dist/index.js +502 -0
  29. package/dist/index.js.map +1 -0
  30. package/package.json +41 -0
package/dist/data/theming.js ADDED
@@ -0,0 +1,228 @@
1
+ /**
2
+ * ng-oat theming API documentation for MCP tool lookups.
3
+ */
4
+ export const THEMING_SECTIONS = [
5
+ {
6
+ topic: 'overview',
7
+ title: 'Theming Overview',
8
+ content: `ng-oat theming works at two levels:
9
+
10
+ 1. **CSS-only** — Override \`--oat-*\` custom properties in your stylesheet. No Angular code needed.
11
+ 2. **Angular DI** — Use \`provideNgOatTheme()\` for runtime token overrides via the \`NgOatThemeRef\` service.
12
+
13
+ Both approaches set the same CSS custom properties. The DI approach also sets the upstream Oat \`--*\` variables automatically.
14
+
15
+ Color tokens support the CSS \`light-dark()\` function for automatic dark/light mode switching.`,
16
+ },
17
+ {
18
+ topic: 'setup',
19
+ title: 'provideNgOatTheme()',
20
+ content: `Configure theme tokens at application bootstrap:
21
+
22
+ \`\`\`typescript
23
+ // app.config.ts
24
+ import { provideNgOatTheme } from '@letsprogram/ng-oat';
25
+
26
+ export const appConfig: ApplicationConfig = {
27
+ providers: [
28
+ provideNgOatTheme({
29
+ tokens: {
30
+ '--oat-primary': '#3ecf8e',
31
+ '--oat-background': 'light-dark(#f8f9fa, #171717)',
32
+ '--oat-foreground': 'light-dark(#1c1c1c, #ededed)',
33
+ '--oat-border': 'light-dark(#dfe3e6, #2e2e2e)',
34
+ },
35
+ scope: ':root', // default — applies to document.documentElement
36
+ }),
37
+ ],
38
+ };
39
+ \`\`\`
40
+
41
+ ### NgOatThemeConfig interface
42
+
43
+ \`\`\`typescript
44
+ interface NgOatThemeConfig {
45
+ /** Token overrides: record of --oat-* → CSS value */
46
+ tokens: OatTokens;
47
+ /** Where to apply tokens. Default: ':root' */
48
+ scope?: ':root' | HTMLElement | string;
49
+ }
50
+ \`\`\`
51
+
52
+ Each \`--oat-*\` token is also mirrored to its upstream Oat variable (e.g. \`--oat-primary\` → \`--primary\`).`,
53
+ },
54
+ {
55
+ topic: 'runtime',
56
+ title: 'NgOatThemeRef — Runtime Theme Manipulation',
57
+ content: `Inject \`NgOatThemeRef\` for runtime theme changes (provided automatically by \`provideNgOatTheme()\`):
58
+
59
+ \`\`\`typescript
60
+ import { inject } from '@angular/core';
61
+ import { NgOatThemeRef } from '@letsprogram/ng-oat';
62
+
63
+ const theme = inject(NgOatThemeRef);
64
+
65
+ // Apply new token overrides (merges with existing)
66
+ theme.setTokens({
67
+ '--oat-primary': '#6366f1',
68
+ '--oat-background': '#0a0a0a',
69
+ });
70
+
71
+ // Get currently applied tokens
72
+ const current = theme.getTokens();
73
+ // → { '--oat-primary': '#6366f1', '--primary': '#6366f1', ... }
74
+
75
+ // Remove all overrides (reverts to CSS defaults)
76
+ theme.resetTokens();
77
+
78
+ // Change scope element and re-apply
79
+ theme.setScope('#my-panel'); // CSS selector
80
+ theme.setScope(myElement); // HTMLElement ref
81
+ theme.setScope(':root'); // back to document root
82
+ \`\`\`
83
+
84
+ ### Methods
85
+
86
+ | Method | Signature | Description |
87
+ |--------|-----------|-------------|
88
+ | \`setTokens\` | \`(tokens: OatTokens) => void\` | Merge and apply token overrides to current scope |
89
+ | \`resetTokens\` | \`() => void\` | Remove all applied token overrides |
90
+ | \`getTokens\` | \`() => Record<string, string>\` | Get all currently applied tokens (includes --oat-* and upstream --* keys) |
91
+ | \`setScope\` | \`(scope: ':root' \\| HTMLElement \\| string) => void\` | Move tokens to a new scope element |`,
92
+ },
93
+ {
94
+ topic: 'light-dark',
95
+ title: 'Light/Dark Mode with light-dark()',
96
+ content: `Oat CSS uses the native CSS \`light-dark()\` function for dual-mode colors. The upstream theme sets:
97
+
98
+ \`\`\`css
99
+ :root {
100
+ color-scheme: light dark;
101
+ --background: light-dark(#fff, #09090b);
102
+ --primary: light-dark(#574747, #fafafa);
103
+ /* ... */
104
+ }
105
+ \`\`\`
106
+
107
+ ### How it works
108
+
109
+ 1. The browser reads the \`color-scheme\` property on \`<html>\`
110
+ 2. \`light-dark(lightVal, darkVal)\` resolves based on the active scheme
111
+ 3. \`NgOatThemeSelector\` (or manual JS) sets \`document.documentElement.style.colorScheme = 'dark'\`
112
+
113
+ ### Overriding with provideNgOatTheme
114
+
115
+ Pass \`light-dark()\` values in your tokens for dual-mode support:
116
+
117
+ \`\`\`typescript
118
+ provideNgOatTheme({
119
+ tokens: {
120
+ '--oat-background': 'light-dark(#f8f9fa, #171717)',
121
+ '--oat-foreground': 'light-dark(#1c1c1c, #ededed)',
122
+ '--oat-card': 'light-dark(#ffffff, #1c1c1c)',
123
+ '--oat-primary': '#3ecf8e', // same in both modes
124
+ '--oat-border': 'light-dark(#dfe3e6, #2e2e2e)',
125
+ },
126
+ })
127
+ \`\`\`
128
+
129
+ ### Initial color scheme
130
+
131
+ Set the initial scheme in \`index.html\` to prevent flash:
132
+
133
+ \`\`\`html
134
+ <html lang="en" style="color-scheme: dark">
135
+ \`\`\`
136
+
137
+ ### NgOatThemeSelector component
138
+
139
+ Add the theme toggle to your toolbar:
140
+
141
+ \`\`\`html
142
+ <ng-oat-theme-selector initialTheme="dark" />
143
+ <!-- or as a toggle group -->
144
+ <ng-oat-theme-selector mode="toggle" />
145
+ \`\`\`
146
+
147
+ The selector sets \`document.documentElement.style.colorScheme\` to \`'light'\`, \`'dark'\`, or system preference. User choice persists in \`localStorage\` (key: \`ng-oat-theme\`).
148
+
149
+ Options: light, dark, system (auto-detects OS preference via \`prefers-color-scheme\`).`,
150
+ },
151
+ {
152
+ topic: 'tokens',
153
+ title: 'Available Color Tokens',
154
+ content: `All 22 color tokens that support \`light-dark()\` overrides:
155
+
156
+ | Token | Description |
157
+ |-------|-------------|
158
+ | \`--oat-background\` | Page background |
159
+ | \`--oat-foreground\` | Default text color |
160
+ | \`--oat-card\` | Card background |
161
+ | \`--oat-card-foreground\` | Card text color |
162
+ | \`--oat-primary\` | Primary brand color |
163
+ | \`--oat-primary-foreground\` | Text on primary |
164
+ | \`--oat-secondary\` | Secondary UI color |
165
+ | \`--oat-secondary-foreground\` | Text on secondary |
166
+ | \`--oat-muted\` | Muted background |
167
+ | \`--oat-muted-foreground\` | Text on muted |
168
+ | \`--oat-faint\` | Faint background |
169
+ | \`--oat-faint-foreground\` | Text on faint |
170
+ | \`--oat-accent\` | Accent highlight |
171
+ | \`--oat-danger\` | Error/danger color |
172
+ | \`--oat-danger-foreground\` | Text on danger |
173
+ | \`--oat-success\` | Success color |
174
+ | \`--oat-success-foreground\` | Text on success |
175
+ | \`--oat-warning\` | Warning color |
176
+ | \`--oat-warning-foreground\` | Text on warning |
177
+ | \`--oat-border\` | Border color |
178
+ | \`--oat-input\` | Input border/bg |
179
+ | \`--oat-ring\` | Focus ring color |
180
+
181
+ Use the \`get_tokens\` tool with \`category: "color"\` for full details.`,
182
+ },
183
+ {
184
+ topic: 'css-only',
185
+ title: 'CSS-Only Theming (No Angular)',
186
+ content: `Override tokens directly in CSS without using Angular providers:
187
+
188
+ \`\`\`css
189
+ /* styles.css */
190
+ :root {
191
+ --oat-primary: #6366f1;
192
+ --oat-radius-medium: 0.75rem;
193
+ --oat-font-sans: 'Inter', system-ui, sans-serif;
194
+ }
195
+ \`\`\`
196
+
197
+ For light/dark mode, override at the \`color-scheme\` level:
198
+
199
+ \`\`\`css
200
+ :root {
201
+ color-scheme: light dark;
202
+ --oat-background: light-dark(#fafafa, #0a0a0a);
203
+ --oat-foreground: light-dark(#111, #eee);
204
+ }
205
+ \`\`\`
206
+
207
+ Or use \`prefers-color-scheme\` media queries:
208
+
209
+ \`\`\`css
210
+ @media (prefers-color-scheme: dark) {
211
+ :root {
212
+ --oat-background: #0a0a0a;
213
+ --oat-foreground: #eee;
214
+ }
215
+ }
216
+ \`\`\``,
217
+ },
218
+ ];
219
+ /**
220
+ * Get theming docs by topic or all sections.
221
+ */
222
+ export function getThemingDocs(topic) {
223
+ if (!topic)
224
+ return THEMING_SECTIONS;
225
+ const q = topic.toLowerCase();
226
+ return THEMING_SECTIONS.filter((s) => s.topic === q || s.title.toLowerCase().includes(q) || s.content.toLowerCase().includes(q));
227
+ }
228
+ //# sourceMappingURL=theming.js.map
package/dist/data/theming.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"theming.js","sourceRoot":"","sources":["../../src/data/theming.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD;QACE,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,kBAAkB;QACzB,OAAO,EAAE;;;;;;;gGAOmF;KAC7F;IACD;QACE,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+GAgCkG;KAC5G;IACD;QACE,KAAK,EAAE,SAAS;QAChB,KAAK,EAAE,4CAA4C;QACnD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;gHAkCmG;KAC7G;IACD;QACE,KAAK,EAAE,YAAY;QACnB,KAAK,EAAE,mCAAmC;QAC1C,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wFAqD2E;KACrF;IACD;QACE,KAAK,EAAE,QAAQ;QACf,KAAK,EAAE,wBAAwB;QAC/B,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;yEA2B4D;KACtE;IACD;QACE,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,+BAA+B;QACtC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BN;KACJ;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,gBAAgB,CAAC;IACpC,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC9B,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACnI,CAAC"}
package/dist/data/tokens.d.ts ADDED
@@ -0,0 +1,17 @@
1
+ /**
2
+ * ng-oat design token metadata for MCP tool lookups.
3
+ */
4
+ export interface TokenMeta {
5
+ name: string;
6
+ upstream: string;
7
+ category: TokenCategory;
8
+ description: string;
9
+ example?: string;
10
+ }
11
+ export type TokenCategory = 'color' | 'spacing' | 'radius' | 'typography' | 'shadow' | 'transition' | 'z-index' | 'dimension' | 'component';
12
+ export declare const TOKENS: TokenMeta[];
13
+ /**
14
+ * Filter tokens by category.
15
+ */
16
+ export declare function filterTokens(category?: TokenCategory): TokenMeta[];
17
+ //# sourceMappingURL=tokens.d.ts.map
package/dist/data/tokens.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../src/data/tokens.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,aAAa,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC;AAE5I,eAAO,MAAM,MAAM,EAAE,SAAS,EA2F7B,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,aAAa,GAAG,SAAS,EAAE,CAGlE"}
package/dist/data/tokens.js ADDED
@@ -0,0 +1,93 @@
1
+ export const TOKENS = [
2
+ // ─── Colors (22) ───
3
+ { name: '--oat-background', upstream: '--background', category: 'color', description: 'Page background color' },
4
+ { name: '--oat-foreground', upstream: '--foreground', category: 'color', description: 'Default text color' },
5
+ { name: '--oat-card', upstream: '--card', category: 'color', description: 'Card background' },
6
+ { name: '--oat-card-foreground', upstream: '--card-foreground', category: 'color', description: 'Card text color' },
7
+ { name: '--oat-primary', upstream: '--primary', category: 'color', description: 'Primary brand color', example: '#3b82f6' },
8
+ { name: '--oat-primary-foreground', upstream: '--primary-foreground', category: 'color', description: 'Text on primary background' },
9
+ { name: '--oat-secondary', upstream: '--secondary', category: 'color', description: 'Secondary UI color' },
10
+ { name: '--oat-secondary-foreground', upstream: '--secondary-foreground', category: 'color', description: 'Text on secondary background' },
11
+ { name: '--oat-muted', upstream: '--muted', category: 'color', description: 'Muted/subdued background' },
12
+ { name: '--oat-muted-foreground', upstream: '--muted-foreground', category: 'color', description: 'Text on muted background' },
13
+ { name: '--oat-faint', upstream: '--faint', category: 'color', description: 'Faint background (even lighter than muted)' },
14
+ { name: '--oat-faint-foreground', upstream: '--faint-foreground', category: 'color', description: 'Text on faint background' },
15
+ { name: '--oat-accent', upstream: '--accent', category: 'color', description: 'Accent highlight color' },
16
+ { name: '--oat-danger', upstream: '--danger', category: 'color', description: 'Error/danger color', example: '#ef4444' },
17
+ { name: '--oat-danger-foreground', upstream: '--danger-foreground', category: 'color', description: 'Text on danger background' },
18
+ { name: '--oat-success', upstream: '--success', category: 'color', description: 'Success/positive color', example: '#22c55e' },
19
+ { name: '--oat-success-foreground', upstream: '--success-foreground', category: 'color', description: 'Text on success background' },
20
+ { name: '--oat-warning', upstream: '--warning', category: 'color', description: 'Warning/caution color', example: '#f59e0b' },
21
+ { name: '--oat-warning-foreground', upstream: '--warning-foreground', category: 'color', description: 'Text on warning background' },
22
+ { name: '--oat-border', upstream: '--border', category: 'color', description: 'Default border color' },
23
+ { name: '--oat-input', upstream: '--input', category: 'color', description: 'Input border/background color' },
24
+ { name: '--oat-ring', upstream: '--ring', category: 'color', description: 'Focus ring color' },
25
+ // ─── Spacing (12) ───
26
+ { name: '--oat-space-1', upstream: '--space-1', category: 'spacing', description: 'Spacing level 1 (smallest)', example: '0.25rem' },
27
+ { name: '--oat-space-2', upstream: '--space-2', category: 'spacing', description: 'Spacing level 2', example: '0.5rem' },
28
+ { name: '--oat-space-3', upstream: '--space-3', category: 'spacing', description: 'Spacing level 3', example: '0.75rem' },
29
+ { name: '--oat-space-4', upstream: '--space-4', category: 'spacing', description: 'Spacing level 4 (default)', example: '1rem' },
30
+ { name: '--oat-space-5', upstream: '--space-5', category: 'spacing', description: 'Spacing level 5', example: '1.25rem' },
31
+ { name: '--oat-space-6', upstream: '--space-6', category: 'spacing', description: 'Spacing level 6', example: '1.5rem' },
32
+ { name: '--oat-space-8', upstream: '--space-8', category: 'spacing', description: 'Spacing level 8', example: '2rem' },
33
+ { name: '--oat-space-10', upstream: '--space-10', category: 'spacing', description: 'Spacing level 10', example: '2.5rem' },
34
+ { name: '--oat-space-12', upstream: '--space-12', category: 'spacing', description: 'Spacing level 12', example: '3rem' },
35
+ { name: '--oat-space-14', upstream: '--space-14', category: 'spacing', description: 'Spacing level 14', example: '3.5rem' },
36
+ { name: '--oat-space-16', upstream: '--space-16', category: 'spacing', description: 'Spacing level 16', example: '4rem' },
37
+ { name: '--oat-space-18', upstream: '--space-18', category: 'spacing', description: 'Spacing level 18 (largest)', example: '4.5rem' },
38
+ // ─── Border Radius (4) ───
39
+ { name: '--oat-radius-small', upstream: '--radius-small', category: 'radius', description: 'Small border radius', example: '0.25rem' },
40
+ { name: '--oat-radius-medium', upstream: '--radius-medium', category: 'radius', description: 'Medium border radius (default)', example: '0.5rem' },
41
+ { name: '--oat-radius-large', upstream: '--radius-large', category: 'radius', description: 'Large border radius', example: '0.75rem' },
42
+ { name: '--oat-radius-full', upstream: '--radius-full', category: 'radius', description: 'Fully rounded (pill/circle)', example: '9999px' },
43
+ // ─── Typography (14) ───
44
+ { name: '--oat-font-sans', upstream: '--font-sans', category: 'typography', description: 'Sans-serif font stack' },
45
+ { name: '--oat-font-mono', upstream: '--font-mono', category: 'typography', description: 'Monospace font stack' },
46
+ { name: '--oat-text-1', upstream: '--text-1', category: 'typography', description: 'Text size scale step 1 (largest, h1)' },
47
+ { name: '--oat-text-2', upstream: '--text-2', category: 'typography', description: 'Text size scale step 2 (h2)' },
48
+ { name: '--oat-text-3', upstream: '--text-3', category: 'typography', description: 'Text size scale step 3 (h3)' },
49
+ { name: '--oat-text-4', upstream: '--text-4', category: 'typography', description: 'Text size scale step 4 (h4)' },
50
+ { name: '--oat-text-5', upstream: '--text-5', category: 'typography', description: 'Text size scale step 5 (h5)' },
51
+ { name: '--oat-text-6', upstream: '--text-6', category: 'typography', description: 'Text size scale step 6 (h6)' },
52
+ { name: '--oat-text-7', upstream: '--text-7', category: 'typography', description: 'Text size scale step 7 (small text)' },
53
+ { name: '--oat-text-8', upstream: '--text-8', category: 'typography', description: 'Text size scale step 8 (caption)' },
54
+ { name: '--oat-text-regular', upstream: '--text-regular', category: 'typography', description: 'Base body text size' },
55
+ { name: '--oat-leading-normal', upstream: '--leading-normal', category: 'typography', description: 'Default line-height' },
56
+ { name: '--oat-font-normal', upstream: '--font-normal', category: 'typography', description: 'Font weight: normal (400)' },
57
+ { name: '--oat-font-medium', upstream: '--font-medium', category: 'typography', description: 'Font weight: medium (500)' },
58
+ { name: '--oat-font-semibold', upstream: '--font-semibold', category: 'typography', description: 'Font weight: semibold (600)' },
59
+ { name: '--oat-font-bold', upstream: '--font-bold', category: 'typography', description: 'Font weight: bold (700)' },
60
+ // ─── Shadows (3) ───
61
+ { name: '--oat-shadow-small', upstream: '--shadow-small', category: 'shadow', description: 'Small box shadow' },
62
+ { name: '--oat-shadow-medium', upstream: '--shadow-medium', category: 'shadow', description: 'Medium box shadow' },
63
+ { name: '--oat-shadow-large', upstream: '--shadow-large', category: 'shadow', description: 'Large box shadow' },
64
+ // ─── Transitions (2) ───
65
+ { name: '--oat-transition-fast', upstream: '--transition-fast', category: 'transition', description: 'Fast transition timing' },
66
+ { name: '--oat-transition', upstream: '--transition', category: 'transition', description: 'Default transition timing' },
67
+ // ─── Z-Index (8) ───
68
+ { name: '--oat-z-base', upstream: '--z-base', category: 'z-index', description: 'Base z-index (0)', example: '0' },
69
+ { name: '--oat-z-sticky', upstream: '--z-sticky', category: 'z-index', description: 'Sticky elements', example: '100' },
70
+ { name: '--oat-z-fixed', upstream: '--z-fixed', category: 'z-index', description: 'Fixed positioning', example: '200' },
71
+ { name: '--oat-z-dropdown', upstream: '--z-dropdown', category: 'z-index', description: 'Dropdown menus', example: '1000' },
72
+ { name: '--oat-z-toast', upstream: '--z-toast', category: 'z-index', description: 'Toast notifications', example: '1100' },
73
+ { name: '--oat-z-modal', upstream: '--z-modal', category: 'z-index', description: 'Modal dialogs', example: '1200' },
74
+ { name: '--oat-z-popover', upstream: '--z-popover', category: 'z-index', description: 'Popovers', example: '1300' },
75
+ { name: '--oat-z-tooltip', upstream: '--z-tooltip', category: 'z-index', description: 'Tooltips (topmost)', example: '1400' },
76
+ // ─── Dimensions (1) ───
77
+ { name: '--oat-bar-height', upstream: '--bar-height', category: 'dimension', description: 'Toolbar/nav bar height' },
78
+ // ─── Component-level (5) ───
79
+ { name: '--oat-grid-cols', upstream: '--grid-cols', category: 'component', description: 'Grid column count', example: '12' },
80
+ { name: '--oat-grid-gap', upstream: '--grid-gap', category: 'component', description: 'Grid gap', example: '1rem' },
81
+ { name: '--oat-container-max', upstream: '--container-max', category: 'component', description: 'Max container width', example: '1200px' },
82
+ { name: '--oat-container-pad', upstream: '--container-pad', category: 'component', description: 'Container horizontal padding' },
83
+ { name: '--oat-topnav-offset', upstream: '--topnav-offset', category: 'component', description: 'Top nav offset for fixed toolbar' },
84
+ ];
85
+ /**
86
+ * Filter tokens by category.
87
+ */
88
+ export function filterTokens(category) {
89
+ if (!category)
90
+ return TOKENS;
91
+ return TOKENS.filter((t) => t.category === category);
92
+ }
93
+ //# sourceMappingURL=tokens.js.map
package/dist/data/tokens.js.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/data/tokens.ts"],"names":[],"mappings":"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"}
package/dist/data/utilities.d.ts ADDED
@@ -0,0 +1,20 @@
1
+ /**
2
+ * ng-oat CSS utility class metadata for MCP tool lookups.
3
+ * Auto-generated from @letsprogram/ng-oat v0.2.4 utilities.css (3065 lines).
4
+ */
5
+ export interface UtilityMeta {
6
+ category: string;
7
+ classes: {
8
+ name: string;
9
+ description: string;
10
+ example?: string;
11
+ }[];
12
+ }
13
+ export declare const UTILITIES: UtilityMeta[];
14
+ /** All available utility categories for listing. */
15
+ export declare const UTILITY_CATEGORIES: string[];
16
+ /**
17
+ * Get utilities by category, or all.
18
+ */
19
+ export declare function getUtilities(category?: string): UtilityMeta[];
20
+ //# sourceMappingURL=utilities.d.ts.map
package/dist/data/utilities.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"utilities.d.ts","sourceRoot":"","sources":["../../src/data/utilities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACpE;AAED,eAAO,MAAM,SAAS,EAAE,WAAW,EA2jBlC,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,kBAAkB,UAAmC,CAAC;AAEnE;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,EAAE,CAG7D"}