@signal9/era-ui 32.0.0 → 33.0.0

package/dist/generated-docs/calendar.md

@@ -1,126 +0,0 @@
-# Calendar
-
-A date picker calendar grid.
-
-## Import
-
-```ts
-import * as Calendar from "@signal9/era-ui/calendar";
-```
-
-Composed from sub-components — compose explicitly at the call site:
-
-- `Calendar.Root`
-- `Calendar.Header`
-- `Calendar.Heading`
-- `Calendar.PrevButton`
-- `Calendar.NextButton`
-- `Calendar.Grid`
-- `Calendar.GridHead`
-- `Calendar.GridBody`
-- `Calendar.GridRow`
-- `Calendar.HeadCell`
-- `Calendar.Cell`
-- `Calendar.Day`
-
-## Calendar.Root
-
-Inherits all props from `Calendar.RootProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-| `value?` | `(forwarded)` | — | bindable |
-| `placeholder?` | `(forwarded)` | — | bindable |
-
-## Calendar.Header
-
-Inherits all props from `Calendar.HeaderProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.Heading
-
-Inherits all props from `Calendar.HeadingProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.PrevButton
-
-Inherits all props from `WithoutChildrenOrChild<Calendar.PrevButtonProps>`.
-Inherits all props from `Pick<ButtonVariants, 'tone' | 'size'>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `children?` | `Snippet` | — | — |
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.NextButton
-
-Inherits all props from `WithoutChildrenOrChild<Calendar.NextButtonProps>`.
-Inherits all props from `Pick<ButtonVariants, 'tone' | 'size'>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `children?` | `Snippet` | — | — |
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.Grid
-
-Inherits all props from `Calendar.GridProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.GridHead
-
-Inherits all props from `Calendar.GridHeadProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.GridBody
-
-Inherits all props from `Calendar.GridBodyProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.GridRow
-
-Inherits all props from `Calendar.GridRowProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.HeadCell
-
-Inherits all props from `Calendar.HeadCellProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.Cell
-
-Inherits all props from `Calendar.CellProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Calendar.Day
-
-Inherits all props from `Calendar.DayProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |

package/dist/generated-docs/card.md

@@ -1,58 +0,0 @@
-# Card
-
-A surface container that can behave as a link or button.
-
-## Import
-
-```ts
-import { Card } from "@signal9/era-ui/card";
-```
-
-## Props
-
-Inherits all props from `HTMLAttributes<HTMLElement>`.
-Inherits all props from `AnchorBits`.
-Inherits all props from `ButtonBits`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `CardElement \| null` | `null` | bindable |
-| `tone?` | `'elevated' \| 'surface' \| 'well' \| 'flat'` | `'elevated'` | Surface tier the card paints on.
-- `elevated` (default): the lifted surface, with a resting shadow. Use
-  on the page background.
-- `surface`: the base surface tier, no shadow. Use when nesting cards
-  inside another elevated container.
-- `well`: recessed. For content the surrounding UI puts INTO the card —
-  a tool's output pane, a transcript body — the container twin of a
-  text field's fill.
-- `flat`: no background; only the rounded/padded shell. For grouping
-  content visually without adding contrast.
-READ THE CLASSES AND THEY LOOK SWAPPED. They are not, and this is
-worth a sentence because a consumer read them, believed it, and
-shipped flat cards for months. `surface` paints `bg-well` and `well`
-paints `bg-field`, because era's utility names describe FILLS rather
-than tiers: `bg-well` is the surface's own resting fill (it is what a
-panel is painted with, and it pairs with `shadow-well` when you want
-recessed chrome), and `bg-field` is the recessed fill a text input
-sits in. The tone names are the tiers; the class names are the paints.
-A CARD THAT IS PRESSABLE SHOULD USUALLY BE `elevated`. Passing `href`
-or `onclick` turns on the interactive face — hover, focus, press — but
-it deliberately does NOT override the tier you asked for, so a
-`surface` link card does not get the raised tier's separation and can
-read flatter than the static cards around it. That combination was
-reported as a bug and it is a choice: a tone that silently changed
-under an event handler would be a worse one.
-HOW THE TIERS DIFFER IS SURFACE-DEPENDENT, so do not go looking for a
-fill difference on every surface. `base` mixes the elevated fill 6%
-toward `--color-bright` and adds a resting shadow, so there the tiers
-differ in COLOUR. `bevel` sets `--era-surface-bg-elevated` to
-`--era-surface-bg` outright — elevation is a chisel, not a tone, which
-is bevel's whole premise — so `surface` and `elevated` paint the
-IDENTICAL fill there and differ only in relief. A consumer measured
-exactly that on 30.8.0 bevel: both tones `oklch(0.195 0 none)` in dark,
-`0.863` in light, one variable, side by side. `glass` splits the tiers
-its own way again. So the tier is real on every surface; the thing
-carrying it is not always the fill. |
-| `header?` | `Snippet` | — | Rendered above the body with a subtle divider. |
-| `footer?` | `Snippet` | — | Rendered below the body with a subtle divider. |
-| `children?` | `Snippet` | — | — |

