@getmicdrop/svelte-components 5.5.5 → 5.6.0

package/dist/tokens/__tests__/typography-base.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typography-base.test.d.ts.map

package/dist/tokens/__tests__/typography-base.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typography-base.test.d.ts","sourceRoot":"","sources":["../../../src/lib/tokens/__tests__/typography-base.test.ts"],"names":[],"mappings":""}

package/dist/tokens/__tests__/typography-base.test.js

@@ -0,0 +1,138 @@
+import { describe, it, expect } from 'vitest';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+// Read the CSS file content for testing
+const cssPath = join(__dirname, '../typography-base.css');
+const cssContent = readFileSync(cssPath, 'utf-8');
+describe('Typography Base CSS', () => {
+    describe('File Structure', () => {
+        it('uses @layer base for element styles', () => {
+            expect(cssContent).toContain('@layer base');
+        });
+        it('contains documentation header', () => {
+            expect(cssContent).toContain('Typography Base Styles');
+            expect(cssContent).toContain('Usage in app.css');
+        });
+    });
+    describe('Heading Styles', () => {
+        it('defines styles for all heading levels', () => {
+            expect(cssContent).toMatch(/h1\s*\{/);
+            expect(cssContent).toMatch(/h2\s*\{/);
+            expect(cssContent).toMatch(/h3\s*\{/);
+            expect(cssContent).toMatch(/h4\s*\{/);
+            expect(cssContent).toMatch(/h5\s*\{/);
+            expect(cssContent).toMatch(/h6\s*\{/);
+        });
+        it('headings use semibold weight', () => {
+            // Each heading should have font-semibold
+            const headingMatches = cssContent.match(/h[1-6]\s*\{[^}]+\}/g) || [];
+            expect(headingMatches.length).toBeGreaterThanOrEqual(6);
+            headingMatches.forEach(match => {
+                expect(match).toContain('font-semibold');
+            });
+        });
+        it('headings have dark mode support', () => {
+            const headingMatches = cssContent.match(/h[1-6]\s*\{[^}]+\}/g) || [];
+            headingMatches.forEach(match => {
+                expect(match).toContain('dark:text-white');
+            });
+        });
+    });
+    describe('Body Text Styles', () => {
+        it('defines paragraph style', () => {
+            expect(cssContent).toMatch(/p\s*\{/);
+        });
+        it('paragraph uses secondary color for visual hierarchy', () => {
+            const pMatch = cssContent.match(/p\s*\{[^}]+\}/);
+            expect(pMatch).toBeTruthy();
+            expect(pMatch[0]).toContain('text-gray-600');
+            expect(pMatch[0]).toContain('dark:text-gray-300');
+        });
+        it('paragraph has relaxed line height', () => {
+            const pMatch = cssContent.match(/p\s*\{[^}]+\}/);
+            expect(pMatch[0]).toContain('leading-relaxed');
+        });
+    });
+    describe('Form Elements', () => {
+        it('defines label style', () => {
+            expect(cssContent).toMatch(/label\s*\{/);
+        });
+        it('label has medium weight', () => {
+            const labelMatch = cssContent.match(/label\s*\{[^}]+\}/);
+            expect(labelMatch).toBeTruthy();
+            expect(labelMatch[0]).toContain('font-medium');
+        });
+    });
+    describe('Links', () => {
+        it('defines anchor style', () => {
+            expect(cssContent).toMatch(/a\s*\{/);
+        });
+        it('links have blue color and hover underline', () => {
+            const aMatch = cssContent.match(/a\s*\{[^}]+\}/);
+            expect(aMatch).toBeTruthy();
+            expect(aMatch[0]).toContain('text-blue-600');
+            expect(aMatch[0]).toContain('hover:underline');
+        });
+    });
+    describe('Code Elements', () => {
+        it('defines code and pre styles', () => {
+            expect(cssContent).toMatch(/code\s*\{/);
+            expect(cssContent).toMatch(/pre\s*\{/);
+        });
+        it('code uses monospace font', () => {
+            const codeMatch = cssContent.match(/(?<!pre\s*)code\s*\{[^}]+\}/);
+            expect(codeMatch).toBeTruthy();
+            expect(codeMatch[0]).toContain('font-mono');
+        });
+        it('pre code resets background', () => {
+            expect(cssContent).toMatch(/pre\s+code\s*\{[^}]+bg-transparent/);
+        });
+    });
+    describe('Additional Elements', () => {
+        it('defines small text style', () => {
+            expect(cssContent).toMatch(/small\s*\{/);
+        });
+        it('defines list styles', () => {
+            expect(cssContent).toMatch(/ul,\s*ol\s*\{/);
+            expect(cssContent).toMatch(/li\s*\{/);
+        });
+        it('defines blockquote style', () => {
+            expect(cssContent).toMatch(/blockquote\s*\{/);
+        });
+        it('defines emphasis styles', () => {
+            expect(cssContent).toMatch(/strong,\s*b\s*\{/);
+            expect(cssContent).toMatch(/em,\s*i\s*\{/);
+        });
+        it('defines mark/highlight style', () => {
+            expect(cssContent).toMatch(/mark\s*\{/);
+        });
+    });
+    describe('No Conflicting Utilities', () => {
+        it('does NOT define .text-muted utility (app-specific)', () => {
+            expect(cssContent).not.toMatch(/\.text-muted\s*\{/);
+        });
+        it('does NOT define .text-primary utility (app-specific)', () => {
+            expect(cssContent).not.toMatch(/\.text-primary\s*\{/);
+        });
+        it('does NOT define .text-secondary utility (app-specific)', () => {
+            expect(cssContent).not.toMatch(/\.text-secondary\s*\{/);
+        });
+    });
+});
+describe('Typography Base CSS Consistency with typography.ts', () => {
+    // Note: typography-base.css intentionally uses different colors for <p> elements
+    // to create visual hierarchy. The CSS styles raw HTML elements, while typography.ts
+    // provides class-based tokens for explicit styling.
+    //
+    // Design decision:
+    // - <p> without classes: secondary color (gray-600) for body text
+    // - typography.body class: primary color (gray-900) for emphasized content
+    //
+    // This is intentional and not a bug.
+    it('documents the intentional difference between CSS <p> and typography.body', () => {
+        // This test exists to document the design decision
+        const pMatch = cssContent.match(/p\s*\{[^}]+\}/);
+        expect(pMatch[0]).toContain('text-gray-600'); // CSS uses secondary
+        // typography.body uses gray-900 (primary) - verified in typography.test.ts
+    });
+});

package/dist/tokens/tokens.css

@@ -1,87 +1,87 @@
-:root {
-  --bg-primary: 0 0% 100%;
-  --bg-secondary: 220 7% 97%;
-  --bg-tertiary: 220 7% 94%;
-  --bg-quaternary: 220 6% 91%;
-
-  --text-primary: 221 50% 10%;
-  --text-secondary: 220 20% 18%;
-  --text-tertiary: 221 9% 44%;
-  --text-head: 221 9% 44%;
-
-  --brand-primary: 209 99% 50%;
-
-  --accent-warning: 28 100% 59%;
-  --accent-danger: 0 100% 70%;
-  --accent-success: 131 77% 35%;
-
-  --stroke-primary: 216 6% 84%;
-  --stroke-secondary: 216 6% 84%;
-  --border: 220 13% 91%;
-
-  --card: 0 0% 100%;
-  --card-foreground: 224 71.4% 4.1%;
-  --popover: 0 0% 100%;
-  --popover-foreground: 224 71.4% 4.1%;
-  --muted: 220 14.3% 95.9%;
-  --muted-foreground: 220 8.9% 46.1%;
-  --hover-primary: 210 20% 96%;
-
-  --sidebar-background: 0 0% 100%;
-  --sidebar-foreground: 220 20% 18%;
-  --sidebar-border: 220 13% 91%;
-  --sidebar-primary: 221 65% 54%;
-  --sidebar-primary-foreground: 221 50% 10%;
-
-  --BG-Primary: var(--bg-primary);
-  --BG-Secondary: var(--bg-secondary);
-  --BG-Tertiary: var(--bg-tertiary);
-  --BG-Quaternary: var(--bg-quaternary);
-  --Text-Primary: var(--text-primary);
-  --Text-Secondary: var(--text-secondary);
-  --Text-Tartiary: var(--text-tertiary);
-  --Text-Head: var(--text-head);
-  --Brand-Primary: var(--brand-primary);
-  --Accent-Warning: var(--accent-warning);
-  --Accent-Danger: var(--accent-danger);
-  --Accent-Success: var(--accent-success);
-  --Stroke-Primary: var(--stroke-primary);
-  --Stroke-Secondary: var(--stroke-secondary);
-}
-
-[data-theme="dark"],
-.dark {
-  --bg-primary: 220 20% 18%;
-  --bg-secondary: 221 50% 10%;
-  --bg-tertiary: 221 50% 6%;
-  --bg-quaternary: 0 0% 0%;
-
-  --text-primary: 220 7% 97%;
-  --text-secondary: 220 7% 94%;
-  --text-tertiary: 220 6% 91%;
-  --text-head: 220 9% 70%;
-
-  --brand-primary: 220 89% 63%;
-
-  --accent-warning: 30 100% 70%;
-  --accent-danger: 0 100% 70%;
-  --accent-success: 142 71% 45%;
-
-  --stroke-primary: 220 20% 28%;
-  --stroke-secondary: 220 20% 28%;
-  --border: 215 27.9% 16.9%;
-
-  --card: 224 20% 10%;
-  --card-foreground: 210 20% 98%;
-  --popover: 224 71.4% 4.1%;
-  --popover-foreground: 210 20% 98%;
-  --muted: 215 27.9% 16.9%;
-  --muted-foreground: 217.9 10.6% 64.9%;
-  --hover-primary: 222 10% 39%;
-
-  --sidebar-background: 220 20% 18%;
-  --sidebar-foreground: 220 7% 94%;
-  --sidebar-border: 215 20% 20%;
-  --sidebar-primary: 221 65% 54%;
-  --sidebar-primary-foreground: 220 7% 97%;
-}
+:root {
+  --bg-primary: 0 0% 100%;
+  --bg-secondary: 220 7% 97%;
+  --bg-tertiary: 220 7% 94%;
+  --bg-quaternary: 220 6% 91%;
+
+  --text-primary: 221 50% 10%;
+  --text-secondary: 220 20% 18%;
+  --text-tertiary: 221 9% 44%;
+  --text-head: 221 9% 44%;
+
+  --brand-primary: 209 99% 50%;
+
+  --accent-warning: 28 100% 59%;
+  --accent-danger: 0 100% 70%;
+  --accent-success: 131 77% 35%;
+
+  --stroke-primary: 216 6% 84%;
+  --stroke-secondary: 216 6% 84%;
+  --border: 220 13% 91%;
+
+  --card: 0 0% 100%;
+  --card-foreground: 224 71.4% 4.1%;
+  --popover: 0 0% 100%;
+  --popover-foreground: 224 71.4% 4.1%;
+  --muted: 220 14.3% 95.9%;
+  --muted-foreground: 220 8.9% 46.1%;
+  --hover-primary: 210 20% 96%;
+
+  --sidebar-background: 0 0% 100%;
+  --sidebar-foreground: 220 20% 18%;
+  --sidebar-border: 220 13% 91%;
+  --sidebar-primary: 221 65% 54%;
+  --sidebar-primary-foreground: 221 50% 10%;
+
+  --BG-Primary: var(--bg-primary);
+  --BG-Secondary: var(--bg-secondary);
+  --BG-Tertiary: var(--bg-tertiary);
+  --BG-Quaternary: var(--bg-quaternary);
+  --Text-Primary: var(--text-primary);
+  --Text-Secondary: var(--text-secondary);
+  --Text-Tartiary: var(--text-tertiary);
+  --Text-Head: var(--text-head);
+  --Brand-Primary: var(--brand-primary);
+  --Accent-Warning: var(--accent-warning);
+  --Accent-Danger: var(--accent-danger);
+  --Accent-Success: var(--accent-success);
+  --Stroke-Primary: var(--stroke-primary);
+  --Stroke-Secondary: var(--stroke-secondary);
+}
+
+[data-theme="dark"],
+.dark {
+  --bg-primary: 220 20% 18%;
+  --bg-secondary: 221 50% 10%;
+  --bg-tertiary: 221 50% 6%;
+  --bg-quaternary: 0 0% 0%;
+
+  --text-primary: 220 7% 97%;
+  --text-secondary: 220 7% 94%;
+  --text-tertiary: 220 6% 91%;
+  --text-head: 220 9% 70%;
+
+  --brand-primary: 220 89% 63%;
+
+  --accent-warning: 30 100% 70%;
+  --accent-danger: 0 100% 70%;
+  --accent-success: 142 71% 45%;
+
+  --stroke-primary: 220 20% 28%;
+  --stroke-secondary: 220 20% 28%;
+  --border: 215 27.9% 16.9%;
+
+  --card: 224 20% 10%;
+  --card-foreground: 210 20% 98%;
+  --popover: 224 71.4% 4.1%;
+  --popover-foreground: 210 20% 98%;
+  --muted: 215 27.9% 16.9%;
+  --muted-foreground: 217.9 10.6% 64.9%;
+  --hover-primary: 222 10% 39%;
+
+  --sidebar-background: 220 20% 18%;
+  --sidebar-foreground: 220 7% 94%;
+  --sidebar-border: 215 20% 20%;
+  --sidebar-primary: 221 65% 54%;
+  --sidebar-primary-foreground: 220 7% 97%;
+}

package/dist/tokens/typography-base.css

@@ -0,0 +1,163 @@
+/**
+ * Typography Base Styles
+ *
+ * These base styles apply default typography to semantic HTML elements.
+ * Import this file in your app's CSS to get consistent typography without
+ * needing to add classes to every heading and paragraph.
+ *
+ * Usage in app.css:
+ *   @import '@getmicdrop/svelte-components/tokens/typography-base.css';
+ *
+ * After importing, these elements will have consistent styling:
+ *   <h1>Page Title</h1>        - No classes needed
+ *   <h2>Section Title</h2>     - No classes needed
+ *   <p>Body text</p>           - No classes needed
+ *
+ * Override when needed:
+ *   <h1 class="text-3xl">Larger Title</h1>
+ *   <p class="text-sm text-muted">Smaller muted text</p>
+ */
+
+@layer base {
+  /* ==========================================================================
+   * HEADINGS
+   * Semantic heading hierarchy with consistent sizing, weight, and colors.
+   * Uses semibold weight for all headings to maintain visual hierarchy.
+   * ========================================================================== */
+
+  h1 {
+    @apply text-2xl font-semibold text-gray-900 dark:text-white leading-tight;
+  }
+
+  h2 {
+    @apply text-xl font-semibold text-gray-900 dark:text-white leading-tight;
+  }
+
+  h3 {
+    @apply text-lg font-semibold text-gray-900 dark:text-white leading-tight;
+  }
+
+  h4 {
+    @apply text-base font-semibold text-gray-900 dark:text-white leading-tight;
+  }
+
+  h5 {
+    @apply text-sm font-semibold text-gray-900 dark:text-white leading-tight;
+  }
+
+  h6 {
+    @apply text-xs font-semibold text-gray-900 dark:text-white leading-tight uppercase tracking-wide;
+  }
+
+  /* ==========================================================================
+   * BODY TEXT
+   * Default paragraph styling with comfortable reading line height.
+   * Uses secondary color (gray-600/gray-300) for body text to create
+   * visual hierarchy with headings.
+   * ========================================================================== */
+
+  p {
+    @apply text-base text-gray-600 dark:text-gray-300 leading-relaxed;
+  }
+
+  /* ==========================================================================
+   * FORM LABELS
+   * Form labels are slightly smaller than body text with medium weight
+   * to distinguish them from regular text.
+   * ========================================================================== */
+
+  label {
+    @apply text-sm font-medium text-gray-900 dark:text-white;
+  }
+
+  /* ==========================================================================
+   * LINKS
+   * Blue links with hover underline for clear affordance.
+   * ========================================================================== */
+
+  a {
+    @apply text-blue-600 dark:text-blue-400 hover:underline;
+  }
+
+  /* ==========================================================================
+   * EMPHASIS
+   * Strong and emphasis elements inherit color but add weight/style.
+   * ========================================================================== */
+
+  strong, b {
+    @apply font-semibold;
+  }
+
+  em, i {
+    @apply italic;
+  }
+
+  /* ==========================================================================
+   * SMALL TEXT
+   * For fine print, captions, and secondary information.
+   * ========================================================================== */
+
+  small {
+    @apply text-sm text-gray-500 dark:text-gray-400;
+  }
+
+  /* ==========================================================================
+   * LISTS
+   * Consistent list styling that matches body text.
+   * ========================================================================== */
+
+  ul, ol {
+    @apply text-base text-gray-600 dark:text-gray-300 leading-relaxed;
+  }
+
+  li {
+    @apply mb-1;
+  }
+
+  /* ==========================================================================
+   * BLOCKQUOTE
+   * Indented with left border for quoted content.
+   * ========================================================================== */
+
+  blockquote {
+    @apply pl-4 border-l-4 border-gray-200 dark:border-gray-700 text-gray-600 dark:text-gray-300 italic;
+  }
+
+  /* ==========================================================================
+   * CODE
+   * Monospace font with subtle background for inline code.
+   * ========================================================================== */
+
+  code {
+    @apply font-mono text-sm bg-gray-100 dark:bg-gray-800 px-1.5 py-0.5 rounded text-gray-900 dark:text-gray-100;
+  }
+
+  pre {
+    @apply font-mono text-sm bg-gray-100 dark:bg-gray-800 p-4 rounded-lg overflow-x-auto text-gray-900 dark:text-gray-100;
+  }
+
+  pre code {
+    @apply bg-transparent p-0;
+  }
+
+  /* ==========================================================================
+   * MARK/HIGHLIGHT
+   * Yellow highlight for marked/highlighted text.
+   * ========================================================================== */
+
+  mark {
+    @apply bg-yellow-200 dark:bg-yellow-800 px-1 rounded;
+  }
+}
+
+/* ==========================================================================
+ * NOTE ON UTILITY CLASSES
+ *
+ * This file intentionally does NOT define utility classes like .text-muted,
+ * .text-primary, etc. These are defined in individual app's app.css files
+ * because they reference app-specific CSS custom properties (e.g., --Text-Tartiary).
+ *
+ * For typography utilities, import and use tokens from typography.ts:
+ *   import { typography } from '@getmicdrop/svelte-components';
+ *   <span class={typography.smMuted}>Helper text</span>
+ * ========================================================================== */