@rokkit/themes 1.1.15 → 1.1.17

package/build.mjs

@@ -20,7 +20,7 @@
 import { createGenerator, presetWind3, transformerDirectives } from 'unocss'
 import { Theme } from '@rokkit/core'
 import { buildNamedShortcuts } from '@rokkit/unocss'
-import { readFileSync, writeFileSync, mkdirSync } from 'fs'
+import { readFileSync, writeFileSync, mkdirSync, readdirSync } from 'fs'
 import { resolve, dirname, join } from 'path'
 import { fileURLToPath } from 'url'
 import MagicString from 'magic-string'
@@ -178,19 +178,79 @@ function splitTopLevelSelectors(text) {
   return parts
 }
 
+// ─── Regression guard: no @apply may survive into dist ────────────────────────
+
+/**
+ * Strip /* … *​/ block comments so the scan matches real CSS, not prose
+ * (some files document the @apply pitfall in comments). Mirrors the
+ * `stripComments` helper in spec/coverage.spec.js.
+ */
+const stripComments = (s) => s.replace(/\/\*[\s\S]*?\*\//g, '')
+
+/**
+ * Fail the build if any real `@apply` directive survived into a dist file.
+ *
+ * A leftover `@apply` means a utility didn't resolve (e.g. a named-token
+ * `/opacity` shortcut, which UnoCSS can't expand) and would ship raw to
+ * consumers — triggering `[lightningcss minify] Unknown at rule: @apply`
+ * and rendering nothing. This is the recurrence guard for issue #135.
+ */
+function assertNoApply(outputName) {
+  const content = readFileSync(join(distDir, outputName), 'utf-8') // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — outputName is derived from a hardcoded string array, not user input
+  const lines = stripComments(content).split('\n')
+  const offending = []
+  lines.forEach((line, i) => {
+    if (/@apply\b/.test(line)) offending.push(`  dist/${outputName}:${i + 1}  ${line.trim()}`)
+  })
+  if (offending.length > 0) {
+    throw new Error(
+      `Unresolved @apply leaked into dist/${outputName} (issue #135 recurrence).\n` +
+        `These utilities did not resolve during build — rewrite them to raw CSS ` +
+        `(e.g. color-mix for named-token /opacity):\n${offending.join('\n')}`
+    )
+  }
+}
+
 // ─── Build ────────────────────────────────────────────────────────────────────
 
 const srcDir = join(__dirname, 'src')
 const distDir = join(__dirname, 'dist')
 
+/** Names of every dist file emitted by this build, scanned by the guard. */
+const emitted = []
+
 async function buildFile(inputPath, outputName, label) {
   const fullCSS = resolveImports(inputPath)
   const compiled = await processCSS(fullCSS, outputName)
   const fixed = fixModeSelectors(compiled)
   writeFileSync(join(distDir, outputName), fixed, 'utf-8') // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — outputName is derived from a hardcoded string array, not user input
+  emitted.push(outputName)
   console.log(`✓ dist/${outputName} (${label})`)
 }
 
+/**
+ * Compile every per-component CSS file (e.g. src/frosted/button.css) into
+ * dist/<style>/<component>.css, expanding @apply just like the bundled files.
+ *
+ * Consumers that import a single component path (e.g.
+ * `@rokkit/themes/frosted/button.css`) get resolved CSS, not raw @apply — the
+ * `./<style>/*` exports point here. index.css is skipped (it is only an
+ * aggregator of @imports, already compiled into dist/<style>.css).
+ */
+async function buildComponentFiles(style) {
+  mkdirSync(join(distDir, style), { recursive: true }) // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — style is from a hardcoded string array, not user input
+  const files = readdirSync(join(srcDir, style)) // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — style is from a hardcoded string array, not user input
+    .filter((f) => f.endsWith('.css') && f !== 'index.css')
+    .sort()
+  for (const file of files) {
+    const outputName = `${style}/${file}`
+    const compiled = await processCSS(readFileSync(join(srcDir, style, file), 'utf-8'), outputName) // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — style/file enumerate a hardcoded src dir, not user input
+    writeFileSync(join(distDir, outputName), fixModeSelectors(compiled), 'utf-8') // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — derived from enumerated src files, not user input
+    emitted.push(outputName)
+  }
+  console.log(`✓ dist/${style}/*.css (${files.length} components)`)
+}
+
 async function build() {
   mkdirSync(distDir, { recursive: true })
 
@@ -202,6 +262,7 @@ async function build() {
   const compiledBase = await processCSS(baseCSS, 'base.css')
   const baseFull = fixModeSelectors(compiledPalette + '\n' + zScaleCSS + '\n' + compiledBase)
   writeFileSync(join(distDir, 'base.css'), baseFull, 'utf-8')
+  emitted.push('base.css')
   console.log('✓ dist/base.css (structural styles + palette defaults)')
 
   // Per-theme files
@@ -215,6 +276,11 @@ async function build() {
     await buildFile(join(srcDir, name, 'index.css'), `${name}.css`, label)
   }
 
+  // Per-component files: dist/<style>/<component>.css (for `./<style>/*` exports)
+  for (const style of ['base', 'rokkit', 'minimal', 'material', 'frosted', 'zen-sumi']) {
+    await buildComponentFiles(style)
+  }
+
   // Full bundle: base + all themes
   const allThemes = [
     'base',
@@ -227,8 +293,12 @@ async function build() {
   // nosemgrep: javascript.lang.security.audit.path-traversal.path-join-resolve-traversal.path-join-resolve-traversal — name is from a hardcoded string array, not user input
   const bundleParts = allThemes.map((name) => readFileSync(join(distDir, `${name}.css`), 'utf-8'))
   writeFileSync(join(distDir, 'index.css'), bundleParts.join('\n'), 'utf-8')
+  emitted.push('index.css')
   console.log('✓ dist/index.css (full bundle)')
 
+  // Regression guard (#135): no unresolved @apply may ship in dist.
+  for (const outputName of emitted) assertNoApply(outputName)
+
   console.log('\n@rokkit/themes build complete.')
 }
 

package/dist/base/alert-list.css

@@ -0,0 +1,91 @@
+/* AlertList — base structural styles for the fixed toast container */
+
+[data-alert-list] {
+  position: fixed;
+  z-index: 9999;
+  display: flex;
+  flex-direction: column;
+  max-width: 24rem;
+  width: calc(100% - 2rem);
+  padding: 1rem;
+  pointer-events: none;
+}
+
+/* Each toast wrapper: handles enter animation, spacing, and dismiss collapse */
+[data-alert-list] > * {
+  pointer-events: auto;
+  overflow: hidden;
+  max-height: 12rem;
+  margin-bottom: 0.5rem;
+  transition:
+    max-height 0.25s ease-out,
+    margin-bottom 0.25s ease-out;
+}
+
+/* Collapse height + spacing when dismissing — CSS drives the animation */
+[data-alert-list] > *[data-dismissing] {
+  max-height: 0;
+  margin-bottom: 0;
+}
+
+/* Message enter animation */
+@keyframes toast-enter {
+  from {
+    opacity: 0;
+    transform: translateX(2rem);
+  }
+  to {
+    opacity: 1;
+    transform: translateX(0);
+  }
+}
+
+/* Message exit transition */
+[data-alert-list] > * > [data-message-root] {
+  animation: toast-enter 0.2s ease-out;
+  transition:
+    opacity 0.2s ease-out,
+    transform 0.2s ease-out;
+}
+
+[data-alert-list] > *[data-dismissing] > [data-message-root] {
+  opacity: 0;
+  transform: translateX(2rem);
+}
+
+/* Top positions */
+[data-alert-list][data-position='top-right'] {
+  top: 0;
+  right: 0;
+}
+
+[data-alert-list][data-position='top-center'] {
+  top: 0;
+  left: 50%;
+  transform: translateX(-50%);
+}
+
+[data-alert-list][data-position='top-left'] {
+  top: 0;
+  left: 0;
+}
+
+/* Bottom positions — reverse stack so newest appears at bottom edge */
+[data-alert-list][data-position='bottom-right'] {
+  bottom: 0;
+  right: 0;
+  flex-direction: column-reverse;
+}
+
+[data-alert-list][data-position='bottom-center'] {
+  bottom: 0;
+  left: 50%;
+  transform: translateX(-50%);
+  flex-direction: column-reverse;
+}
+
+[data-alert-list][data-position='bottom-left'] {
+  bottom: 0;
+  left: 0;
+  flex-direction: column-reverse;
+}

package/dist/base/avatar.css

@@ -0,0 +1,82 @@
+/* Avatar — base structural styles */
+
+[data-avatar] {
+  position: relative;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  flex-shrink: 0;
+  overflow: hidden;
+  user-select: none;
+}
+
+/* Shape */
+[data-avatar][data-shape='circle'] {
+  border-radius: 9999px;
+}
+
+[data-avatar][data-shape='square'] {
+  border-radius: 0.375rem;
+}
+
+/* Size variants */
+[data-avatar][data-size='xs'] {
+  width: 1.5rem;
+  height: 1.5rem;
+  font-size: 0.5rem;
+}
+
+[data-avatar][data-size='sm'] {
+  width: 2rem;
+  height: 2rem;
+  font-size: 0.625rem;
+}
+
+[data-avatar][data-size='md'] {
+  width: 2.5rem;
+  height: 2.5rem;
+  font-size: 0.75rem;
+}
+
+[data-avatar][data-size='lg'] {
+  width: 3rem;
+  height: 3rem;
+  font-size: 0.875rem;
+}
+
+[data-avatar][data-size='xl'] {
+  width: 4rem;
+  height: 4rem;
+  font-size: 1.125rem;
+}
+
+[data-avatar-img] {
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+[data-avatar-initials] {
+  font-weight: 600;
+  letter-spacing: 0.02em;
+  line-height: 1;
+}
+
+/* Status indicator dot */
+[data-avatar-status] {
+  position: absolute;
+  bottom: 0;
+  right: 0;
+  width: 25%;
+  height: 25%;
+  min-width: 0.5rem;
+  min-height: 0.5rem;
+  border-radius: 9999px;
+  border: 2px solid transparent;
+}
+
+[data-avatar][data-shape='square'] [data-avatar-status] {
+  border-radius: 9999px;
+  bottom: -0.125rem;
+  right: -0.125rem;
+}

package/dist/base/badge.css

@@ -0,0 +1,41 @@
+/* Badge — base structural styles */
+
+[data-badge-wrapper] {
+  position: relative;
+  display: inline-flex;
+}
+
+[data-badge] {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 1.25rem;
+  height: 1.25rem;
+  padding: 0 0.375rem;
+  border-radius: 9999px;
+  font-size: 0.6875rem;
+  font-weight: 600;
+  line-height: 1;
+  white-space: nowrap;
+}
+
+/* Dot mode — small circle with no content */
+[data-badge][data-dot] {
+  min-width: 0.5rem;
+  width: 0.5rem;
+  height: 0.5rem;
+  padding: 0;
+}
+
+/* Positioned inside a wrapper */
+[data-badge-wrapper] [data-badge] {
+  position: absolute;
+  top: -0.375rem;
+  right: -0.375rem;
+  z-index: 1;
+}
+
+[data-badge-wrapper] [data-badge][data-dot] {
+  top: -0.125rem;
+  right: -0.125rem;
+}

package/dist/base/breadcrumbs.css

@@ -0,0 +1,47 @@
+/* BreadCrumbs — base structural styles */
+
+[data-breadcrumbs] {
+  display: block;
+}
+
+[data-breadcrumb-list] {
+  display: flex;
+  align-items: center;
+  list-style: none;
+  padding: 0;
+  margin: 0;
+  gap: 0.25rem;
+}
+
+[data-breadcrumb-item] {
+  display: flex;
+  align-items: center;
+}
+
+[data-breadcrumb-separator] {
+  display: flex;
+  align-items: center;
+  opacity: 0.5;
+}
+
+[data-breadcrumb-link] {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+  background: none;
+  border: none;
+  cursor: pointer;
+  padding: 0.25rem 0.5rem;
+  border-radius: 0.25rem;
+  font: inherit;
+  color: inherit;
+  text-decoration: none;
+}
+
+[data-breadcrumb-current] {
+  display: flex;
+  align-items: center;
+  gap: 0.25rem;
+  padding: 0.25rem 0.5rem;
+  font-weight: 600;
+}

package/dist/base/button.css

@@ -0,0 +1,254 @@
+/**
+ * Button - Base Structural Styles
+ *
+ * These styles provide layout, positioning, and basic structure.
+ * No colors, shadows, or visual theming - those belong in theme styles.
+ */
+
+/* =============================================================================
+   Button
+   ============================================================================= */
+
+[data-button] {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.5rem;
+  border-radius: 0.5rem;
+  font-weight: 500;
+  cursor: pointer;
+  border: 1px solid transparent;
+  white-space: nowrap;
+  user-select: none;
+  text-decoration: none;
+  transition: all 150ms ease;
+  background: transparent;
+  color: inherit;
+  font-family: inherit;
+  line-height: 1;
+}
+
+[data-button]:focus {
+  outline: none;
+}
+
+[data-button]:focus-visible {
+  outline: 2px solid currentColor;
+  outline-offset: 2px;
+}
+
+/* Disabled */
+[data-button][data-disabled],
+[data-button]:disabled {
+  pointer-events: none;
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+/* Loading */
+[data-button][data-loading] {
+  pointer-events: none;
+  position: relative;
+}
+
+/* Icon-only */
+[data-button][data-icon-only] {
+  aspect-ratio: 1;
+  padding: 0;
+}
+
+[data-button][data-icon-only] [data-item-text] {
+  display: none;
+}
+
+/* =============================================================================
+   Size Variants
+   ============================================================================= */
+
+/* Small */
+[data-button][data-size='sm'] {
+  height: var(--control-h-sm);
+  padding-inline: 0.625rem;
+  font-size: 0.75rem;
+  gap: 0.375rem;
+}
+
+[data-button][data-size='sm'][data-icon-only] {
+  width: var(--control-h-sm);
+}
+
+[data-button][data-size='sm'] [data-item-icon],
+[data-button][data-size='sm'] [data-button-icon-right] {
+  font-size: 1.25rem;
+}
+
+/* Medium (default) — responds to density */
+[data-button][data-size='md'],
+[data-button]:not([data-size]) {
+  height: var(--control-h-md);
+  padding-inline: var(--density-spacing-lg);
+  font-size: 0.875rem;
+  gap: var(--density-spacing-sm);
+}
+
+[data-button][data-size='md'][data-icon-only],
+[data-button]:not([data-size])[data-icon-only] {
+  width: var(--control-h-md);
+}
+
+[data-button][data-size='md'] [data-item-icon],
+[data-button][data-size='md'] [data-button-icon-right],
+[data-button]:not([data-size]) [data-item-icon],
+[data-button]:not([data-size]) [data-button-icon-right] {
+  font-size: var(--density-icon-size);
+}
+
+/* Large */
+[data-button][data-size='lg'] {
+  height: var(--control-h-lg);
+  padding-inline: 1.5rem;
+  font-size: 1rem;
+  gap: 0.625rem;
+}
+
+[data-button][data-size='lg'][data-icon-only] {
+  width: var(--control-h-lg);
+}
+
+[data-button][data-size='lg'] [data-item-icon],
+[data-button][data-size='lg'] [data-button-icon-right] {
+  font-size: 1.875rem;
+}
+
+/* =============================================================================
+   Button Elements
+   ============================================================================= */
+
+[data-button] [data-item-icon],
+[data-button] [data-button-icon-right] {
+  flex-shrink: 0;
+}
+
+[data-button] [data-item-text] {
+  display: inline-flex;
+  align-items: center;
+}
+
+/* Hide description and badge inside buttons (ItemContent renders them but we don't need them) */
+[data-button] [data-item-description],
+[data-button] [data-item-badge] {
+  display: none;
+}
+
+/* =============================================================================
+   Gradient Style — Structural
+   ============================================================================= */
+
+[data-button][data-style='gradient'] {
+  border: none;
+}
+
+/* =============================================================================
+   Link Style — Structural
+   ============================================================================= */
+
+[data-button][data-style='link'] {
+  background: transparent;
+  border: none;
+  height: auto;
+  padding-inline: 0.25rem;
+  border-radius: 0;
+  font-weight: inherit;
+}
+
+[data-button][data-style='link']:hover:not(:disabled):not([data-disabled]) {
+  text-decoration: underline;
+  text-underline-offset: 2px;
+}
+
+/* =============================================================================
+   Micro-Animations
+   ============================================================================= */
+
+/* Hover lift — subtle elevation on hover (not on link or ghost style) */
+[data-button]:not([data-style='link']):not([data-style='ghost']):hover:not(:disabled):not(
+    [data-disabled]
+  ) {
+  transform: translateY(-1px);
+}
+
+/* Press feedback — scale down on active */
+[data-button]:active:not(:disabled):not([data-disabled]) {
+  transform: scale(0.97) translateY(0);
+}
+
+/* Icon shift — trailing icon moves right on hover */
+[data-button]:hover:not(:disabled):not([data-disabled]) [data-button-icon-right] {
+  translate: 0.125rem 0;
+}
+
+[data-button] [data-button-icon-right] {
+  transition: translate 150ms ease;
+}
+
+/* Loading pulse */
+[data-button][data-loading] {
+  animation: button-loading-pulse 1.5s ease-in-out infinite;
+}
+
+@keyframes button-loading-pulse {
+  0%,
+  100% {
+    opacity: 1;
+  }
+  50% {
+    opacity: 0.7;
+  }
+}
+
+/* =============================================================================
+   Loading Spinner
+   ============================================================================= */
+
+[data-button-spinner] {
+  width: 1em;
+  height: 1em;
+  border: 2px solid currentColor;
+  border-right-color: transparent;
+  border-radius: 50%;
+  animation: button-spin 0.6s linear infinite;
+  flex-shrink: 0;
+}
+
+@keyframes button-spin {
+  to {
+    transform: rotate(360deg);
+  }
+}
+
+/* =============================================================================
+   Button Group
+   ============================================================================= */
+
+[data-button-group] {
+  display: inline-flex;
+  align-items: center;
+}
+
+[data-button-group] [data-button] {
+  border-radius: 0;
+}
+
+[data-button-group] [data-button]:first-child {
+  border-top-left-radius: 0.5rem;
+  border-bottom-left-radius: 0.5rem;
+}
+
+[data-button-group] [data-button]:last-child {
+  border-top-right-radius: 0.5rem;
+  border-bottom-right-radius: 0.5rem;
+}
+
+[data-button-group] [data-button]:not(:first-child) {
+  margin-left: -1px;
+}

package/dist/base/card.css

@@ -0,0 +1,39 @@
+/* Card — base structural styles */
+
+[data-card] {
+  display: flex;
+  flex-direction: column;
+  border-radius: var(--density-radius-base);
+  overflow: hidden;
+  text-decoration: none;
+  color: inherit;
+}
+
+button[data-card] {
+  background: none;
+  border: none;
+  cursor: pointer;
+  text-align: inherit;
+  font: inherit;
+  padding: 0;
+}
+
+a[data-card] {
+  cursor: pointer;
+}
+
+[data-card-header] {
+  padding-block: var(--density-spacing-md) var(--density-spacing-sm);
+  padding-inline: var(--density-spacing-lg);
+}
+
+[data-card-body] {
+  padding-block: var(--density-spacing-sm);
+  padding-inline: var(--density-spacing-lg);
+  flex: 1;
+}
+
+[data-card-footer] {
+  padding-block: var(--density-spacing-sm) var(--density-spacing-md);
+  padding-inline: var(--density-spacing-lg);
+}