@bysages/react 0.3.1 → 0.4.1

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

@@ -1,3 +1,4 @@
+import { Menu } from "../menu/index.mjs";
 import { HTMLAttributes } from "react";
 //#region src/components/menubar/index.d.ts
 export interface MenubarEntry {
@@ -28,5 +29,6 @@ export interface MenubarProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSe
   /** Called with the entry's `value` when it is chosen. */
   onSelect?: (value: string) => void;
 }
-export declare function Menubar({ items, onSelect, children, ...rest }: MenubarProps): import("react").JSX.Element;
+declare function MenubarImpl({ items, onSelect, children, ...rest }: MenubarProps): import("react").JSX.Element;
+export declare const Menubar: typeof MenubarImpl & typeof Menu;
 //#endregion

package/dist/components/menubar/index.mjs

@@ -1,17 +1,21 @@
-import { injectComponentStyle } from "@bysages/core";
+import { t as useElementId } from "../../id-C37UYLwJ.mjs";
+import { Menu as Menu$1 } from "../menu/index.mjs";
+import { injectComponentStyle } from "@bysages/core/styling";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Portal } from "@ark-ui/react/portal";
 import { Menu } from "@ark-ui/react/menu";
 //#region src/components/menubar/index.tsx
-function Menubar({ items, onSelect, children, ...rest }) {
+function MenubarImpl({ items, onSelect, children, ...rest }) {
 	injectComponentStyle("menubar");
 	injectComponentStyle("menu");
+	const hostId = useElementId("menubar", rest);
 	return /* @__PURE__ */ jsxs("div", {
 		...rest,
 		"data-scope": "menubar",
 		"data-part": "root",
 		role: "menubar",
 		children: [items.map((group) => /* @__PURE__ */ jsxs(Menu.Root, {
+			id: `${hostId}:menu:${group.label}`,
 			positioning: { placement: "bottom-start" },
 			children: [/* @__PURE__ */ jsx(Menu.Trigger, {
 				asChild: true,
@@ -32,5 +36,6 @@ function Menubar({ items, onSelect, children, ...rest }) {
 		}, group.label)), children]
 	});
 }
+const Menubar = Object.assign(MenubarImpl, Menu$1);
 //#endregion
 export { Menubar };

package/dist/components/meter/index.mjs

@@ -1,4 +1,4 @@
-import { injectComponentStyle } from "@bysages/core";
+import { injectComponentStyle } from "@bysages/core/styling";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 //#region src/components/meter/index.tsx
 function part(name, tag) {

package/dist/components/navigation-menu/index.d.mts

@@ -1,8 +1,32 @@
+import { ComponentProps } from "react";
 import { NavigationMenu as NavigationMenu$1 } from "@ark-ui/react/navigation-menu";
 //#region src/components/navigation-menu/index.d.ts
 /** Ark's NavigationMenu, dressed in the paper-and-ink system: a menubar of
  * ghost triggers with one sliding stroke of primary ink, opening the shared
  * popup vessel. The API is Ark's own — Root, List, Item, Trigger, Link,
  * Content, ViewportPositioner, Viewport, Indicator, ItemIndicator, Arrow. */
-export declare const NavigationMenu: typeof NavigationMenu$1;
+declare function NavigationMenuRoot(props: ComponentProps<typeof NavigationMenu$1.Root>): import("react").JSX.Element;
+declare function NavigationMenuLink(props: ComponentProps<typeof NavigationMenu$1.Link>): import("react").JSX.Element;
+/** One flat destination in the callable bar; grouped panels and mega
+ * menus stay on the anatomy. */
+export interface NavigationMenuLinkOption {
+  label: string;
+  href: string;
+  current?: boolean;
+  description?: string;
+}
+export interface NavigationMenuFacadeProps {
+  items: NavigationMenuLinkOption[];
+  orientation?: "horizontal" | "vertical";
+  className?: string;
+}
+declare function NavigationMenuFacade({ items, orientation, className }: NavigationMenuFacadeProps): import("react").JSX.Element;
+declare namespace NavigationMenuFacade {
+  var displayName: string;
+}
+type NavigationMenuParts = Omit<typeof NavigationMenu$1, "Root" | "Link"> & {
+  Root: typeof NavigationMenuRoot;
+  Link: typeof NavigationMenuLink;
+};
+export declare const NavigationMenu: typeof NavigationMenuFacade & NavigationMenuParts;
 //#endregion

package/dist/components/navigation-menu/index.mjs

@@ -1,11 +1,46 @@
-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 { NavigationMenu as NavigationMenu$1 } from "@ark-ui/react/navigation-menu";
 //#region src/components/navigation-menu/index.tsx
 /** Ark's NavigationMenu, dressed in the paper-and-ink system: a menubar of
 * ghost triggers with one sliding stroke of primary ink, opening the shared
 * popup vessel. The API is Ark's own — Root, List, Item, Trigger, Link,
 * Content, ViewportPositioner, Viewport, Indicator, ItemIndicator, Arrow. */
-const NavigationMenu = NavigationMenu$1;
+function NavigationMenuRoot(props) {
+	const id = useElementId("navigation-menu", props);
+	return /* @__PURE__ */ jsx(NavigationMenu$1.Root, {
+		...props,
+		id
+	});
+}
+function NavigationMenuLink(props) {
+	injectComponentStyle("navigation-menu");
+	return /* @__PURE__ */ jsx(NavigationMenu$1.Link, {
+		...props,
+		"data-motion": "ink-ripple"
+	});
+}
+function NavigationMenuFacade({ items, orientation = "horizontal", className }) {
+	return /* @__PURE__ */ jsx(NavigationMenuRoot, {
+		className,
+		orientation,
+		children: /* @__PURE__ */ jsx(NavigationMenu$1.List, { children: items.map((item) => /* @__PURE__ */ jsx(NavigationMenu$1.Item, {
+			value: item.href,
+			children: /* @__PURE__ */ jsxs(NavigationMenuLink, {
+				href: item.href,
+				current: item.current,
+				children: [/* @__PURE__ */ jsx("span", { children: item.label }), item.description ? /* @__PURE__ */ jsx("span", { children: item.description }) : null]
+			})
+		}, item.href)) })
+	});
+}
+NavigationMenuFacade.displayName = "SNavigationMenu";
+const NavigationMenu = Object.assign(NavigationMenuFacade, {
+	...NavigationMenu$1,
+	Root: NavigationMenuRoot,
+	Link: NavigationMenuLink
+});
 injectComponentStyle("navigation-menu");
 //#endregion
 export { NavigationMenu };

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

@@ -5,12 +5,34 @@ type NumberInputRootProps = ComponentProps<typeof NumberInput$1.Root> & {
   /** One rung of the control-height ladder for the field and its stepper. */
   size?: "sm" | "md" | "lg";
 };
-declare function NumberInputRoot({ size, ...rest }: NumberInputRootProps): import("react").JSX.Element;
-/** Ark's NumberInput, dressed in the paper-and-ink system: the stepper
- * rides inside the field as one seal split by a hairline, numbers set in
- * tabular figures. The API is Ark's own — Root, Label, Control, Input,
- * ValueText, IncrementTrigger, DecrementTrigger, Scrubber. */
-export declare const NumberInput: Omit<typeof NumberInput$1, "Root"> & {
+declare function NumberInputRoot(props: NumberInputRootProps): import("react").JSX.Element;
+interface NumberInputFacadeProps {
+  value?: string;
+  defaultValue?: string;
+  label?: string;
+  placeholder?: string;
+  min?: number;
+  max?: number;
+  step?: number;
+  disabled?: boolean;
+  invalid?: boolean;
+  required?: boolean;
+  size?: "sm" | "md" | "lg";
+  onValueChange?: (value: string) => void;
+}
+/** The one-tag path for a stepped number field; formatting, scrubbing,
+ * and locale rules stay on the anatomy. */
+declare function NumberInputFacade({ value, defaultValue, label, placeholder, min, max, step, disabled, invalid, required, size, onValueChange }: NumberInputFacadeProps): import("react").JSX.Element;
+export declare const NumberInput: typeof NumberInputFacade & {
   Root: typeof NumberInputRoot;
+  Context: (props: NumberInput$1.ContextProps) => import("react").ReactNode;
+  Control: import("react").ForwardRefExoticComponent<NumberInput$1.ControlProps & import("react").RefAttributes<HTMLDivElement>>;
+  DecrementTrigger: import("react").ForwardRefExoticComponent<NumberInput$1.DecrementTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+  IncrementTrigger: import("react").ForwardRefExoticComponent<NumberInput$1.IncrementTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+  Input: import("react").ForwardRefExoticComponent<NumberInput$1.InputProps & import("react").RefAttributes<HTMLInputElement>>;
+  Label: import("react").ForwardRefExoticComponent<NumberInput$1.LabelProps & import("react").RefAttributes<HTMLLabelElement>>;
+  RootProvider: import("react").ForwardRefExoticComponent<NumberInput$1.RootProviderProps & import("react").RefAttributes<HTMLDivElement>>;
+  Scrubber: import("react").ForwardRefExoticComponent<NumberInput$1.ScrubberProps & import("react").RefAttributes<HTMLDivElement>>;
+  ValueText: import("react").ForwardRefExoticComponent<NumberInput$1.ValueTextProps & import("react").RefAttributes<HTMLSpanElement>>;
 };
 //#endregion

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

@@ -1,21 +1,46 @@
-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 { NumberInput as NumberInput$1 } from "@ark-ui/react/number-input";
 //#region src/components/number-input/index.tsx
-function NumberInputRoot({ size = "md", ...rest }) {
+function NumberInputRoot(props) {
+	const id = useElementId("number-input", props);
+	const { size = "md", ...rest } = props;
 	return /* @__PURE__ */ jsx(NumberInput$1.Root, {
 		...rest,
+		id,
 		"data-size": size
 	});
 }
-/** Ark's NumberInput, dressed in the paper-and-ink system: the stepper
-* rides inside the field as one seal split by a hairline, numbers set in
-* tabular figures. The API is Ark's own — Root, Label, Control, Input,
-* ValueText, IncrementTrigger, DecrementTrigger, Scrubber. */
-const NumberInput = {
+/** The one-tag path for a stepped number field; formatting, scrubbing,
+* and locale rules stay on the anatomy. */
+function NumberInputFacade({ value, defaultValue, label, placeholder, min, max, step, disabled = false, invalid = false, required = false, size = "md", onValueChange }) {
+	return /* @__PURE__ */ jsxs(NumberInputRoot, {
+		size,
+		min,
+		max,
+		step,
+		disabled,
+		invalid,
+		required,
+		defaultValue,
+		...value === void 0 ? {} : {
+			value,
+			onValueChange: (details) => onValueChange?.(details.value)
+		},
+		children: [label ? /* @__PURE__ */ jsx(NumberInput$1.Label, { children: label }) : null, /* @__PURE__ */ jsxs(NumberInput$1.Control, { children: [
+			/* @__PURE__ */ jsx(NumberInput$1.Input, { placeholder }),
+			/* @__PURE__ */ jsx(NumberInput$1.Scrubber, { children: iconNode("pause") }),
+			/* @__PURE__ */ jsx(NumberInput$1.IncrementTrigger, { children: iconNode("chevron-up") }),
+			/* @__PURE__ */ jsx(NumberInput$1.DecrementTrigger, { children: iconNode("chevron-down") })
+		] })]
+	});
+}
+const NumberInput = Object.assign(NumberInputFacade, {
 	...NumberInput$1,
 	Root: NumberInputRoot
-};
+});
 injectComponentStyle("number-input");
 //#endregion
 export { NumberInput };

package/dist/components/order-list/index.d.mts

@@ -17,5 +17,8 @@ export interface OrderListProps extends HTMLAttributes<HTMLDivElement> {
  * the model is the order. Dragging rides the native drag events — a
  * hairline of primary ink marks the seam the row will land on — so
  * touch keeps the buttons as its route. */
-export declare function OrderList({ value, options, label, onValueChange, ...rest }: OrderListProps): import("react").JSX.Element;
+declare function OrderListImpl({ value, options, label, onValueChange, ...rest }: OrderListProps): import("react").JSX.Element;
+export declare const OrderList: typeof OrderListImpl & {
+  Root: typeof OrderListImpl;
+};
 //#endregion

package/dist/components/order-list/index.mjs

@@ -1,34 +1,35 @@
+import { t as iconNode } from "../../icon-BALgGtNK.mjs";
+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 { useRef, useState } from "react";
 //#region src/components/order-list/index.tsx
-const ARROWS = {
-	up: ["m18 15-6-6-6 6"],
-	down: ["m6 9 6 6 6-6"],
-	top: ["m18 15-6-6-6 6", "M5 4h14"],
-	bottom: ["m6 9 6 6 6-6", "M5 20h14"]
+const ORDER_ICONS = {
+	up: { name: "chevron-up" },
+	down: { name: "chevron-down" },
+	top: {
+		name: "chevron-up",
+		rail: `<path d="M5 4h14" />`
+	},
+	bottom: {
+		name: "chevron-down",
+		rail: `<path d="M5 20h14" />`
+	}
 };
-function arrowGlyph(paths) {
-	return /* @__PURE__ */ jsx("svg", {
-		viewBox: "0 0 24 24",
+function orderIcon(direction) {
+	const icon = ORDER_ICONS[direction];
+	return iconNode(icon.name, {
 		width: 12,
-		height: 12,
-		fill: "none",
-		stroke: "currentColor",
-		strokeWidth: 2,
-		strokeLinecap: "round",
-		strokeLinejoin: "round",
-		"aria-hidden": "true",
-		children: paths.map((d) => /* @__PURE__ */ jsx("path", { d }, d))
-	});
+		height: 12
+	}, icon.rail ?? "");
 }
 /** A ledger the reader may rewrite: rows move by grip or by the side
 * arrows, and the group reports the new order as the value itself —
 * the model is the order. Dragging rides the native drag events — a
 * hairline of primary ink marks the seam the row will land on — so
 * touch keeps the buttons as its route. */
-function OrderList({ value, options, label, onValueChange, ...rest }) {
+function OrderListImpl({ value, options, label, onValueChange, ...rest }) {
 	injectComponentStyle("order-list");
 	const messages = useComponentMessages();
 	const dragging = useRef(null);
@@ -119,36 +120,36 @@ function OrderList({ value, options, label, onValueChange, ...rest }) {
 							children: [
 								[
 									messages.orderList.toTop,
-									ARROWS.top,
+									"top",
 									-index,
 									0
 								],
 								[
 									messages.orderList.moveUp,
-									ARROWS.up,
+									"up",
 									-1,
 									0
 								],
 								[
 									messages.orderList.moveDown,
-									ARROWS.down,
+									"down",
 									1,
 									rows.length - 1
 								],
 								[
 									messages.orderList.toBottom,
-									ARROWS.bottom,
+									"bottom",
 									rows.length - 1 - index,
 									rows.length - 1
 								]
-							].map(([aria, paths, offset, edge]) => /* @__PURE__ */ jsx("button", {
+							].map(([aria, direction, offset, edge]) => /* @__PURE__ */ jsx("button", {
 								type: "button",
 								"aria-label": aria,
 								"data-scope": "order-list",
 								"data-part": "move",
 								disabled: index === edge,
 								onClick: () => move(option.value, offset),
-								children: arrowGlyph([...paths])
+								children: orderIcon(direction)
 							}, aria))
 						})
 					]
@@ -157,5 +158,6 @@ function OrderList({ value, options, label, onValueChange, ...rest }) {
 		})
 	});
 }
+const OrderList = withSelfRoot(OrderListImpl);
 //#endregion
 export { OrderList };

package/dist/components/page-header/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/page-header/index.tsx
 /** The page's face: an eyebrow whisper, a serif title, one line of

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

@@ -1,18 +1,38 @@
-import { ComponentProps } from "react";
+import { CSSProperties, ComponentProps } from "react";
 import { Pagination as Pagination$1 } from "@ark-ui/react/pagination";
 //#region src/components/pagination/index.d.ts
 type PaginationRootProps = ComponentProps<typeof Pagination$1.Root> & {
   /** One rung of the control-height ladder every page seal shares. */
   size?: "sm" | "md" | "lg";
 };
-declare function PaginationRoot({ size, ...rest }: PaginationRootProps): import("react").JSX.Element;
+declare function PaginationRoot(props: PaginationRootProps): import("react").JSX.Element;
 /**
  * Pagination — paged navigation.
  *
  * Parts: Root, Item (page seals), Ellipsis, PrevTrigger, NextTrigger,
  * FirstTrigger, LastTrigger. Items carry data-selected.
  */
-export declare const Pagination: Omit<typeof Pagination$1, "Root"> & {
+type PaginationFacadeProps = {
+  value?: number;
+  defaultValue?: number;
+  count?: number;
+  pageSize?: number;
+  defaultPageSize?: number;
+  siblingCount?: number;
+  label?: string;
+  size?: "sm" | "md" | "lg";
+  className?: string;
+  style?: CSSProperties;
+  onValueChange?: (page: number) => void;
+};
+declare const PaginationPrevTrigger: import("react").ForwardRefExoticComponent<Pagination$1.PrevTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+declare const PaginationNextTrigger: import("react").ForwardRefExoticComponent<Pagination$1.NextTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
+/** The complete pagination bar behind one page: count and page size become
+ * the visible ladder, with edge semantics left to anatomy. */
+declare function PaginationFacade(props: PaginationFacadeProps): import("react").JSX.Element;
+export declare const Pagination: typeof PaginationFacade & Omit<typeof Pagination$1, "Root" | "PrevTrigger" | "NextTrigger"> & {
   Root: typeof PaginationRoot;
+  PrevTrigger: typeof PaginationPrevTrigger;
+  NextTrigger: typeof PaginationNextTrigger;
 };
 //#endregion

package/dist/components/pagination/index.mjs

@@ -1,23 +1,68 @@
-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 { Pagination as Pagination$1 } from "@ark-ui/react/pagination";
 //#region src/components/pagination/index.tsx
-function PaginationRoot({ size = "md", ...rest }) {
+function PaginationRoot(props) {
+	injectComponentStyle("pagination");
+	const id = useElementId("pagination", props);
+	const { size = "md", ...rest } = props;
 	return /* @__PURE__ */ jsx(Pagination$1.Root, {
 		...rest,
+		id,
 		"data-size": size
 	});
 }
-/**
-* Pagination — paged navigation.
-*
-* Parts: Root, Item (page seals), Ellipsis, PrevTrigger, NextTrigger,
-* FirstTrigger, LastTrigger. Items carry data-selected.
-*/
-const Pagination = {
+const PaginationPrevTrigger = Pagination$1.PrevTrigger;
+const PaginationNextTrigger = Pagination$1.NextTrigger;
+/** The complete pagination bar behind one page: count and page size become
+* the visible ladder, with edge semantics left to anatomy. */
+function PaginationFacade(props) {
+	const { value, defaultValue, count = 0, pageSize, defaultPageSize, siblingCount = 1, label, size = "md", className, style, onValueChange } = props;
+	return /* @__PURE__ */ jsxs(PaginationRoot, {
+		size,
+		"aria-label": label,
+		count,
+		defaultPage: defaultValue,
+		page: value,
+		...pageSize === void 0 ? {} : { pageSize },
+		...defaultPageSize === void 0 ? {} : { defaultPageSize },
+		siblingCount,
+		className,
+		style,
+		onPageChange: (event) => onValueChange?.(event.page),
+		children: [
+			/* @__PURE__ */ jsx(PaginationPrevTrigger, {
+				"aria-label": "Previous page",
+				children: iconNode("chevron-left", {
+					width: 14,
+					height: 14
+				})
+			}),
+			/* @__PURE__ */ jsx(Pagination$1.Context, { children: (pagination) => pagination.pages.map((page, index) => page.type === "page" ? /* @__PURE__ */ jsx(Pagination$1.Item, {
+				type: "page",
+				value: page.value,
+				children: page.value
+			}, page.value) : /* @__PURE__ */ jsx(Pagination$1.Ellipsis, {
+				index,
+				children: "…"
+			}, `ellipsis-${index}`)) }),
+			/* @__PURE__ */ jsx(PaginationNextTrigger, {
+				"aria-label": "Next page",
+				children: iconNode("chevron-right", {
+					width: 14,
+					height: 14
+				})
+			})
+		]
+	});
+}
+const Pagination = Object.assign(PaginationFacade, {
 	...Pagination$1,
-	Root: PaginationRoot
-};
-injectComponentStyle("pagination");
+	Root: PaginationRoot,
+	PrevTrigger: PaginationPrevTrigger,
+	NextTrigger: PaginationNextTrigger
+});
 //#endregion
 export { Pagination };

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

@@ -5,12 +5,30 @@ type PasswordInputRootProps = ComponentProps<typeof PasswordInput$1.Root> & {
   /** One rung of the control-height ladder for the field and its eye. */
   size?: "sm" | "md" | "lg";
 };
-declare function PasswordInputRoot({ size, ...rest }: PasswordInputRootProps): import("react").JSX.Element;
-/** Ark's PasswordInput, dressed in the paper-and-ink system: the reveal
- * eye sits quiet at the field's edge and swaps in place — no shift, no
- * noise. The API is Ark's own — Root, Label, Control, Input, Indicator,
- * VisibilityTrigger. */
-export declare const PasswordInput: Omit<typeof PasswordInput$1, "Root"> & {
+declare function PasswordInputRoot(props: PasswordInputRootProps): import("react").JSX.Element;
+interface PasswordInputFacadeProps {
+  value?: string;
+  defaultValue?: string;
+  label?: string;
+  placeholder?: string;
+  autoComplete?: "current-password" | "new-password";
+  disabled?: boolean;
+  invalid?: boolean;
+  required?: boolean;
+  size?: "sm" | "md" | "lg";
+  onValueChange?: (value: string) => void;
+}
+/** The one-tag path: the masked field and reveal control. Visibility
+ * state, password-manager rules, and validation stay on the anatomy. */
+declare function PasswordInputFacade({ value, defaultValue, label, placeholder, autoComplete, disabled, invalid, required, size, onValueChange }: PasswordInputFacadeProps): import("react").JSX.Element;
+export declare const PasswordInput: typeof PasswordInputFacade & {
   Root: typeof PasswordInputRoot;
+  Context: (props: PasswordInput$1.ContextProps) => import("react").ReactNode;
+  Control: import("react").ForwardRefExoticComponent<PasswordInput$1.ControlProps & import("react").RefAttributes<HTMLDivElement>>;
+  Indicator: import("react").ForwardRefExoticComponent<PasswordInput$1.IndicatorProps & import("react").RefAttributes<HTMLSpanElement>>;
+  Input: import("react").ForwardRefExoticComponent<PasswordInput$1.InputProps & import("react").RefAttributes<HTMLInputElement>>;
+  Label: import("react").ForwardRefExoticComponent<PasswordInput$1.LabelProps & import("react").RefAttributes<HTMLLabelElement>>;
+  RootProvider: import("react").ForwardRefExoticComponent<PasswordInput$1.RootProviderProps & import("react").RefAttributes<HTMLDivElement>>;
+  VisibilityTrigger: import("react").ForwardRefExoticComponent<PasswordInput$1.VisibilityTriggerProps & import("react").RefAttributes<HTMLButtonElement>>;
 };
 //#endregion

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

@@ -1,21 +1,44 @@
-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 { PasswordInput as PasswordInput$1 } from "@ark-ui/react/password-input";
 //#region src/components/password-input/index.tsx
-function PasswordInputRoot({ size = "md", ...rest }) {
+function PasswordInputRoot(props) {
+	const id = useElementId("password-input", props);
+	const { size = "md", ...rest } = props;
 	return /* @__PURE__ */ jsx(PasswordInput$1.Root, {
 		...rest,
+		id,
 		"data-size": size
 	});
 }
-/** Ark's PasswordInput, dressed in the paper-and-ink system: the reveal
-* eye sits quiet at the field's edge and swaps in place — no shift, no
-* noise. The API is Ark's own — Root, Label, Control, Input, Indicator,
-* VisibilityTrigger. */
-const PasswordInput = {
+/** The one-tag path: the masked field and reveal control. Visibility
+* state, password-manager rules, and validation stay on the anatomy. */
+function PasswordInputFacade({ value, defaultValue, label, placeholder, autoComplete, disabled = false, invalid = false, required = false, size = "md", onValueChange }) {
+	return /* @__PURE__ */ jsxs(PasswordInputRoot, {
+		size,
+		autoComplete,
+		disabled,
+		invalid,
+		required,
+		children: [label ? /* @__PURE__ */ jsx(PasswordInput$1.Label, { children: label }) : null, /* @__PURE__ */ jsxs(PasswordInput$1.Control, { children: [/* @__PURE__ */ jsx(PasswordInput$1.Input, {
+			placeholder,
+			defaultValue,
+			...value === void 0 ? {} : {
+				value,
+				onChange: (event) => onValueChange?.(event.target.value)
+			}
+		}), /* @__PURE__ */ jsx(PasswordInput$1.VisibilityTrigger, { children: /* @__PURE__ */ jsx(PasswordInput$1.Indicator, {
+			fallback: iconNode("eye-off"),
+			children: iconNode("eye")
+		}) })] })]
+	});
+}
+const PasswordInput = Object.assign(PasswordInputFacade, {
 	...PasswordInput$1,
 	Root: PasswordInputRoot
-};
+});
 injectComponentStyle("password-input");
 //#endregion
 export { PasswordInput };

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

@@ -5,11 +5,29 @@ type PinInputRootProps = ComponentProps<typeof PinInput$1.Root> & {
   /** One rung of the control-height ladder each seal stands on. */
   size?: "sm" | "md" | "lg";
 };
-declare function PinInputRoot({ size, ...rest }: PinInputRootProps): import("react").JSX.Element;
-/** Ark's PinInput, dressed in the paper-and-ink system: one character per
- * square-cut seal, centered ink in tabular figures. The API is Ark's own —
- * Root, Label, Control, Input, HiddenInput. */
-export declare const PinInput: Omit<typeof PinInput$1, "Root"> & {
+declare function PinInputRoot(props: PinInputRootProps): import("react").JSX.Element;
+interface PinInputFacadeProps {
+  value?: string[];
+  defaultValue?: string[];
+  label?: string;
+  placeholder?: string;
+  disabled?: boolean;
+  invalid?: boolean;
+  required?: boolean;
+  length?: number;
+  size?: "sm" | "md" | "lg";
+  onValueChange?: (value: string[]) => void;
+}
+/** The one-tag path for an even run of seals; OTP, masks, and custom
+ * validation stay on the anatomy. */
+declare function PinInputFacade({ value, defaultValue, label, placeholder, disabled, invalid, required, length, size, onValueChange }: PinInputFacadeProps): import("react").JSX.Element;
+export declare const PinInput: typeof PinInputFacade & {
   Root: typeof PinInputRoot;
+  Context: (props: PinInput$1.ContextProps) => import("react").ReactNode;
+  Control: import("react").ForwardRefExoticComponent<PinInput$1.ControlProps & import("react").RefAttributes<HTMLDivElement>>;
+  HiddenInput: import("react").ForwardRefExoticComponent<PinInput$1.HiddenInputProps & import("react").RefAttributes<HTMLInputElement>>;
+  Input: import("react").ForwardRefExoticComponent<PinInput$1.InputProps & import("react").RefAttributes<HTMLInputElement>>;
+  Label: import("react").ForwardRefExoticComponent<PinInput$1.LabelProps & import("react").RefAttributes<HTMLLabelElement>>;
+  RootProvider: import("react").ForwardRefExoticComponent<PinInput$1.RootProviderProps & import("react").RefAttributes<HTMLDivElement>>;
 };
 //#endregion