@bysages/react 0.3.0 → 0.4.0

package/dist/components/tabs/index.d.mts

@@ -1,6 +1,27 @@
-import { ComponentProps } from "react";
+import { ComponentProps, ReactNode } from "react";
 import { Tabs as Tabs$1 } from "@ark-ui/react/tabs";
 //#region src/components/tabs/index.d.ts
+export type TabsItem = {
+  value: string;
+  label: string;
+  content?: ReactNode;
+};
+export interface TabsFacadeProps {
+  value?: string;
+  defaultValue?: string;
+  items: TabsItem[];
+  /** The register: a ruled line (default), or each tab its own card. */
+  variant?: "line" | "card";
+  orientation?: "horizontal" | "vertical";
+  /** One rung of the control-height ladder for the tab rows. */
+  size?: "sm" | "md" | "lg";
+  className?: string;
+  onValueChange?: (value: string) => void;
+}
+declare function TabsFacade({ value, defaultValue, items, variant, orientation, size, className, onValueChange }: TabsFacadeProps): import("react").JSX.Element;
+declare namespace TabsFacade {
+  var displayName: string;
+}
 type TabsRootProps = ComponentProps<typeof Tabs$1.Root> & {
   /** One rung of the control-height ladder for the tab rows. */
   size?: "sm" | "md" | "lg";
@@ -14,7 +35,8 @@ declare function TabsRoot({ size, variant, ...rest }: TabsRootProps): import("re
  * Parts: Root, List, Trigger, Content, Indicator (machine-positioned ink
  * bar on the list rule).
  */
-export declare const Tabs: Omit<typeof Tabs$1, "Root"> & {
+type TabsParts = Omit<typeof Tabs$1, "Root"> & {
   Root: typeof TabsRoot;
 };
+export declare const Tabs: typeof TabsFacade & TabsParts;
 //#endregion

package/dist/components/tabs/index.mjs

@@ -1,24 +1,40 @@
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
 import { injectComponentStyle } from "@bysages/core";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { Tabs as Tabs$1 } from "@ark-ui/react/tabs";
 //#region src/components/tabs/index.tsx
+function TabsFacade({ value, defaultValue, items, variant = "line", orientation = "horizontal", size = "md", className, onValueChange }) {
+	return /* @__PURE__ */ jsxs(TabsRoot, {
+		className,
+		size,
+		variant,
+		orientation,
+		defaultValue,
+		...value === void 0 ? {} : { value },
+		onValueChange: (details) => onValueChange?.(details.value),
+		children: [/* @__PURE__ */ jsxs(Tabs$1.List, { children: [items.map((item) => /* @__PURE__ */ jsx(Tabs$1.Trigger, {
+			value: item.value,
+			children: item.label
+		}, item.value)), /* @__PURE__ */ jsx(Tabs$1.Indicator, {})] }), items.map((item) => /* @__PURE__ */ jsx(Tabs$1.Content, {
+			value: item.value,
+			children: item.content
+		}, item.value))]
+	});
+}
+TabsFacade.displayName = "STabs";
 function TabsRoot({ size = "md", variant = "line", ...rest }) {
+	const id = useElementId("tabs", rest);
 	return /* @__PURE__ */ jsx(Tabs$1.Root, {
 		...rest,
+		id,
 		"data-size": size,
 		"data-variant": variant
 	});
 }
-/**
-* Tabs — tabbed navigation.
-*
-* Parts: Root, List, Trigger, Content, Indicator (machine-positioned ink
-* bar on the list rule).
-*/
-const Tabs = {
+const Tabs = Object.assign(TabsFacade, {
 	...Tabs$1,
 	Root: TabsRoot
-};
+});
 injectComponentStyle("tabs");
 //#endregion
 export { Tabs };

package/dist/components/tags-input/index.d.mts

@@ -1,17 +1,42 @@
-import { ComponentProps } from "react";
+import { ComponentProps, ReactNode } from "react";
 import { TagsInput as TagsInput$1 } from "@ark-ui/react/tags-input";
 //#region src/components/tags-input/index.d.ts
 type TagsInputRootProps = ComponentProps<typeof TagsInput$1.Root> & {
   /** One rung of the control-height ladder for the vessel at rest. */
   size?: "sm" | "md" | "lg";
 };
-declare function TagsInputRoot({ size, ...rest }: TagsInputRootProps): import("react").JSX.Element;
-/** Ark's TagsInput, dressed in the paper-and-ink system: one field vessel
- * whose chips rest as quiet ink and lift only a tone when edited. The API
- * is Ark's own — Root, Label, Control, Input, ClearTrigger, Item,
- * ItemPreview, ItemText, ItemInput, ItemDeleteTrigger, HiddenInput,
- * Context. */
-export declare const TagsInput: Omit<typeof TagsInput$1, "Root"> & {
+declare function TagsInputRoot(props: TagsInputRootProps): import("react").JSX.Element;
+interface TagsInputFacadeProps {
+  value?: string[];
+  defaultValue?: string[];
+  label?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  invalid?: boolean;
+  required?: boolean;
+  /** Show the clear-all control when values exist. */
+  clearable?: boolean;
+  size?: "sm" | "md" | "lg";
+  onValueChange?: (value: string[]) => void;
+  children?: ReactNode;
+}
+/** The one-tag path: one labelled vessel whose values become editable
+ * chips. Delimiters, limits, and custom validation stay on the anatomy. */
+declare function TagsInputFacade({ value, defaultValue, label, placeholder, disabled, invalid, required, clearable, size, onValueChange }: TagsInputFacadeProps): import("react").JSX.Element;
+export declare const TagsInput: typeof TagsInputFacade & {
   Root: typeof TagsInputRoot;
+  ClearTrigger: import("react").ForwardRefExoticComponent<TagsInput$1.ClearTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+  Context: (props: TagsInput$1.ContextProps) => ReactNode;
+  Control: import("react").ForwardRefExoticComponent<TagsInput$1.ControlProps & import("react").RefAttributes<HTMLDivElement>>;
+  HiddenInput: import("react").ForwardRefExoticComponent<TagsInput$1.HiddenInputProps & import("react").RefAttributes<HTMLInputElement>>;
+  Input: import("react").ForwardRefExoticComponent<TagsInput$1.InputProps & import("react").RefAttributes<HTMLInputElement>>;
+  Item: import("react").ForwardRefExoticComponent<TagsInput$1.ItemProps & import("react").RefAttributes<HTMLDivElement>>;
+  ItemContext: (props: TagsInput$1.ItemContextProps) => ReactNode;
+  ItemDeleteTrigger: import("react").ForwardRefExoticComponent<TagsInput$1.ItemDeleteTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+  ItemInput: import("react").ForwardRefExoticComponent<TagsInput$1.ItemInputProps & import("react").RefAttributes<HTMLInputElement>>;
+  ItemPreview: import("react").ForwardRefExoticComponent<TagsInput$1.ItemPreviewProps & import("react").RefAttributes<HTMLDivElement>>;
+  ItemText: import("react").ForwardRefExoticComponent<TagsInput$1.ItemTextProps & import("react").RefAttributes<HTMLSpanElement>>;
+  Label: import("react").ForwardRefExoticComponent<TagsInput$1.LabelProps & import("react").RefAttributes<HTMLLabelElement>>;
+  RootProvider: import("react").ForwardRefExoticComponent<TagsInput$1.RootProviderProps & import("react").RefAttributes<HTMLDivElement>>;
 };
 //#endregion

package/dist/components/tags-input/index.mjs

@@ -1,22 +1,54 @@
+import { t as iconNode } from "../../icon-BALgGtNK.mjs";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
 import { injectComponentStyle } from "@bysages/core";
-import { jsx } from "react/jsx-runtime";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { TagsInput as TagsInput$1 } from "@ark-ui/react/tags-input";
 //#region src/components/tags-input/index.tsx
-function TagsInputRoot({ size = "md", ...rest }) {
+function TagsInputRoot(props) {
+	const id = useElementId("tags-input", props);
+	const { size = "md", ...rest } = props;
 	return /* @__PURE__ */ jsx(TagsInput$1.Root, {
 		...rest,
+		id,
 		"data-size": size
 	});
 }
-/** Ark's TagsInput, dressed in the paper-and-ink system: one field vessel
-* whose chips rest as quiet ink and lift only a tone when edited. The API
-* is Ark's own — Root, Label, Control, Input, ClearTrigger, Item,
-* ItemPreview, ItemText, ItemInput, ItemDeleteTrigger, HiddenInput,
-* Context. */
-const TagsInput = {
+const closeIcon = iconNode("x", {
+	width: 14,
+	height: 14
+});
+/** The one-tag path: one labelled vessel whose values become editable
+* chips. Delimiters, limits, and custom validation stay on the anatomy. */
+function TagsInputFacade({ value, defaultValue, label, placeholder, disabled = false, invalid = false, required = false, clearable = true, size = "md", onValueChange }) {
+	return /* @__PURE__ */ jsxs(TagsInputRoot, {
+		size,
+		disabled,
+		invalid,
+		required,
+		defaultValue,
+		...value === void 0 ? {} : {
+			value,
+			onValueChange: (details) => onValueChange?.(details.value)
+		},
+		children: [
+			label ? /* @__PURE__ */ jsx(TagsInput$1.Label, { children: label }) : null,
+			/* @__PURE__ */ jsxs(TagsInput$1.Control, { children: [
+				/* @__PURE__ */ jsx(TagsInput$1.Context, { children: (tagsInput) => tagsInput.value.map((tag, index) => /* @__PURE__ */ jsxs(TagsInput$1.Item, {
+					index,
+					value: tag,
+					children: [/* @__PURE__ */ jsxs(TagsInput$1.ItemPreview, { children: [/* @__PURE__ */ jsx(TagsInput$1.ItemText, { children: tag }), /* @__PURE__ */ jsx(TagsInput$1.ItemDeleteTrigger, { children: closeIcon })] }), /* @__PURE__ */ jsx(TagsInput$1.ItemInput, {})]
+				}, `${tag}-${index}`)) }),
+				/* @__PURE__ */ jsx(TagsInput$1.Input, { placeholder }),
+				clearable ? /* @__PURE__ */ jsx(TagsInput$1.ClearTrigger, { children: closeIcon }) : null
+			] }),
+			/* @__PURE__ */ jsx(TagsInput$1.HiddenInput, {})
+		]
+	});
+}
+const TagsInput = Object.assign(TagsInputFacade, {
 	...TagsInput$1,
 	Root: TagsInputRoot
-};
+});
 injectComponentStyle("tags-input");
 //#endregion
 export { TagsInput };

package/dist/components/terminal/index.d.mts

@@ -13,5 +13,8 @@ export interface TerminalProps extends HTMLAttributes<HTMLDivElement> {
  * component owns only the reading and the caret — each entered line
  * leaves as an event, and the caller answers through the lines prop,
  * so history stays theirs to shape. */
-export declare function Terminal({ lines, prompt, placeholder, label, onCommand, ...rest }: TerminalProps): import("react").JSX.Element;
+declare function TerminalImpl({ lines, prompt, placeholder, label, onCommand, ...rest }: TerminalProps): import("react").JSX.Element;
+export declare const Terminal: typeof TerminalImpl & {
+  Root: typeof TerminalImpl;
+};
 //#endregion

package/dist/components/terminal/index.mjs

@@ -1,3 +1,5 @@
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
+import { n as useComponentMessages } from "../../messages-1jJWtaYU.mjs";
 import { injectComponentStyle } from "@bysages/core";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
@@ -6,8 +8,10 @@ import { useEffect, useRef, useState } from "react";
 * component owns only the reading and the caret — each entered line
 * leaves as an event, and the caller answers through the lines prop,
 * so history stays theirs to shape. */
-function Terminal({ lines = [], prompt = "$", placeholder, label, onCommand, ...rest }) {
+function TerminalImpl({ lines = [], prompt = "$", placeholder, label, onCommand, ...rest }) {
 	injectComponentStyle("terminal");
+	const messages = useComponentMessages();
+	const commandLineLabel = label ?? messages.terminal.commandLine;
 	const [draft, setDraft] = useState("");
 	const scroll = useRef(null);
 	useEffect(() => {
@@ -22,7 +26,7 @@ function Terminal({ lines = [], prompt = "$", placeholder, label, onCommand, ...
 	return /* @__PURE__ */ jsxs("div", {
 		...rest,
 		role: "log",
-		"aria-label": label ?? void 0,
+		"aria-label": commandLineLabel,
 		"data-scope": "terminal",
 		"data-part": "root",
 		children: [/* @__PURE__ */ jsx("div", {
@@ -47,7 +51,7 @@ function Terminal({ lines = [], prompt = "$", placeholder, label, onCommand, ...
 				"data-part": "input",
 				value: draft,
 				placeholder,
-				"aria-label": label ? `${label} command line` : "Command line",
+				"aria-label": commandLineLabel,
 				spellCheck: false,
 				autoComplete: "off",
 				onInput: (event) => setDraft(event.target.value),
@@ -61,5 +65,6 @@ function Terminal({ lines = [], prompt = "$", placeholder, label, onCommand, ...
 		})]
 	});
 }
+const Terminal = withSelfRoot(TerminalImpl);
 //#endregion
 export { Terminal };

package/dist/components/textarea/index.d.mts

@@ -10,5 +10,8 @@ export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElemen
   invalid?: boolean;
   onValueChange?: (value: string) => void;
 }
-export declare function Textarea({ value, invalid, onValueChange, ...rest }: TextareaProps): import("react").JSX.Element;
+declare function TextareaImpl({ value, invalid, onValueChange, ...rest }: TextareaProps): import("react").JSX.Element;
+export declare const Textarea: typeof TextareaImpl & {
+  Root: typeof TextareaImpl;
+};
 //#endregion

package/dist/components/textarea/index.mjs

@@ -1,8 +1,9 @@
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
 import { injectComponentStyle } from "@bysages/core";
 import { jsx } from "react/jsx-runtime";
 import { useFieldContext } from "@ark-ui/react/field";
 //#region src/components/textarea/index.tsx
-function Textarea({ value, invalid = false, onValueChange, ...rest }) {
+function TextareaImpl({ value, invalid = false, onValueChange, ...rest }) {
 	injectComponentStyle("textarea");
 	const field = useFieldContext();
 	const fieldProps = field?.getTextareaProps() ?? {};
@@ -16,5 +17,6 @@ function Textarea({ value, invalid = false, onValueChange, ...rest }) {
 		onChange: (event) => onValueChange?.(event.target.value)
 	});
 }
+const Textarea = withSelfRoot(TextareaImpl);
 //#endregion
 export { Textarea };

package/dist/components/timer/index.d.mts

@@ -1,8 +1,25 @@
+import { CSSProperties, ComponentProps } from "react";
 import { Timer as Timer$1 } from "@ark-ui/react/timer";
 //#region src/components/timer/index.d.ts
 /** Ark's Timer, dressed in the paper-and-ink system: monospaced digits
  * that never jitter, quiet action triggers on the control recipe. The API
  * is Ark's own — Root, Area, Control, Item, Separator, ActionTrigger,
  * Context. Unit labels are plain content, not a machine part. */
-export declare const Timer: typeof Timer$1;
+declare function TimerRoot(props: ComponentProps<typeof Timer$1.Root>): import("react").JSX.Element;
+type TimerFacadeProps = {
+  startMs?: number;
+  targetMs?: number;
+  countdown?: boolean;
+  autoStart?: boolean;
+  label?: string;
+  className?: string;
+  style?: CSSProperties;
+};
+/** The complete timer behind one duration: minute and second digits with
+ * start, pause, resume, and reset. Finer intervals and custom faces remain
+ * anatomy work. */
+declare function TimerFacade(props: TimerFacadeProps): import("react").JSX.Element;
+export declare const Timer: typeof TimerFacade & Omit<typeof Timer$1, "Root"> & {
+  Root: typeof TimerRoot;
+};
 //#endregion

package/dist/components/timer/index.mjs

@@ -1,11 +1,60 @@
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
 import { injectComponentStyle } from "@bysages/core";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { Timer as Timer$1 } from "@ark-ui/react/timer";
 //#region src/components/timer/index.tsx
 /** Ark's Timer, dressed in the paper-and-ink system: monospaced digits
 * that never jitter, quiet action triggers on the control recipe. The API
 * is Ark's own — Root, Area, Control, Item, Separator, ActionTrigger,
 * Context. Unit labels are plain content, not a machine part. */
-const Timer = Timer$1;
-injectComponentStyle("timer");
+function TimerRoot(props) {
+	injectComponentStyle("timer");
+	const id = useElementId("timer", props);
+	return /* @__PURE__ */ jsx(Timer$1.Root, {
+		...props,
+		id
+	});
+}
+/** The complete timer behind one duration: minute and second digits with
+* start, pause, resume, and reset. Finer intervals and custom faces remain
+* anatomy work. */
+function TimerFacade(props) {
+	const { startMs = 0, targetMs, countdown, autoStart, label, className, style } = props;
+	return /* @__PURE__ */ jsxs(TimerRoot, {
+		"aria-label": label,
+		startMs,
+		targetMs,
+		countdown,
+		autoStart,
+		className,
+		style,
+		children: [/* @__PURE__ */ jsxs(Timer$1.Area, { children: [
+			/* @__PURE__ */ jsx(Timer$1.Item, { type: "minutes" }),
+			/* @__PURE__ */ jsx(Timer$1.Separator, { children: ":" }),
+			/* @__PURE__ */ jsx(Timer$1.Item, { type: "seconds" })
+		] }), /* @__PURE__ */ jsxs(Timer$1.Control, { children: [
+			/* @__PURE__ */ jsx(Timer$1.ActionTrigger, {
+				action: "start",
+				children: "Start"
+			}),
+			/* @__PURE__ */ jsx(Timer$1.ActionTrigger, {
+				action: "pause",
+				children: "Pause"
+			}),
+			/* @__PURE__ */ jsx(Timer$1.ActionTrigger, {
+				action: "resume",
+				children: "Resume"
+			}),
+			/* @__PURE__ */ jsx(Timer$1.ActionTrigger, {
+				action: "reset",
+				children: "Reset"
+			})
+		] })]
+	});
+}
+const Timer = Object.assign(TimerFacade, {
+	...Timer$1,
+	Root: TimerRoot
+});
 //#endregion
 export { Timer };

package/dist/components/toast/index.d.mts

@@ -1,11 +1,8 @@
 import { CreateToasterReturn, Toast as Toast$1, createToaster } from "@ark-ui/react/toast";
 //#region src/components/toast/index.d.ts
-/** Ark's Toast, dressed in the paper-and-ink system: each notice rides the
- * popup vessel while a pigment accents the title by type, and the machine's
- * translate variables carry the slide. The API is Ark's own — Toaster,
- * Root, Title, Description, ActionTrigger, CloseTrigger, plus
- * createToaster. */
 export declare const Toast: typeof Toast$1;
-export declare const Toaster: import("react").ForwardRefExoticComponent<import("@ark-ui/react/toast").ToasterProps & import("react").RefAttributes<HTMLDivElement>>;
+export declare const Toaster: import("react").ForwardRefExoticComponent<import("@ark-ui/react/toast").ToasterProps & import("react").RefAttributes<HTMLDivElement>> & {
+  Root: import("react").ForwardRefExoticComponent<import("@ark-ui/react/toast").ToasterProps & import("react").RefAttributes<HTMLDivElement>>;
+};
 //#endregion
 export { type CreateToasterReturn, createToaster };

package/dist/components/toast/index.mjs

@@ -1,4 +1,8 @@
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
 import { injectComponentStyle } from "@bysages/core";
+import { jsx } from "react/jsx-runtime";
+import { forwardRef } from "react";
 import { Toast as Toast$1, Toaster as Toaster$1, createToaster } from "@ark-ui/react/toast";
 //#region src/components/toast/index.tsx
 /** Ark's Toast, dressed in the paper-and-ink system: each notice rides the
@@ -6,8 +10,24 @@ import { Toast as Toast$1, Toaster as Toaster$1, createToaster } from "@ark-ui/r
 * translate variables carry the slide. The API is Ark's own — Toaster,
 * Root, Title, Description, ActionTrigger, CloseTrigger, plus
 * createToaster. */
-const Toast = Toast$1;
-const Toaster = Toaster$1;
+function ToastRoot(props) {
+	const id = useElementId("toast", props);
+	return /* @__PURE__ */ jsx(Toast$1.Root, {
+		...props,
+		id
+	});
+}
+const Toast = {
+	...Toast$1,
+	Root: ToastRoot
+};
+const ToasterRoot = forwardRef(function ToasterRoot(props, ref) {
+	return /* @__PURE__ */ jsx(Toaster$1, {
+		ref,
+		...props
+	});
+});
+const Toaster = withSelfRoot(ToasterRoot);
 injectComponentStyle("toast");
 //#endregion
 export { Toast, Toaster, createToaster };

package/dist/components/toc/index.d.mts

@@ -1,7 +1,27 @@
-import { Toc as Toc$1 } from "@ark-ui/react/toc";
+import { CSSProperties, ComponentProps } from "react";
+import { Toc as Toc$1, TocItemData } from "@ark-ui/react/toc";
 //#region src/components/toc/index.d.ts
-/** Ark's Toc, dressed in the paper-and-ink system: a quiet rail of links
+/** Toc, dressed in the paper-and-ink system: a quiet rail of links
  * beside the scroll, one stroke of primary ink marking where the reader
- * stands. The API is Ark's own — Root, Title, List, Item, Link, Indicator. */
-export declare const Toc: typeof Toc$1;
+ * stands. The parts — Root, Title, List, Item, Link, Indicator. */
+declare function TocRoot(props: ComponentProps<typeof Toc$1.Root>): import("react").JSX.Element;
+/** The active stroke is decoration; hidden so the list reads as links
+ * alone. */
+declare function TocIndicator(props: ComponentProps<typeof Toc$1.Indicator>): import("react").JSX.Element;
+export interface TocFacadeProps {
+  items: Array<TocItemData & {
+    label: string;
+  }>;
+  scrollEl?: () => HTMLElement | null;
+  title?: string;
+  className?: string;
+  style?: CSSProperties;
+}
+/** The complete rail behind one page: items become anchor rows, the
+ * title names the list, and the active stroke follows the scroller. */
+declare function TocFacade({ items, scrollEl, title, className, style }: TocFacadeProps): import("react").JSX.Element;
+export declare const Toc: typeof TocFacade & Omit<typeof Toc$1, "Root" | "Indicator"> & {
+  Root: typeof TocRoot;
+  Indicator: typeof TocIndicator;
+};
 //#endregion

package/dist/components/toc/index.mjs

@@ -1,10 +1,48 @@
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
 import { injectComponentStyle } from "@bysages/core";
+import { jsx, jsxs } from "react/jsx-runtime";
 import { Toc as Toc$1 } from "@ark-ui/react/toc";
 //#region src/components/toc/index.tsx
-/** Ark's Toc, dressed in the paper-and-ink system: a quiet rail of links
+/** Toc, dressed in the paper-and-ink system: a quiet rail of links
 * beside the scroll, one stroke of primary ink marking where the reader
-* stands. The API is Ark's own — Root, Title, List, Item, Link, Indicator. */
-const Toc = Toc$1;
+* stands. The parts — Root, Title, List, Item, Link, Indicator. */
+function TocRoot(props) {
+	const id = useElementId("toc", props);
+	return /* @__PURE__ */ jsx(Toc$1.Root, {
+		...props,
+		id
+	});
+}
+/** The active stroke is decoration; hidden so the list reads as links
+* alone. */
+function TocIndicator(props) {
+	return /* @__PURE__ */ jsx(Toc$1.Indicator, {
+		...props,
+		"aria-hidden": "true"
+	});
+}
+/** The complete rail behind one page: items become anchor rows, the
+* title names the list, and the active stroke follows the scroller. */
+function TocFacade({ items, scrollEl, title = "On this page", className, style }) {
+	return /* @__PURE__ */ jsx(TocRoot, {
+		className,
+		style,
+		items,
+		scrollEl,
+		children: /* @__PURE__ */ jsxs(Toc$1.Nav, { children: [title ? /* @__PURE__ */ jsx(Toc$1.Title, { children: title }) : null, /* @__PURE__ */ jsxs(Toc$1.List, { children: [/* @__PURE__ */ jsx(TocIndicator, {}), items.map((item) => /* @__PURE__ */ jsx(Toc$1.Item, {
+			item,
+			children: /* @__PURE__ */ jsx(Toc$1.Link, {
+				href: `#${item.value}`,
+				children: item.label
+			})
+		}, item.value))] })] })
+	});
+}
+const Toc = Object.assign(TocFacade, {
+	...Toc$1,
+	Root: TocRoot,
+	Indicator: TocIndicator
+});
 injectComponentStyle("toc");
 //#endregion
 export { Toc };

package/dist/components/toggle/index.d.mts

@@ -1,7 +1,14 @@
+import { ComponentProps } from "react";
 import { Toggle as Toggle$1 } from "@ark-ui/react/toggle";
 //#region src/components/toggle/index.d.ts
-/** Ark's Toggle, dressed in the paper-and-ink system: a standalone seal that
- * settles into the flat ink fill while pressed on. The API is Ark's own —
- * Root, Indicator. */
-export declare const Toggle: typeof Toggle$1;
+export interface ToggleFacadeProps extends ComponentProps<typeof Toggle$1.Root> {
+  /** The accessible name when the content is only an icon. */
+  label?: string;
+}
+declare function ToggleFacade({ label, children, ...rest }: ToggleFacadeProps): import("react").JSX.Element;
+declare namespace ToggleFacade {
+  var displayName: string;
+}
+type ToggleParts = typeof Toggle$1;
+export declare const Toggle: typeof ToggleFacade & ToggleParts;
 //#endregion

package/dist/components/toggle/index.mjs

@@ -1,10 +1,30 @@
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
 import { injectComponentStyle } from "@bysages/core";
+import { jsx } from "react/jsx-runtime";
 import { Toggle as Toggle$1 } from "@ark-ui/react/toggle";
 //#region src/components/toggle/index.tsx
 /** Ark's Toggle, dressed in the paper-and-ink system: a standalone seal that
 * settles into the flat ink fill while pressed on. The API is Ark's own —
 * Root, Indicator. */
-const Toggle = Toggle$1;
+function ToggleRoot(props) {
+	const id = useElementId("toggle", props);
+	return /* @__PURE__ */ jsx(Toggle$1.Root, {
+		...props,
+		id
+	});
+}
+function ToggleFacade({ label, children, ...rest }) {
+	return /* @__PURE__ */ jsx(ToggleRoot, {
+		...rest,
+		"aria-label": label ?? rest["aria-label"],
+		children: /* @__PURE__ */ jsx(Toggle$1.Indicator, { children })
+	});
+}
+ToggleFacade.displayName = "SToggle";
+const Toggle = Object.assign(ToggleFacade, {
+	...Toggle$1,
+	Root: ToggleRoot
+});
 injectComponentStyle("toggle");
 //#endregion
 export { Toggle };

package/dist/components/toggle-group/index.d.mts

@@ -5,11 +5,35 @@ type ToggleGroupRootProps = ComponentProps<typeof ToggleGroup$1.Root> & {
   /** One rung of the control-height ladder for the items. */
   size?: "sm" | "md" | "lg";
 };
-declare function ToggleGroupRoot({ size, ...rest }: ToggleGroupRootProps): import("react").JSX.Element;
+declare function ToggleGroupRoot(props: ToggleGroupRootProps): import("react").JSX.Element;
+export type ToggleGroupItem = {
+  value: string;
+  label: string;
+  /** A built-in core-registry icon; omit it to render the label as text. */
+  icon?: string;
+  disabled?: boolean;
+};
+export interface ToggleGroupFacadeProps {
+  value?: string | string[];
+  defaultValue?: string | string[];
+  items: ToggleGroupItem[];
+  label?: string;
+  multiple?: boolean;
+  disabled?: boolean;
+  /** One rung of the control-height ladder for the items. */
+  size?: "sm" | "md" | "lg";
+  className?: string;
+  onValueChange?: (value: string | string[]) => void;
+}
+declare function ToggleGroupFacade({ value, defaultValue, items, label, multiple, disabled, size, className, onValueChange }: ToggleGroupFacadeProps): import("react").JSX.Element;
+declare namespace ToggleGroupFacade {
+  var displayName: string;
+}
 /** Ark's ToggleGroup, dressed in the paper-and-ink system: a hairline tray
  * of quiet seals where the pressed item takes the flat ink fill. The API is
  * Ark's own — Root, Item. */
-export declare const ToggleGroup: Omit<typeof ToggleGroup$1, "Root"> & {
+type ToggleGroupParts = Omit<typeof ToggleGroup$1, "Root"> & {
   Root: typeof ToggleGroupRoot;
 };
+export declare const ToggleGroup: typeof ToggleGroupFacade & ToggleGroupParts;
 //#endregion