@santi020k/lumen-astro 0.1.0 → 0.2.0

package/README.md

@@ -21,6 +21,7 @@ enhances all matching Lumen markup on the page.
 With Tailwind, keep the Lumen import in the same shared CSS entry:
 
 ```css
+@import "@santi020k/lumen-astro/layers.css";
 @import "tailwindcss";
 @import "@santi020k/lumen-astro/styles.css";
 ```
@@ -60,6 +61,10 @@ import { Button, Icon } from '@santi020k/lumen-astro'
 <Icon name="search" label="Search" />
 ```
 
+Lucide intentionally excludes brand marks. For GitHub and other project-specific icons, put the
+SVG in the default slot instead of passing an unsupported `name`; Astro warns about unknown named
+icons during development.
+
 ## Optimized images
 
 Lumen's Astro `Image` delegates to `astro:assets`, so imported image metadata, responsive layouts,

package/components/Accordion.astro

@@ -3,24 +3,30 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 
 import type { HTMLAttributes } from 'astro/types'
 
+type AccordionVariant = 'default' | 'flush'
+
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
+  variant?: AccordionVariant
 }
 
 const {
   class: classProp = '',
   className = '',
+  variant = 'default',
   ...rest
 } = Astro.props
 
 const { classList, passthrough } = resolveLumenAstroProps(rest, [
-    'ui-accordion'
+    'ui-accordion',
+    variant === 'flush' && 'ui-accordion--flush'
 ], classProp, className)
 ---
 
 <div
   class:list={classList}
+  data-variant={variant}
   {...passthrough}
 >
   <slot />

package/components/Affix.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   offset?: number
   offsetBottom?: number

package/components/Agenda.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'section'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
 }

package/components/Alert.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'aside'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   variant?: 'default' | 'destructive' | 'success' | 'warning'

package/components/AlertDialog.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'dialog'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   /**

package/components/Anchor.astro

@@ -6,7 +6,7 @@ import type { HTMLAttributes } from 'astro/types'
 type AnchorLink = { href: string; label: string }
 
 export interface Props extends HTMLAttributes<'nav'> {
-  class?: string
+  class?: string | null
   className?: string
   items?: AnchorLink[]
 }

package/components/AnimatedLogo.astro

@@ -4,7 +4,7 @@ import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'span'> {
   animation?: 'reveal' | 'sequence'
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/AnimatedNumber.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends Omit<HTMLAttributes<'span'>, 'prefix'> {
-  class?: string
+  class?: string | null
   className?: string
   decimals?: number
   duration?: 'fast' | 'standard' | 'slow'

package/components/AnimatedPortrait.astro

@@ -17,7 +17,7 @@ interface Props extends HTMLAttributes<'div'> {
       text: string
     }
   }
-  class?: string
+  class?: string | null
   className?: string
   showFloatingBadges?: boolean
   sizes?: string

package/components/AspectRatio.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   ratio?: number | string
 }

package/components/Attachment.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'article'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   href?: string

package/components/Autocomplete.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'input'> {
-  class?: string
+  class?: string | null
   className?: string
   list: string
 }

package/components/Avatar.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'span'> {
-  class?: string
+  class?: string | null
   className?: string
   alt?: string
   fallback?: string

package/components/BackToTop.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'button'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Badge.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'span'> {
-  class?: string
+  class?: string | null
   className?: string
   variant?: 'default' | 'secondary' | 'outline' | 'destructive' | 'success' | 'warning'
 }

package/components/Breadcrumb.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'nav'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Bubble.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'article'> {
-  class?: string
+  class?: string | null
   className?: string
   from?: 'user' | 'assistant'
   glass?: boolean | 'subtle' | 'strong'

package/components/Button.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'button'> {
-  class?: string
+  class?: string | null
   className?: string
   loading?: boolean
   size?: 'default' | 'sm' | 'lg' | 'icon'

package/components/ButtonGroup.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/ButtonLink.astro

@@ -6,13 +6,13 @@ import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'a'> {
   ariaLabel?: string
-  class?: string
+  class?: string | null
   className?: string
   href: string
   newTab?: boolean
   shape?: 'default' | 'icon'
   showArrow?: boolean
-  variant?: 'ghost' | 'inline' | 'primary' | 'secondary'
+  variant?: 'ghost' | 'inline' | 'primary' | 'secondary' | 'unstyled'
 }
 
 const {
@@ -29,12 +29,13 @@ const {
 
 const { classList, passthrough } = resolveLumenAstroProps(rest, [
   'ui-button-link',
-  'group inline-flex cursor-pointer items-center justify-center gap-2 text-sm font-semibold tracking-[0.01em]',
-  variant !== 'inline' && 'min-h-11 rounded-full border',
+  variant !== 'unstyled' && 'group inline-flex cursor-pointer items-center justify-center gap-2 text-sm font-semibold tracking-[0.01em]',
+  variant !== 'inline' && variant !== 'unstyled' && 'min-h-11 rounded-full border',
   variant === 'primary' && 'ui-button ui-button--primary',
   variant === 'secondary' && 'ui-button ui-button--secondary',
   variant === 'ghost' && 'ui-button ui-button--ghost',
   variant === 'inline' && 'ui-button ui-button--inline',
+  variant === 'unstyled' && 'ui-button-link--unstyled',
   shape === 'icon' && variant !== 'inline' && 'ui-button-link--icon'
 ], classProp, className)
 ---

package/components/Calendar.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends Omit<HTMLAttributes<'div'>, 'value'> {
-  class?: string
+  class?: string | null
   className?: string
   disabled?: boolean
   glass?: boolean | 'subtle' | 'strong'

package/components/Callout.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'aside'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Card.astro

@@ -5,10 +5,10 @@ import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
   as?: 'article' | 'div' | 'section'
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
-  variant?: 'default' | 'glass' | 'interactive' | 'muted'
+  variant?: 'default' | 'glass' | 'interactive' | 'muted' | 'unstyled'
 }
 
 const {
@@ -23,6 +23,7 @@ const {
 const isGlass = glass || variant === 'glass'
 const { classList, passthrough } = resolveLumenAstroProps(rest, [
     'ui-card',
+    variant === 'unstyled' && 'ui-card--unstyled',
     variant === 'muted' && 'ui-card--muted',
     variant === 'interactive' && 'ui-card--interactive',
     isGlass && 'ui-card--glass',

package/components/Carousel.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'section'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
 }

package/components/Cascader.astro

@@ -10,7 +10,7 @@ interface CascaderOption {
 }
 
 export interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   name?: string
   options?: CascaderOption[]

package/components/Chart.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'figure'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
 }

package/components/Checkbox.astro

@@ -6,7 +6,7 @@ import type { HTMLAttributes } from 'astro/types'
 type HTMLInputAttributes = HTMLAttributes<'input'>
 
 interface Props extends Omit<HTMLInputAttributes, 'type'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Code.astro

@@ -7,7 +7,7 @@ type CodeTheme = 'auto' | 'lumen' | 'santi020k'
 type CodeVariant = 'block' | 'inline'
 
 interface Props extends HTMLAttributes<'code'> {
-  class?: string
+  class?: string | null
   className?: string
   code?: string
   copy?: boolean
@@ -16,6 +16,7 @@ interface Props extends HTMLAttributes<'code'> {
   language?: string
   theme?: CodeTheme
   variant?: CodeVariant
+  wrap?: boolean
 }
 
 const {
@@ -28,12 +29,14 @@ const {
   language,
   theme = 'auto',
   variant = 'inline',
+  wrap = false,
   ...rest
 } = Astro.props
 
 const { classList: blockClassList, passthrough } = resolveLumenAstroProps(rest, [
   'ui-code',
-  'ui-code--block'
+  'ui-code--block',
+  wrap && 'ui-code--wrap'
 ], classProp, className)
 const { classList: inlineClassList } = resolveLumenAstroProps(rest, [
   'ui-code',

package/components/Collapsible.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'details'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/ColorPicker.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'input'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Combobox.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'input'> {
-  class?: string
+  class?: string | null
   className?: string
   label?: string
   list: string

package/components/Command.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
 }

package/components/ContextMenu.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'menu'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   /**

package/components/CoverImage.astro

@@ -8,7 +8,7 @@ import type { HTMLAttributes } from 'astro/types'
 interface Props extends HTMLAttributes<'div'> {
   alt: string
   ariaHidden?: boolean
-  class?: string
+  class?: string | null
   className?: string
   featured?: boolean
   featuredMinHeightClass?: string

package/components/DataTable.astro

@@ -30,7 +30,7 @@ type DataTableRow = Record<string, DataTableCell> & {
 }
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   columns?: DataTableColumn[]
   glass?: boolean | 'subtle' | 'strong'

package/components/DatePicker.astro

@@ -5,7 +5,7 @@ import Calendar from './Calendar.astro'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'input'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   placeholder?: string

package/components/DateRangePicker.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Descriptions.astro

@@ -6,7 +6,7 @@ import type { HTMLAttributes } from 'astro/types'
 type DescriptionItem = { label: string; value: string }
 
 interface Props extends HTMLAttributes<'dl'> {
-  class?: string
+  class?: string | null
   className?: string
   columns?: number
   items?: DescriptionItem[]

package/components/Dialog.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'dialog'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   /**

package/components/Direction.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   dir?: 'ltr' | 'rtl' | 'auto'
 }

package/components/Drawer.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'dialog'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   /**

package/components/DropdownMenu.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   /**

package/components/Empty.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'section'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
 }

package/components/Eyebrow.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'p'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/Field.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
   controlId?: string
   describedBy?: string

package/components/FileUpload.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends Omit<HTMLAttributes<'input'>, 'type' | 'size'> {
-  class?: string
+  class?: string | null
   className?: string
   label?: string
   hint?: string

package/components/FloatingBadge.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'span'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/FormattedDate.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'time'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/GradientDivider.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps } from '@santi020k/lumen-core'
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'div'> {
-  class?: string
+  class?: string | null
   className?: string
 }
 

package/components/HoverCard.astro

@@ -4,7 +4,7 @@ import { resolveLumenAstroProps, resolveLumenGlass } from '@santi020k/lumen-core
 import type { HTMLAttributes } from 'astro/types'
 
 interface Props extends HTMLAttributes<'aside'> {
-  class?: string
+  class?: string | null
   className?: string
   glass?: boolean | 'subtle' | 'strong'
   /**

package/components/Icon.astro

@@ -10,7 +10,7 @@ import type { HTMLAttributes } from 'astro/types'
 type IconSize = 'default' | 'lg' | 'sm' | 'xl'
 
 interface Props extends HTMLAttributes<'span'> {
-  class?: string
+  class?: string | null
   className?: string
   decorative?: boolean
   label?: string
@@ -31,6 +31,10 @@ const {
 const isDecorative = decorative ?? !label
 const iconSvg = name ? renderLumenIconSvg(name) : ''
 
+if (name && !iconSvg && import.meta.env.DEV) {
+  console.warn(`[Lumen Icon] Unknown Lucide icon "${name}". Use the default slot for brand or project-specific SVGs.`)
+}
+
 const { classList, passthrough } = resolveLumenAstroProps(rest, [
   'ui-icon',
   size === 'sm' && 'ui-icon--sm',

package/components/Image.astro

@@ -7,7 +7,7 @@ import {
 } from 'astro:assets'
 
 type Props = (LocalImageProps | RemoteImageProps) & {
-  class?: string
+  class?: string | null
   className?: string
   invertOnDark?: boolean
 }