@bysages/svelte 0.4.4 → 0.5.0

package/dist/{index-3TmqYBnT.d.mts → index-DcMmNDU-.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/data-view/props.d.ts
 interface DataViewProps extends HTMLAttributes<HTMLDivElement> {
   items: unknown[];
   /** Ledger rows or a lattice of cards. */
@@ -11,12 +10,9 @@ interface DataViewProps extends HTMLAttributes<HTMLDivElement> {
   renderItem?: Snippet<[unknown, number]>;
   header?: Snippet;
 }
-//#endregion
-//#region src/components/data-view/index.d.ts
 /** One vessel, two layouts: a ledger or a lattice, paged with the
  * pagination family's own parts. */
 declare const DataView: import("svelte").Component<DataViewProps, {}, ""> & {
   Root: import("svelte").Component<DataViewProps, {}, "">;
 };
-//#endregion
 export { DataViewProps as n, DataView as t };

package/dist/{index-DH0ecZNW.d.mts → index-DdgeN0Ng.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/alert/props.d.ts
 type AlertStatus = "ink" | "info" | "success" | "warning" | "danger";
 interface AlertProps extends HTMLAttributes<HTMLDivElement> {
   status?: AlertStatus;
@@ -9,8 +8,6 @@ interface AlertProps extends HTMLAttributes<HTMLDivElement> {
 interface AlertPartProps extends HTMLAttributes<HTMLElement> {
   children?: Snippet;
 }
-//#endregion
-//#region src/components/alert/index.d.ts
 /** A notice drawn on the page: a wash of the status pigment, one heavier
  * hairline on the leading edge, the serif for its title. Root, Icon,
  * Body, Title, Description — the icon reads the status from the Root. */
@@ -21,5 +18,4 @@ declare const Alert: import("svelte").Component<AlertProps, {}, ""> & {
   Title: import("svelte").Component<AlertPartProps, {}, "">;
   Description: import("svelte").Component<AlertPartProps, {}, "">;
 };
-//#endregion
 export { AlertStatus as i, AlertPartProps as n, AlertProps as r, Alert as t };

package/dist/{index-CKaCfx0p.d.mts → index-Di2WJqT-.d.mts}

@@ -1,17 +1,13 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/ellipsis/props.d.ts
 interface EllipsisProps extends HTMLAttributes<HTMLSpanElement> {
   lines?: number;
   children?: Snippet;
 }
-//#endregion
-//#region src/components/ellipsis/index.d.ts
 /** The overflow knife: text cut at one line, or held to N lines. The
  * primitive only draws the cut — reaching the full text (title,
  * tooltip) stays the consumer's decision. */
 declare const Ellipsis: import("svelte").Component<EllipsisProps, {}, ""> & {
   Root: import("svelte").Component<EllipsisProps, {}, "">;
 };
-//#endregion
 export { EllipsisProps as n, Ellipsis as t };

package/dist/{index-DCpx_Rui.d.mts → index-DjdtGK_P.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLButtonAttributes } from "svelte/elements";
-//#region src/components/button/props.d.ts
 interface ButtonProps extends HTMLButtonAttributes {
   variant?: "solid" | "outline" | "ghost" | "subtle";
   tone?: "ink" | "info" | "success" | "warning" | "danger";
@@ -12,13 +11,10 @@ interface ButtonProps extends HTMLButtonAttributes {
   as?: string;
   children?: Snippet;
 }
-//#endregion
-//#region src/components/button/index.d.ts
 /** The control recipe as a standalone button: the variant chooses how it
  * rests, the tone chooses the pigment. Ink is the solemn default; any
  * action can carry the primary weight. */
 declare const Button: import("svelte").Component<ButtonProps, {}, ""> & {
   Root: import("svelte").Component<ButtonProps, {}, "">;
 };
-//#endregion
 export { ButtonProps as n, Button as t };

package/dist/{index-BpC1s3zv.d.mts → index-DlHC7607.d.mts}

@@ -1,7 +1,6 @@
-import { i as DescriptionsDetail, n as DescriptionsTerm, r as DescriptionsItem, t as Descriptions$1 } from "./Descriptions-C1qZ05Ph.mjs";
+import { i as DescriptionsDetail, n as DescriptionsTerm, r as DescriptionsItem, t as Descriptions$1 } from "./Descriptions-DQ-53bH0.mjs";
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/descriptions/props.d.ts
 /** Simple term/detail records for the callable facade. */
 interface DescriptionsItemData {
   term: string;
@@ -23,8 +22,6 @@ interface DescriptionsRootProps extends HTMLAttributes<HTMLDListElement> {
 interface DescriptionsPartProps extends HTMLAttributes<HTMLElement> {
   children?: Snippet;
 }
-//#endregion
-//#region src/components/descriptions/index.d.ts
 /** A ledger laid flat: term and detail pairs in one quiet grid. The
  * horizontal layout reads as a table of two columns; the vertical one
  * stacks each pair for narrow measures. */
@@ -34,5 +31,4 @@ declare const Descriptions: typeof Descriptions$1 & {
   Term: typeof DescriptionsTerm;
   Detail: typeof DescriptionsDetail;
 };
-//#endregion
 export { DescriptionsPartProps as n, DescriptionsRootProps as r, Descriptions as t };

package/dist/{index-CyVykdGO.d.mts → index-DrhjTobH.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/grid/props.d.ts
 interface GridProps extends HTMLAttributes<HTMLDivElement> {
   columns?: number;
   gap?: "none" | "xs" | "sm" | "md" | "lg" | "xl";
@@ -9,12 +8,9 @@ interface GridProps extends HTMLAttributes<HTMLDivElement> {
   minChildWidth?: string;
   children?: Snippet;
 }
-//#endregion
-//#region src/components/grid/index.d.ts
 /** An alignment lattice: tracks of equal measure, sized by column count
  * — or, with `minChildWidth`, as many tracks as the container fits. */
 declare const Grid: import("svelte").Component<GridProps, {}, ""> & {
   Root: import("svelte").Component<GridProps, {}, "">;
 };
-//#endregion
 export { GridProps as n, Grid as t };

package/dist/{index-DKfQGayE.d.mts → index-Dti8xErb.d.mts}

@@ -1,19 +1,15 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/input-group/props.d.ts
 interface InputGroupProps extends HTMLAttributes<HTMLDivElement> {
   children?: Snippet;
 }
 interface InputGroupAddonProps extends HTMLAttributes<HTMLDivElement> {
   children?: Snippet;
 }
-//#endregion
-//#region src/components/input-group/index.d.ts
 /** Merged controls: attachments and the entry fused into one seal —
  * Root, Addon. */
 declare const InputGroup: import("svelte").Component<InputGroupProps, {}, ""> & {
   Root: import("svelte").Component<InputGroupProps, {}, "">;
   Addon: import("svelte").Component<InputGroupAddonProps, {}, "">;
 };
-//#endregion
 export { InputGroupAddonProps as n, InputGroupProps as r, InputGroup as t };

package/dist/{index-DAnDXxRZ.d.mts → index-Duxepy4v.d.mts}

@@ -1,5 +1,7 @@
+import { t as TreeSelect$1 } from "./TreeSelect-o3KT1Ixj.mjs";
+import { t as FamilyParts } from "./family-Dc5a-Kr6.mjs";
+import { t as Popover } from "./index-CXyumzqL.mjs";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/tree-select/props.d.ts
 interface TreeSelectNode {
   label: string;
   value: string;
@@ -17,12 +19,7 @@ interface TreeSelectProps extends HTMLAttributes<HTMLButtonElement> {
   filterable?: boolean;
   disabled?: boolean;
 }
-//#endregion
-//#region src/components/tree-select/index.d.ts
 /** A tree behind a field: the control reads like an input, the vessel
  * below walks the hierarchy, and one leaf click closes the deal. */
-declare const TreeSelect: import("svelte").Component<TreeSelectProps, {}, "value"> & {
-  Root: import("svelte").Component<TreeSelectProps, {}, "value">;
-};
-//#endregion
+declare const TreeSelect: typeof TreeSelect$1 & FamilyParts<typeof Popover>;
 export { TreeSelectNode as n, TreeSelectProps as r, TreeSelect as t };

package/dist/{index-CvDp7tiS.d.mts → index-DvNqmeZC.d.mts}

@@ -1,16 +1,12 @@
 import { Snippet } from "svelte";
 import { HTMLAnchorAttributes } from "svelte/elements";
-//#region src/components/link/props.d.ts
 interface LinkProps extends HTMLAnchorAttributes {
   underline?: "always" | "hover" | "none";
   children?: Snippet;
 }
-//#endregion
-//#region src/components/link/index.d.ts
 /** A link is ink in the accent's voice: quiet at rest, deepening under
  * the hand, the halo at focus. */
 declare const Link: import("svelte").Component<LinkProps, {}, ""> & {
   Root: import("svelte").Component<LinkProps, {}, "">;
 };
-//#endregion
 export { LinkProps as n, Link as t };

package/dist/{index-znAFQEmQ.d.mts → index-HDYhCKfZ.d.mts}

@@ -1,6 +1,8 @@
+import { t as CheckboxGroup$1 } from "./CheckboxGroup-D2rQc9D9.mjs";
+import { t as FamilyParts } from "./family-Dc5a-Kr6.mjs";
+import { Checkbox as Checkbox$1 } from "./components/checkbox/index.mjs";
 import { Snippet } from "svelte";
 import { CheckboxGroupProps } from "@ark-ui/svelte/checkbox";
-//#region src/components/checkbox-group/props.d.ts
 interface CheckboxOption {
   label: string;
   value: string;
@@ -18,12 +20,7 @@ interface CheckboxGroupProps$1 extends Omit<CheckboxGroupProps, "children"> {
   disabled?: boolean;
   children?: Snippet;
 }
-//#endregion
-//#region src/components/checkbox-group/index.d.ts
 /** One question, many answers: a labelled stack (or row) of the
  * seal-cut checkboxes bound to a single array. */
-declare const CheckboxGroup: import("svelte").Component<CheckboxGroupProps$1, {}, "value"> & {
-  Root: import("svelte").Component<CheckboxGroupProps$1, {}, "value">;
-};
-//#endregion
+declare const CheckboxGroup: typeof CheckboxGroup$1 & FamilyParts<typeof Checkbox$1>;
 export { CheckboxGroupProps$1 as n, CheckboxOption as r, CheckboxGroup as t };

package/dist/{index-BhTdJwBA.d.mts → index-IJmdYb5n.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/comment/props.d.ts
 interface CommentProps extends HTMLAttributes<HTMLElement> {
   author?: string;
   datetime?: string;
@@ -10,13 +9,10 @@ interface CommentProps extends HTMLAttributes<HTMLElement> {
   actions?: Snippet;
   children?: Snippet;
 }
-//#endregion
-//#region src/components/comment/index.d.ts
 /** A voice on the record: the portrait hangs left (the avatar snippet),
  * the body carries the byline from `author` and `datetime`, the ink is
  * the children snippet, and the actions snippet is the row of answers. */
 declare const Comment: import("svelte").Component<CommentProps, {}, ""> & {
   Root: import("svelte").Component<CommentProps, {}, "">;
 };
-//#endregion
 export { CommentProps as n, Comment as t };

package/dist/{index-eQIdP9QO.d.mts → index-ItZp2Plw.d.mts}

@@ -1,7 +1,6 @@
 import { ComponentMessagesOverride, ThemeScene } from "@bysages/core";
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/config-provider/context.d.ts
 /** The four density tiers the token layer's `[data-density]` selectors
  * name — whitespace and control heights compress, readability never
  * does. */
@@ -29,8 +28,6 @@ interface ConfigContext {
 /** The nearest provider's live snapshot, or an empty one when no
  * provider wraps the caller. */
 declare function useConfig(): ConfigContext;
-//#endregion
-//#region src/components/config-provider/props.d.ts
 interface ConfigProviderProps extends HTMLAttributes<HTMLDivElement> {
   density?: ConfigDensity;
   scene?: ConfigScene;
@@ -42,13 +39,10 @@ interface ConfigProviderProps extends HTMLAttributes<HTMLDivElement> {
   messages?: ComponentMessagesOverride;
   children?: Snippet;
 }
-//#endregion
-//#region src/components/config-provider/index.d.ts
 /** The declarative host for global configuration: one element carrying
  * the token layer's attributes and providing the same values to
  * descendants through `useConfig`. */
 declare const ConfigProvider: import("svelte").Component<ConfigProviderProps, {}, ""> & {
   Root: import("svelte").Component<ConfigProviderProps, {}, "">;
 };
-//#endregion
 export { useConfig as a, ConfigDensity as i, ConfigProviderProps as n, ConfigContext as r, ConfigProvider as t };

package/dist/{index-BwUGTQag.d.mts → index-ND9pqiYE.d.mts}

@@ -1,14 +1,10 @@
-import { n as ListboxRoot, t as Listbox$2 } from "./Listbox-C-u5WxHv.mjs";
+import { n as ListboxRoot, t as Listbox$2 } from "./Listbox-B6AR7Q42.mjs";
 import { CollectionItem, Listbox, ListboxRootProps } from "@ark-ui/svelte/listbox";
-//#region src/components/listbox/props.d.ts
 type ListboxRootProps$1 = ListboxRootProps<CollectionItem> & {
   /** One rung of the ladder for the row register and the filter field. */
   size?: "sm" | "md" | "lg";
 };
-//#endregion
-//#region src/components/listbox/index.d.ts
 declare const Listbox$1: typeof Listbox$2 & Omit<typeof Listbox, "Root"> & {
   Root: typeof ListboxRoot;
 };
-//#endregion
 export { ListboxRootProps$1 as n, Listbox$1 as t };

package/dist/{index-D2B6EH5P.d.mts → index-NDFoxs3W.d.mts}

@@ -1,5 +1,4 @@
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/textarea/props.d.ts
 interface TextareaProps extends HTMLAttributes<HTMLTextAreaElement> {
   /** Two-way bindable — `bind:value` keeps the bound variable mirroring
    * the field. */
@@ -8,13 +7,10 @@ interface TextareaProps extends HTMLAttributes<HTMLTextAreaElement> {
    * the context's invalid state joins in. */
   invalid?: boolean;
 }
-//#endregion
-//#region src/components/textarea/index.d.ts
 /** The bare multi-line input, dressed in the field recipe: border,
  * surface, focus halo — no shadow. Inside a Field.Root it picks up the
  * label wiring and the invalid state from the context. */
 declare const Textarea: import("svelte").Component<TextareaProps, {}, "value"> & {
   Root: import("svelte").Component<TextareaProps, {}, "value">;
 };
-//#endregion
 export { TextareaProps as n, Textarea as t };

package/dist/{index-evrdvWRI.d.mts → index-Q3Db9wEN.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/button-group/props.d.ts
 interface ButtonGroupProps extends HTMLAttributes<HTMLDivElement> {
   /** The seam runs across the group (default) or down it. */
   orientation?: "horizontal" | "vertical";
@@ -12,12 +11,9 @@ interface ButtonGroupProps extends HTMLAttributes<HTMLDivElement> {
   radius?: "sm" | "md" | "lg" | "xl" | "2xl" | "full";
   children?: Snippet;
 }
-//#endregion
-//#region src/components/button-group/index.d.ts
 /** Buttons fused into one control: the group owns only the joinery, so
  * members keep every variant they were given. */
 declare const ButtonGroup: import("svelte").Component<ButtonGroupProps, {}, ""> & {
   Root: import("svelte").Component<ButtonGroupProps, {}, "">;
 };
-//#endregion
 export { ButtonGroupProps as n, ButtonGroup as t };

package/dist/{index-BHlsL8ta.d.mts → index-Q9VgvJLD.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/card/props.d.ts
 interface CardProps extends HTMLAttributes<HTMLElement> {
   children?: Snippet;
 }
@@ -13,8 +12,6 @@ interface CardDescriptionProps extends HTMLAttributes<HTMLParagraphElement> {
 interface CardPartProps extends HTMLAttributes<HTMLElement> {
   children?: Snippet;
 }
-//#endregion
-//#region src/components/card/index.d.ts
 /** A vessel: round, resting at the first elevation, one hairline for its
  * edge. Root, Header, Title, Description, Content, Footer — sections
  * carry their own whitespace, so any subset composes. */
@@ -26,5 +23,4 @@ declare const Card: import("svelte").Component<CardProps, {}, ""> & {
   Content: import("svelte").Component<CardPartProps, {}, "">;
   Footer: import("svelte").Component<CardPartProps, {}, "">;
 };
-//#endregion
 export { CardTitleProps as a, CardProps as i, CardDescriptionProps as n, CardPartProps as r, Card as t };

package/dist/{index-CC_yY588.d.mts → index-_v_fp4pa.d.mts}

@@ -1,5 +1,7 @@
+import { t as SplitButton$1 } from "./SplitButton-BMqXeYAV.mjs";
+import { t as FamilyParts } from "./family-Dc5a-Kr6.mjs";
+import { Menu } from "./components/menu/index.mjs";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/split-button/props.d.ts
 interface SplitButtonEntry {
   label: string;
   /** Handed back with `onSelect` when the entry is chosen. */
@@ -23,13 +25,8 @@ interface SplitButtonProps extends HTMLAttributes<HTMLDivElement> {
   /** An entry was chosen; carries its `value`. */
   onSelect?: (value: string) => void;
 }
-//#endregion
-//#region src/components/split-button/index.d.ts
 /** A primary action with its alternatives one seam away: the main
  * button fires, the fitted arrow opens a paper vessel whose entries
  * hand back their value. */
-declare const SplitButton: import("svelte").Component<SplitButtonProps, {}, ""> & {
-  Root: import("svelte").Component<SplitButtonProps, {}, "">;
-};
-//#endregion
+declare const SplitButton: typeof SplitButton$1 & FamilyParts<typeof Menu>;
 export { SplitButtonEntry as n, SplitButtonProps as r, SplitButton as t };

package/dist/{index-DGsu3J-2.d.mts → index-bEBDXZ4B.d.mts}

@@ -1,18 +1,14 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/avatar-group/props.d.ts
 interface AvatarGroupProps extends HTMLAttributes<HTMLDivElement> {
   /** One register for every seal: falls onto data-size for the
    * stylesheet to re-point the avatars' measure. */
   size?: "sm" | "md" | "lg";
   children?: Snippet;
 }
-//#endregion
-//#region src/components/avatar-group/index.d.ts
 /** Avatars overlapping one row, each rimmed in the ground so the pile
  * stays legible. */
 declare const AvatarGroup: import("svelte").Component<AvatarGroupProps, {}, ""> & {
   Root: import("svelte").Component<AvatarGroupProps, {}, "">;
 };
-//#endregion
 export { AvatarGroupProps as n, AvatarGroup as t };

package/dist/{index-C5hCBtt4.d.mts → index-kvWVDke1.d.mts}

@@ -1,5 +1,4 @@
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/terminal/props.d.ts
 interface TerminalProps extends Omit<HTMLAttributes<HTMLDivElement>, "oncommand"> {
   /** The transcript, oldest line first. */
   lines?: string[];
@@ -7,13 +6,12 @@ interface TerminalProps extends Omit<HTMLAttributes<HTMLDivElement>, "oncommand"
   prompt?: string;
   placeholder?: string;
   label?: string;
+  /** Treat the transcript as output only; no command line mounts. */
+  readOnly?: boolean;
   onCommand?: (text: string) => void;
 }
-//#endregion
-//#region src/components/terminal/index.d.ts
 /** A quiet console: the transcript above, the prompt line below. */
 declare const Terminal: import("svelte").Component<TerminalProps, {}, ""> & {
   Root: import("svelte").Component<TerminalProps, {}, "">;
 };
-//#endregion
 export { TerminalProps as n, Terminal as t };

package/dist/{index-CmskeLd_.d.mts → index-qyo1-I2l.d.mts}

@@ -1,11 +1,8 @@
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/bento/props.d.ts
 interface BentoProps extends HTMLAttributes<HTMLDivElement> {
   /** Tracks across the lattice. */
   columns?: number;
 }
-//#endregion
-//#region src/components/bento/index.d.ts
 /** The bento lattice: a grid of unequal tiles that reads as one plate
  * — Bento, Bento.Cell. */
 declare const Bento: import("svelte").Component<import("svelte/elements").HTMLAttributes<HTMLDivElement> & {
@@ -19,5 +16,4 @@ declare const Bento: import("svelte").Component<import("svelte/elements").HTMLAt
     rowSpan?: number;
   }, {}, "">;
 };
-//#endregion
 export { BentoProps as n, Bento as t };

package/dist/{index-BKZC0MtK.d.mts → index-seXcaHyL.d.mts}

@@ -1,6 +1,5 @@
 import { Snippet } from "svelte";
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/virtual-list/props.d.ts
 interface VirtualListProps extends HTMLAttributes<HTMLDivElement> {
   items: unknown[];
   /** The height every row occupies — fixed rows keep it simple. */
@@ -10,11 +9,8 @@ interface VirtualListProps extends HTMLAttributes<HTMLDivElement> {
   /** Renders one record into its positioned row. */
   renderItem?: Snippet<[unknown, number]>;
 }
-//#endregion
-//#region src/components/virtual-list/index.d.ts
 /** A ledger that only mounts the rows on stage. */
 declare const VirtualList: import("svelte").Component<VirtualListProps, {}, ""> & {
   Root: import("svelte").Component<VirtualListProps, {}, "">;
 };
-//#endregion
 export { VirtualListProps as n, VirtualList as t };

package/dist/index-xveVUurC.d.mts

@@ -0,0 +1,123 @@
+import { t as Mentions$1 } from "./Mentions-wRPCCvkr.mjs";
+import { t as FamilyParts } from "./family-Dc5a-Kr6.mjs";
+import { t as Popover$1 } from "./index-CXyumzqL.mjs";
+import { PopoverAnchorProps } from "@ark-ui/svelte/popover";
+import { Snippet } from "svelte";
+import { HTMLAttributes } from "svelte/elements";
+interface MentionEntry {
+  /** Stable identity for tests, popups and business handlers. */
+  id?: string;
+  /** The primary words shown in the popup and inserted by default. */
+  label: string;
+  /** The semantic value reported by the field. */
+  value: string;
+  /** One line of supporting copy under the label. */
+  description?: string;
+  /** A curated core icon name. */
+  icon?: string;
+  /** Optional section heading; entries with the same heading travel together. */
+  group?: string;
+  /** The consumer's coarse entry type, such as `file`, `agent` or `command`. */
+  kind?: string;
+  /** A visible candidate the keyboard and pointer cannot choose. */
+  disabled?: boolean;
+  /** Exact composer text to insert; it bypasses `trigger + label`. */
+  insertText?: string;
+  /** Extra consumer data carried back through `onSelect`. */
+  meta?: Record<string, unknown>;
+}
+type MentionTriggers = string | string[];
+type MentionCommitKey = "Enter" | "Tab" | " ";
+type MentionPlacement = "bottom-start" | "top-start";
+interface UseMentionsOptions {
+  /** The candidates offered once a trigger character is typed. */
+  items: MentionEntry[];
+  /** The character that summons the candidates. */
+  trigger?: string;
+  /** One or more summoning characters; the longest token closest to the
+   * caret wins when several triggers are active. */
+  triggers?: string | string[];
+  /** Keys that choose the highlighted candidate. Tab stays optional so a
+   * plain field does not take focus movement away from the browser. */
+  commitKeys?: MentionCommitKey[];
+}
+interface UseMentionsHandlers {
+  /** The text the field holds right now — read at keystroke time, never
+   * from a controlled prop that lags a render behind the caret. */
+  getText: () => string;
+  /** Writes the field's next text: a mention inserted at the token. */
+  setText: (value: string) => void;
+  /** The absolute text offset of the field caret; a rich editor supplies this.
+   * A textarea is read from its own selection when omitted. */
+  getCaret?: () => number | undefined;
+  /** Called before insertion. Return `false` to record the choice without
+   * rewriting composer text — useful for slash commands and context chips. */
+  select?: (entry: MentionEntry) => boolean | void;
+  /** Replaces the default plain-text insertion. Rich editors use this so
+   * the candidate becomes a token, not another run of characters. */
+  commit?: (entry: MentionEntry) => void;
+}
+interface MentionsProps extends HTMLAttributes<HTMLDivElement> {
+  /** The candidates offered once a trigger character is typed. */
+  items?: MentionEntry[];
+  /** Two-way bindable — `bind:value` keeps the bound variable mirroring
+   * the field; changes are reported through `onValueChange`. */
+  value?: string;
+  /** The character that summons the candidates. */
+  trigger?: string;
+  /** One or more summoning characters, such as `@` and `/`. */
+  triggers?: MentionTriggers;
+  /** Keep composer text untouched when a candidate is selected. */
+  insertOnSelect?: boolean;
+  /** Keys that choose the highlighted candidate; Tab stays opt-in. */
+  commitKeys?: MentionCommitKey[];
+  /** Which side of the field hosts the candidates. */
+  placement?: MentionPlacement;
+  placeholder?: string;
+  /** Let the field grow with its text instead of holding `rows`. */
+  autoresize?: boolean;
+  /** Standing alone, the field announces itself invalid; inside a
+   * `Field.Root` the field's own invalid state takes over. */
+  invalid?: boolean;
+  /** One rung of the control-height ladder for the resting field. */
+  size?: "sm" | "md" | "lg";
+  /** The field's text turned. */
+  onValueChange?: (value: string) => void;
+  /** A candidate was confirmed; the whole entry rides back. */
+  onSelect?: (entry: MentionEntry) => void;
+}
+interface MentionsVesselProps {
+  /** The vessel's stable id; its options derive their ids from it. */
+  id?: string;
+  open?: boolean;
+  matches?: MentionEntry[];
+  active?: number;
+  /** The live rectangle the vessel points at — the host's field. */
+  anchor?: HTMLElement | null;
+  /** The host field's rung, so the rows keep the field's register. */
+  size?: "sm" | "md" | "lg";
+  /** Which side of the field hosts the candidates. */
+  placement?: MentionPlacement;
+  /** A candidate was confirmed (click or Enter). */
+  onInsert?: (entry: MentionEntry) => void;
+  /** The keyboard's active row moved. */
+  onActiveChange?: (index: number) => void;
+  /** The vessel's open state turned. */
+  onOpenChange?: (open: boolean) => void;
+  /** The host's field, rendered with the popover Anchor's wiring. When
+   * absent, the vessel falls back to the `anchor` rectangle. */
+  children?: Snippet<[() => PopoverAnchorProps]>;
+}
+/** @-mentions: a plain textarea that, when the text before the caret
+ * ends with the trigger character followed by a token, offers the
+ * matching candidates in a small anchored vessel; choosing one replaces
+ * the token with `trigger + label` and hands the whole text back
+ * through `bind:value`. Arrows move, configured keys commit, Escape dismisses. */
+declare const Mentions: typeof Mentions$1 & FamilyParts<typeof Popover$1>;
+/** The vessel: the candidates themselves as a floating card. Composers
+ * that keep their own field anatomy wire it up with `useMentions`
+ * directly. */
+declare const MentionsVessel: import("svelte").Component<MentionsVesselProps, {}, ""> & {
+  Root: import("svelte").Component<MentionsVesselProps, {}, "">;
+};
+export { MentionPlacement as a, MentionsVesselProps as c, MentionEntry as i, UseMentionsHandlers as l, MentionsVessel as n, MentionTriggers as o, MentionCommitKey as r, MentionsProps as s, Mentions as t, UseMentionsOptions as u };

package/dist/{index-Dq4bm9bV.d.mts → index-ymBJyo20.d.mts}

@@ -1,5 +1,4 @@
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/input/props.d.ts
 interface InputProps extends HTMLAttributes<HTMLInputElement> {
   /** Two-way bindable — `bind:value` keeps the bound variable mirroring
    * the field. */
@@ -12,13 +11,10 @@ interface InputProps extends HTMLAttributes<HTMLInputElement> {
    * literal. e.g. `"999-99-9999"`, `"(999) 999-9999"`. */
   mask?: string;
 }
-//#endregion
-//#region src/components/input/index.d.ts
 /** The bare text input, dressed in the field recipe: border, surface,
  * focus halo — no shadow. Inside a Field.Root it picks up the label
  * wiring and the invalid state from the context. */
 declare const Input: import("svelte").Component<InputProps, {}, "value"> & {
   Root: import("svelte").Component<InputProps, {}, "value">;
 };
-//#endregion
 export { InputProps as n, Input as t };

package/dist/{index-fIWQxtE9.d.mts → index-yuJTtYOg.d.mts}

@@ -1,17 +1,13 @@
 import { HTMLAttributes } from "svelte/elements";
-//#region src/components/chip/props.d.ts
 interface ChipProps extends HTMLAttributes<HTMLSpanElement> {
   value: number;
   max?: number;
   tone?: "ink" | "primary" | "success" | "warning" | "danger" | "info";
   variant?: "solid" | "subtle" | "outline";
 }
-//#endregion
-//#region src/components/chip/index.d.ts
 /** A counting coin: the numeric value, capped at `max` with an ellipsis
  * of the remainder ("99+"). */
 declare const Chip: import("svelte").Component<ChipProps, {}, ""> & {
   Root: import("svelte").Component<ChipProps, {}, "">;
 };
-//#endregion
 export { ChipProps as n, Chip as t };