package/dist/generated-docs/checkbox.md

@@ -1,42 +0,0 @@
-# Checkbox
-
-Toggleable check with indeterminate support.
-
-## Import
-
-```ts
-import * as Checkbox from "@signal9/era-ui/checkbox";
-```
-
-Composed from sub-components — compose explicitly at the call site:
-
-- `Checkbox.Root`
-- `Checkbox.Group`
-- `Checkbox.GroupLabel`
-
-## Checkbox.Root
-
-Inherits all props from `Checkbox.RootProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-| `checked?` | `(forwarded)` | `false` | bindable |
-| `indeterminate?` | `(forwarded)` | `false` | bindable |
-
-## Checkbox.Group
-
-Inherits all props from `Checkbox.GroupProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-| `value?` | `(forwarded)` | `[]` | bindable |
-
-## Checkbox.GroupLabel
-
-Inherits all props from `Checkbox.GroupLabelProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |

package/dist/generated-docs/chip.md

@@ -1,61 +0,0 @@
-# Chip
-
-An interactive, optionally dismissible token.
-
-## Import
-
-```ts
-import { Chip } from "@signal9/era-ui/chip";
-```
-
-## Props
-
-Inherits all props from `HTMLAttributes<HTMLDivElement>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `HTMLDivElement \| null` | `null` | bindable |
-| `size?` | `'chip' \| 'pill'` | `'chip'` | `sm` (default) is the standalone free chip; `pill` is the smaller pill
-that nests inside an md container (a select trigger, a button). |
-| `ondismiss?` | `() => void` | — | — |
-| `dismissAs?` | `'button' \| 'span'` | `'button'` | What the dismiss control RENDERS AS. `button` (the default) is right
-for a free-standing chip. Use `span` when the chip lives inside
-another control.
-A <button> inside a <button> is not merely bad manners: it is invalid,
-and the HTML parser repairs it by CLOSING the outer control before the
-inner one. So the server's markup and the client's DOM disagree, Svelte
-discards the page's hydration and re-renders from scratch, and the
-chips briefly sit outside the trigger they belong to. era's own
-multi-select shipped exactly that (a Chip with `ondismiss` inside
-Select.Trigger) and logged node_invalid_placement_ssr on every load.
-`span` also drops the control from the accessibility tree rather than
-announcing a button inside a button — which is the honest description
-of what it is there: a pointer shortcut. The accessible way to remove
-a selection is the listbox itself, which is unaffected. Keyboard focus
-order is unchanged, because a nested button was never reachable in a
-sensible order anyway. |
-| `lead?` | `Snippet` | — | Icon rendered BEFORE the label, outside it. Use this rather than putting
-an icon in `children`: the label then gets its own box, which is the only
-place era's ink centring can reach. |
-| `children?` | `Snippet` | — | — |
-
-## Usage
-
-```svelte
-<script>
-	import { Chip } from '@signal9/era-ui/chip';
-
-	let tags = $state(['alpha', 'beta', 'gamma']);
-</script>
-
-{#each tags as tag}
-	<Chip ondismiss={() => (tags = tags.filter((t) => t !== tag))}>
-		{tag}
-	</Chip>
-{/each}
-```
-
-## Notes
-
-- Internal pointerdown/up events on the dismiss button are stopped from bubbling — this prevents accidental toggling when a Chip is nested inside a Select/Popover trigger.
-- Uses the `xxs` tier tokens (height, radius, inset). Part of the Badge/Chip/KV "tag" family.

