@bysages/react 0.3.1 → 0.4.1

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 { injectComponentStyle } from "@bysages/core";
-import { jsx } from "react/jsx-runtime";
+import { t as iconNode } from "../../icon-BALgGtNK.mjs";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
+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,5 +1,6 @@
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
 import { n as useComponentMessages } from "../../messages-1jJWtaYU.mjs";
-import { injectComponentStyle } from "@bysages/core";
+import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useRef, useState } from "react";
 //#region src/components/terminal/index.tsx
@@ -7,7 +8,7 @@ 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;
@@ -64,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 { injectComponentStyle } from "@bysages/core";
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
 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/timeline/index.mjs

@@ -1,4 +1,4 @@
-import { injectComponentStyle } from "@bysages/core";
+import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx } from "react/jsx-runtime";
 //#region src/components/timeline/index.tsx
 /** A line of moments: Root is the ordered thread, Item one moment on it,

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 { injectComponentStyle } from "@bysages/core";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
+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 { injectComponentStyle } from "@bysages/core";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
+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,13 +1,27 @@
-import { ComponentProps } from "react";
-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. */
+ * 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 declare const Toc: Omit<typeof Toc$1, "Indicator"> & {
+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,18 @@
-import { injectComponentStyle } from "@bysages/core";
-import { jsx } from "react/jsx-runtime";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
+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. */
+* 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) {
@@ -13,10 +21,28 @@ function TocIndicator(props) {
 		"aria-hidden": "true"
 	});
 }
-const Toc = {
+/** 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 { injectComponentStyle } from "@bysages/core";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
+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

package/dist/components/toggle-group/index.mjs

@@ -1,20 +1,45 @@
-import { injectComponentStyle } from "@bysages/core";
+import { t as iconNode } from "../../icon-BALgGtNK.mjs";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx } from "react/jsx-runtime";
 import { ToggleGroup as ToggleGroup$1 } from "@ark-ui/react/toggle-group";
 //#region src/components/toggle-group/index.tsx
-function ToggleGroupRoot({ size = "md", ...rest }) {
+function ToggleGroupRoot(props) {
+	const id = useElementId("toggle-group", props);
+	const { size = "md", ...rest } = props;
 	return /* @__PURE__ */ jsx(ToggleGroup$1.Root, {
 		...rest,
+		id,
 		"data-size": size
 	});
 }
-/** 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. */
-const ToggleGroup = {
+function toArkValue(value) {
+	return value === void 0 ? [] : Array.isArray(value) ? value : [value];
+}
+function ToggleGroupFacade({ value, defaultValue, items, label, multiple = false, disabled = false, size = "md", className, onValueChange }) {
+	return /* @__PURE__ */ jsx(ToggleGroupRoot, {
+		className,
+		size,
+		"aria-label": label,
+		disabled,
+		multiple,
+		defaultValue: toArkValue(defaultValue),
+		...value === void 0 ? {} : { value: toArkValue(value) },
+		onValueChange: (details) => onValueChange?.(multiple ? details.value : details.value.at(0) ?? ""),
+		children: items.map((item) => /* @__PURE__ */ jsx(ToggleGroup$1.Item, {
+			value: item.value,
+			disabled: item.disabled,
+			"aria-label": item.label,
+			"data-variant": item.icon ? "icon" : "text",
+			children: item.icon ? iconNode(item.icon) : item.label
+		}, item.value))
+	});
+}
+ToggleGroupFacade.displayName = "SToggleGroup";
+const ToggleGroup = Object.assign(ToggleGroupFacade, {
 	...ToggleGroup$1,
 	Root: ToggleGroupRoot
-};
+});
 injectComponentStyle("toggle-group");
 //#endregion
 export { ToggleGroup };

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

@@ -13,5 +13,8 @@ export interface ToolbarProps extends HTMLAttributes<HTMLDivElement> {
 /** A workbench rail: the start tools at the leading edge, the end tools
  * at the trailing, the rail itself carrying the toolbar role so
  * assistive tech reads it as one group of commands. */
-export declare function Toolbar({ label, start, end, children, ...rest }: ToolbarProps): import("react").JSX.Element;
+declare function ToolbarImpl({ label, start, end, children, ...rest }: ToolbarProps): import("react").JSX.Element;
+export declare const Toolbar: typeof ToolbarImpl & {
+  Root: typeof ToolbarImpl;
+};
 //#endregion

package/dist/components/toolbar/index.mjs

@@ -1,10 +1,11 @@
-import { injectComponentStyle } from "@bysages/core";
+import { t as withSelfRoot } from "../../family-DE_GQeeM.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/toolbar/index.tsx
 /** A workbench rail: the start tools at the leading edge, the end tools
 * at the trailing, the rail itself carrying the toolbar role so
 * assistive tech reads it as one group of commands. */
-function Toolbar({ label, start, end, children, ...rest }) {
+function ToolbarImpl({ label, start, end, children, ...rest }) {
 	injectComponentStyle("toolbar");
 	return /* @__PURE__ */ jsxs("div", {
 		...rest,
@@ -25,5 +26,6 @@ function Toolbar({ label, start, end, children, ...rest }) {
 		}) : null]
 	});
 }
+const Toolbar = withSelfRoot(ToolbarImpl);
 //#endregion
 export { Toolbar };

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

@@ -1,7 +1,20 @@
+import { ReactNode } from "react";
 import { Tooltip as Tooltip$1 } from "@ark-ui/react/tooltip";
 //#region src/components/tooltip/index.d.ts
-/** Ark's Tooltip, dressed in the paper-and-ink system: the smallest
- * vessel — a tight chip of ink that dissolves in over its anchor. The
- * API is Ark's own — Root, Trigger, Positioner, Content, Arrow, ArrowTip. */
-export declare const Tooltip: typeof Tooltip$1;
+type TooltipPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "left-start" | "left-end" | "right" | "right-start" | "right-end";
+export interface TooltipFacadeProps {
+  open?: boolean;
+  defaultOpen?: boolean;
+  trigger: ReactNode;
+  content: string;
+  disabled?: boolean;
+  placement?: TooltipPlacement;
+  onOpenChange?: (open: boolean) => void;
+}
+declare function TooltipFacade({ open, defaultOpen, trigger, content, disabled, placement, onOpenChange }: TooltipFacadeProps): import("react").JSX.Element;
+declare namespace TooltipFacade {
+  var displayName: string;
+}
+type TooltipParts = typeof Tooltip$1;
+export declare const Tooltip: typeof TooltipFacade & TooltipParts;
 //#endregion