package/dist/generated-docs/code-block.md

@@ -1,20 +0,0 @@
-# Code Block
-
-A code snippet with optional copy button.
-
-## Import
-
-```ts
-import { CodeBlock } from "@signal9/era-ui/code-block";
-```
-
-## Props
-
-Inherits all props from `HTMLAttributes<HTMLDivElement>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `HTMLDivElement \| null` | `null` | bindable |
-| `code?` | `string` | — | — |
-| `copyable?` | `boolean` | `true` | — |
-| `children?` | `Snippet` | — | — |

package/dist/generated-docs/collapsible.md

@@ -1,30 +0,0 @@
-# Collapsible
-
-Show and hide content sections with a trigger.
-
-## Import
-
-```ts
-import * as Collapsible from "@signal9/era-ui/collapsible";
-```
-
-Composed from sub-components — compose explicitly at the call site:
-
-- `Collapsible.Trigger`
-- `Collapsible.Content`
-
-## Collapsible.Trigger
-
-Inherits all props from `PartProps<Collapsible.TriggerProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Collapsible.Content
-
-Inherits all props from `PartProps<Collapsible.ContentProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |

package/dist/generated-docs/combobox.md

@@ -1,74 +0,0 @@
-# Combobox
-
-Search and select from a filtered list of options.
-
-## Import
-
-```ts
-import * as Combobox from "@signal9/era-ui/combobox";
-```
-
-Composed from sub-components — compose explicitly at the call site:
-
-- `Combobox.Input`
-- `Combobox.Trigger`
-- `Combobox.Content`
-- `Combobox.Item`
-- `Combobox.Empty`
-- `Combobox.Group`
-- `Combobox.GroupHeading`
-
-## Combobox.Input
-
-Inherits all props from `Combobox.InputProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Combobox.Trigger
-
-Inherits all props from `OwnedPartProps<Combobox.TriggerProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Combobox.Content
-
-Inherits all props from `PartProps<Combobox.ContentProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Combobox.Item
-
-Inherits all props from `Combobox.ItemProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Combobox.Empty
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `children?` | `Snippet` | — | — |
-| `class?` | `string` | — | — |
-
-## Combobox.Group
-
-Inherits all props from `Combobox.GroupProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Combobox.GroupHeading
-
-Inherits all props from `PartProps<Combobox.GroupHeadingProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |

package/dist/generated-docs/command-bar.md

@@ -1,3 +0,0 @@
-# Command Bar
-
-Terminal-style prompt with ghost completion and drill-in views.

package/dist/generated-docs/command.md

@@ -1,126 +0,0 @@
-# Command
-
-A searchable command menu for quick navigation.
-
-## Import
-
-```ts
-import * as Command from "@signal9/era-ui/command";
-```
-
-Composed from sub-components — compose explicitly at the call site:
-
-- `Command.Root`
-- `Command.Input`
-- `Command.List`
-- `Command.Viewport`
-- `Command.Empty`
-- `Command.Loading`
-- `Command.Group`
-- `Command.GroupHeading`
-- `Command.GroupItems`
-- `Command.Item`
-- `Command.LinkItem`
-- `Command.Separator`
-
-## Command.Root
-
-Inherits all props from `Command.RootProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `bare?` | `boolean` | `false` | Drop the floating-panel chrome (border, bg, padding, shadow) for
- embedding inside a surface that already provides it — a pane body, a
- sidebar. The host's own padding is then the only edge inset. |
-| `ref?` | `(forwarded)` | `null` | bindable |
-| `value?` | `(forwarded)` | `''` | bindable |
-
-## Command.Input
-
-Inherits all props from `Command.InputProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `icon?` | `Component<IconProps> \| null` | `null` | Lucide icon rendered inside the field, left of the text (e.g. a search glyph). |
-| `ref?` | `(forwarded)` | `null` | bindable |
-| `value?` | `(forwarded)` | `''` | bindable |
-
-## Command.List
-
-Inherits all props from `Command.ListProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.Viewport
-
-Inherits all props from `Command.ViewportProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.Empty
-
-Inherits all props from `Command.EmptyProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.Loading
-
-Inherits all props from `Command.LoadingProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.Group
-
-Inherits all props from `Command.GroupProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.GroupHeading
-
-Inherits all props from `Command.GroupHeadingProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.GroupItems
-
-Inherits all props from `Command.GroupItemsProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.Item
-
-Inherits all props from `Command.ItemProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.LinkItem
-
-Inherits all props from `Command.LinkItemProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## Command.Separator
-
-Inherits all props from `Command.SeparatorProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |

package/dist/generated-docs/context-menu.md

@@ -1,104 +0,0 @@
-# Context Menu
-
-Options and actions triggered by right-click.
-
-## Import
-
-```ts
-import * as ContextMenu from "@signal9/era-ui/context-menu";
-```
-
-Composed from sub-components — compose explicitly at the call site:
-
-- `ContextMenu.Root`
-- `ContextMenu.Trigger`
-- `ContextMenu.Content`
-- `ContextMenu.Item`
-- `ContextMenu.CheckboxItem`
-- `ContextMenu.RadioItem`
-- `ContextMenu.Separator`
-- `ContextMenu.SubTrigger`
-- `ContextMenu.SubContent`
-- `ContextMenu.GroupHeading`
-
-## ContextMenu.Root
-
-Inherits all props from `ContextMenu.RootProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `children?` | `Snippet` | — | — |
-| `open?` | `(forwarded)` | `false` | bindable |
-
-## ContextMenu.Trigger
-
-Inherits all props from `ContextMenu.TriggerProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.Content
-
-Inherits all props from `OwnedPartProps<ContextMenu.ContentProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.Item
-
-Inherits all props from `PartProps<ContextMenu.ItemProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.CheckboxItem
-
-Inherits all props from `ContextMenu.CheckboxItemProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-| `checked?` | `(forwarded)` | `false` | bindable |
-
-## ContextMenu.RadioItem
-
-Inherits all props from `ContextMenu.RadioItemProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.Separator
-
-Inherits all props from `ContextMenu.SeparatorProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.SubTrigger
-
-Inherits all props from `OwnedPartProps<ContextMenu.SubTriggerProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.SubContent
-
-Inherits all props from `OwnedPartProps<ContextMenu.SubContentProps>`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |
-
-## ContextMenu.GroupHeading
-
-Inherits all props from `ContextMenu.GroupHeadingProps`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `(forwarded)` | `null` | bindable |

package/dist/generated-docs/copy-button.md

@@ -1,29 +0,0 @@
-# Copy Button
-
-An icon button that copies text and cross-fades to a result glyph.
-
-## Import
-
-```ts
-import { CopyButton } from "@signal9/era-ui/copy-button";
-```
-
-## Props
-
-Inherits all props from `Omit<HTMLButtonAttributes, 'onclick' | 'children'>`.
-Inherits all props from `ButtonVariants`.
-
-| Prop | Type | Default | Notes |
-|------|------|---------|-------|
-| `ref?` | `HTMLElement \| null` | `null` | bindable |
-| `text` | `string \| (() => string)` | — | The string written to the clipboard. Pass a function when the value
-is only knowable at click time (e.g. text read out of the DOM) — it
-is resolved on each click, not at render. |
-| `onCopy?` | `(status: 'success' \| 'failure') => void` | — | Fires after the write settles, with the outcome. |
-| `resetDelay?` | `number` | `1500` | How long the result icon holds before falling back to idle. |
-| `label?` | `string` | `'Copy'` | Accessible name in the idle and failure states. |
-| `copiedLabel?` | `string` | `'Copied'` | Accessible name while the success icon is showing. |
-| `idleIcon?` | `Component<IconProps>` | `Copy` | Idle-state glyph (the "copy" affordance). Swap to match a host
-icon set — any component taking lucide's IconProps fits. |
-| `successIcon?` | `Component<IconProps>` | `Check` | Glyph shown after a successful write. |
-| `failureIcon?` | `Component<IconProps>` | `X` | Glyph shown after a failed write. |