@bysages/solid 0.2.1 → 0.2.3

package/dist/components/autocomplete/index.mjs

@@ -0,0 +1,75 @@
+import { injectComponentStyle } from "@bysages/core";
+import { Portal, createComponent, mergeProps } from "solid-js/web";
+import { For, splitProps } from "solid-js";
+import { useListCollection } from "@ark-ui/solid/collection";
+import { Combobox } from "@ark-ui/solid/combobox";
+//#region src/components/autocomplete/index.tsx
+/**
+* Free text with suggestions: the reader types anything, the list
+* narrows to help, and both a pick and a custom value end up in the
+* same `value`. A preset of the combobox machinery — same parts,
+* same styling, one job. `items` seeds the suggestion list once;
+* matching is a case-insensitive substring unless `filter` says
+* otherwise.
+*/
+function AutoComplete(props) {
+	injectComponentStyle("combobox");
+	const [own, rest] = splitProps(props, [
+		"value",
+		"items",
+		"placeholder",
+		"size",
+		"filter",
+		"onValueChange"
+	]);
+	const { collection, filter } = useListCollection({
+		initialItems: own.items ?? [],
+		filter: (item, input) => own.filter ? own.filter(item, input) : item.toLowerCase().includes(input.toLowerCase())
+	});
+	return createComponent(Combobox.Root, mergeProps(rest, {
+		get collection() {
+			return collection();
+		},
+		get inputValue() {
+			return own.value;
+		},
+		get ["data-size"]() {
+			return own.size ?? "md";
+		},
+		allowCustomValue: true,
+		onValueChange: (details) => {
+			const [first] = details.value;
+			if (first != null) own.onValueChange?.(first);
+		},
+		onInputValueChange: (details) => {
+			filter(details.inputValue);
+			own.onValueChange?.(details.inputValue);
+		},
+		positioning: { sameWidth: true },
+		get children() {
+			return [createComponent(Combobox.Control, { get children() {
+				return createComponent(Combobox.Input, { get placeholder() {
+					return own.placeholder;
+				} });
+			} }), createComponent(Portal, { get children() {
+				return createComponent(Combobox.Positioner, { get children() {
+					return createComponent(Combobox.Content, { get children() {
+						return [createComponent(Combobox.Empty, { children: "No matches" }), createComponent(For, {
+							get each() {
+								return collection().items;
+							},
+							children: (item) => createComponent(Combobox.Item, {
+								item,
+								get children() {
+									return createComponent(Combobox.ItemText, { children: item });
+								}
+							})
+						})];
+					} });
+				} });
+			} })];
+		}
+	}));
+}
+//#endregion
+export { AutoComplete };

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

@@ -0,0 +1,20 @@
+import { ComponentProps } from "solid-js";
+import { Avatar as Avatar$1 } from "@ark-ui/solid/avatar";
+//#region src/components/avatar/index.d.ts
+/** Avatar, dressed in the paper-and-ink system: a circular seal on
+ * inset paper that holds initials until the image loads over them.
+ * `size` picks a control-height rung for the seal — the core styles
+ * re-point `--bs-avatar-size` per rung, and scenes can still retune the
+ * variable directly. */
+export type AvatarSize = "sm" | "md" | "lg";
+export interface AvatarProps extends ComponentProps<typeof Avatar$1.Root> {
+  /** Seal diameter: the small, medium, or large control rung. The
+   * default (large) stands as tall as the biggest control so an avatar
+   * rides a row without stretching it. */
+  size?: AvatarSize;
+}
+declare function AvatarRoot(props: AvatarProps): import("solid-js").JSX.Element;
+export declare const Avatar: typeof Avatar$1 & {
+  Root: typeof AvatarRoot;
+};
+//#endregion

package/dist/components/avatar/index.mjs

@@ -0,0 +1,15 @@
+import { injectComponentStyle } from "@bysages/core";
+import { createComponent, mergeProps } from "solid-js/web";
+import { splitProps } from "solid-js";
+import { Avatar as Avatar$1 } from "@ark-ui/solid/avatar";
+//#region src/components/avatar/index.tsx
+function AvatarRoot(props) {
+	const [own, rest] = splitProps(props, ["size"]);
+	return createComponent(Avatar$1.Root, mergeProps(rest, { get ["data-size"]() {
+		return own.size;
+	} }));
+}
+const Avatar = Object.assign({}, Avatar$1, { Root: AvatarRoot });
+injectComponentStyle("avatar");
+//#endregion
+export { Avatar };

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

@@ -0,0 +1,11 @@
+import { JSX } from "solid-js";
+//#region src/components/avatar-group/index.d.ts
+/** Avatars overlapping one row, each rimmed in the ground so the pile
+ * stays legible. */
+export interface AvatarGroupProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  /** One register for every seal: falls onto data-size for the
+   * stylesheet to re-point the avatars' measure. */
+  size?: "sm" | "md" | "lg";
+}
+export declare function AvatarGroup(props: AvatarGroupProps): JSX.Element;
+//#endregion

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

@@ -0,0 +1,22 @@
+import { injectComponentStyle } from "@bysages/core";
+import { mergeProps, spread, template } from "solid-js/web";
+import { splitProps } from "solid-js";
+//#region src/components/avatar-group/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<div>`);
+function AvatarGroup(props) {
+	injectComponentStyle("avatar-group");
+	const [own, rest] = splitProps(props, ["size"]);
+	return (() => {
+		var _el$ = _tmpl$();
+		spread(_el$, mergeProps(rest, {
+			"data-scope": "avatar-group",
+			"data-part": "root",
+			get ["data-size"]() {
+				return own.size;
+			}
+		}), false, false);
+		return _el$;
+	})();
+}
+//#endregion
+export { AvatarGroup };

package/dist/components/back-top/index.d.mts

@@ -0,0 +1,29 @@
+import { JSX } from "solid-js";
+//#region src/components/back-top/index.d.ts
+export interface BackTopProps extends JSX.HTMLAttributes<HTMLButtonElement> {
+  /** How far the reader must have travelled (px) before the affordance
+   * appears. */
+  threshold?: number;
+  /** The accessible name; the control is icon-only by default. */
+  label?: string;
+  /** Ride a scrolling element of your own instead of the page: the
+   * control moors inside that element's corner and watches its
+   * scrollTop. The host supplies the positioning context. */
+  scrollEl?: () => HTMLElement | null;
+}
+/**
+ * A way home: after the page has scrolled past `threshold`, a small
+ * floating control rises at the page's corner and returns the reader to
+ * the top. The scroll itself stays native — `window.scrollTo` defers to
+ * the stylesheet's `scroll-behavior: smooth`, which reduced motion turns
+ * back into an instant jump (a moored control asks the media query
+ * directly, since a scroller of its own has no stylesheet to defer to).
+ * The button stays mounted either way so the entrance is a transition,
+ * never a pop.
+ *
+ * The control itself is the shared `Button` (outline, square) — the
+ * paper, hairline and halo are its; this family owns only the floating
+ * and the entrance.
+ */
+export declare function BackTop(props: BackTopProps): JSX.Element;
+//#endregion

package/dist/components/back-top/index.mjs

@@ -0,0 +1,89 @@
+import { Button } from "../button/index.mjs";
+import { injectComponentStyle } from "@bysages/core";
+import { createComponent, insert, mergeProps, spread, template } from "solid-js/web";
+import { createSignal, onCleanup, onMount, splitProps } from "solid-js";
+//#region src/components/back-top/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<div data-scope=back-top data-part=root>`);
+var _tmpl$2 = /*#__PURE__*/ template(`<svg width=16 height=16 viewBox="0 0 24 24"fill=none stroke=currentColor stroke-width=1.75 stroke-linecap=round stroke-linejoin=round aria-hidden=true><path d="m6 14 6-6 6 6">`);
+/**
+* A way home: after the page has scrolled past `threshold`, a small
+* floating control rises at the page's corner and returns the reader to
+* the top. The scroll itself stays native — `window.scrollTo` defers to
+* the stylesheet's `scroll-behavior: smooth`, which reduced motion turns
+* back into an instant jump (a moored control asks the media query
+* directly, since a scroller of its own has no stylesheet to defer to).
+* The button stays mounted either way so the entrance is a transition,
+* never a pop.
+*
+* The control itself is the shared `Button` (outline, square) — the
+* paper, hairline and halo are its; this family owns only the floating
+* and the entrance.
+*/
+function BackTop(props) {
+	injectComponentStyle("back-top");
+	const [own, rest] = splitProps(props, [
+		"threshold",
+		"label",
+		"scrollEl"
+	]);
+	const [visible, setVisible] = createSignal(false);
+	const scroller = () => own.scrollEl?.() ?? null;
+	const onScroll = () => {
+		const el = scroller();
+		setVisible((el ? el.scrollTop : window.scrollY) > (own.threshold ?? 400));
+	};
+	const toTop = () => {
+		const el = scroller();
+		if (!el) {
+			window.scrollTo({ top: 0 });
+			return;
+		}
+		const reduce = window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+		el.scrollTo({
+			top: 0,
+			behavior: reduce ? "auto" : "smooth"
+		});
+	};
+	onMount(() => {
+		const el = scroller();
+		onScroll();
+		if (el) el.addEventListener("scroll", onScroll, { passive: true });
+		else window.addEventListener("scroll", onScroll, { passive: true });
+	});
+	onCleanup(() => {
+		const el = scroller();
+		if (el) el.removeEventListener("scroll", onScroll);
+		else window.removeEventListener("scroll", onScroll);
+	});
+	return (() => {
+		var _el$ = _tmpl$();
+		spread(_el$, mergeProps({ get ["data-state"]() {
+			return visible() ? "shown" : "hidden";
+		} }, () => scroller() ? { "data-container": "" } : {}), false, true);
+		insert(_el$, createComponent(Button, mergeProps(rest, {
+			variant: "outline",
+			square: true,
+			size: "lg",
+			get ["aria-label"]() {
+				return own.label ?? "Back to top";
+			},
+			get ["aria-hidden"]() {
+				return visible() ? void 0 : "true";
+			},
+			get tabindex() {
+				return visible() ? 0 : -1;
+			},
+			onClick: toTop,
+			get children() {
+				return rest.children ?? chevronUp();
+			}
+		})));
+		return _el$;
+	})();
+}
+/** The single glyph a way-home control needs: one stroke pointing up. */
+function chevronUp() {
+	return _tmpl$2();
+}
+//#endregion
+export { BackTop };

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

@@ -0,0 +1,10 @@
+import { JSX } from "solid-js";
+//#region src/components/badge/index.d.ts
+/** A small seal of state. Ink is the neutral tone; the four semantic
+ * pigments are fixed. Subtle and outline re-register the same pigment. */
+export interface BadgeProps extends JSX.HTMLAttributes<HTMLSpanElement> {
+  tone?: "ink" | "info" | "success" | "warning" | "danger";
+  variant?: "solid" | "subtle" | "outline";
+}
+export declare function Badge(props: BadgeProps): JSX.Element;
+//#endregion

package/dist/components/badge/index.mjs

@@ -0,0 +1,25 @@
+import { injectComponentStyle } from "@bysages/core";
+import { mergeProps, spread, template } from "solid-js/web";
+import { splitProps } from "solid-js";
+//#region src/components/badge/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<span>`);
+function Badge(props) {
+	injectComponentStyle("badge");
+	const [own, rest] = splitProps(props, ["tone", "variant"]);
+	return (() => {
+		var _el$ = _tmpl$();
+		spread(_el$, mergeProps(rest, {
+			"data-scope": "badge",
+			"data-part": "root",
+			get ["data-tone"]() {
+				return own.tone ?? "ink";
+			},
+			get ["data-variant"]() {
+				return own.variant ?? "solid";
+			}
+		}), false, false);
+		return _el$;
+	})();
+}
+//#endregion
+export { Badge };

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

@@ -0,0 +1,24 @@
+import { JSX } from "solid-js";
+//#region src/components/banner/index.d.ts
+export type BannerStatus = "ink" | "info" | "success" | "warning" | "danger";
+export interface BannerRootProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  status?: BannerStatus;
+}
+/** A page-level notice, spoken across the full measure: a wash of the
+ * status pigment, one heavier hairline on the leading edge, and room
+ * for actions and a quiet close. Ink is the neutral register; the four
+ * semantic pigments are fixed. */
+declare function Root(props: BannerRootProps): JSX.Element;
+/** The quiet close: a plain square-cut button; dismissal stays the
+ * consumer's state. */
+declare function Close(props: JSX.ButtonHTMLAttributes<HTMLButtonElement>): JSX.Element;
+export declare const Banner: typeof Root & {
+  Root: typeof Root;
+  Icon: (props: JSX.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+  Body: (props: JSX.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+  Title: (props: JSX.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+  Description: (props: JSX.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+  Actions: (props: JSX.HTMLAttributes<HTMLDivElement>) => JSX.Element;
+  Close: typeof Close;
+};
+//#endregion

package/dist/components/banner/index.mjs

@@ -0,0 +1,71 @@
+import { injectComponentStyle } from "@bysages/core";
+import { createComponent, mergeProps, spread, template } from "solid-js/web";
+import { splitProps } from "solid-js";
+//#region src/components/banner/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<div>`);
+var _tmpl$2 = /*#__PURE__*/ template(`<button><svg viewBox="0 0 16 16"fill=none aria-hidden=true><path d="M4 4l8 8M12 4l-8 8"stroke=currentColor stroke-width=1.5 stroke-linecap=round>`);
+/** A page-level notice, spoken across the full measure: a wash of the
+* status pigment, one heavier hairline on the leading edge, and room
+* for actions and a quiet close. Ink is the neutral register; the four
+* semantic pigments are fixed. */
+function Root(props) {
+	const [own, rest] = splitProps(props, ["status"]);
+	const status = own.status ?? "ink";
+	return (() => {
+		var _el$ = _tmpl$();
+		spread(_el$, mergeProps(rest, {
+			"role": status === "ink" ? void 0 : "status",
+			"data-scope": "banner",
+			"data-part": "root",
+			"data-status": status
+		}), false, false);
+		return _el$;
+	})();
+}
+function part(name, tag) {
+	function Component(props) {
+		return createComponent(tag, mergeProps(props, {
+			"data-scope": "banner",
+			get ["data-part"]() {
+				return name.toLowerCase();
+			}
+		}));
+	}
+	return Component;
+}
+const Icon = part("Icon", "span");
+const Body = part("Body", "div");
+const Title = part("Title", "p");
+const Description = part("Description", "p");
+const Actions = part("Actions", "div");
+/** The quiet close: a plain square-cut button; dismissal stays the
+* consumer's state. */
+function Close(props) {
+	const [own, rest] = splitProps(props, ["type"]);
+	return (() => {
+		var _el$2 = _tmpl$2();
+		spread(_el$2, mergeProps(rest, {
+			get type() {
+				return own.type ?? "button";
+			},
+			get ["aria-label"]() {
+				return rest["aria-label"] ?? "Dismiss";
+			},
+			"data-scope": "banner",
+			"data-part": "close"
+		}), false, true);
+		return _el$2;
+	})();
+}
+const Banner = Object.assign(Root, {
+	Root,
+	Icon,
+	Body,
+	Title,
+	Description,
+	Actions,
+	Close
+});
+injectComponentStyle("banner");
+//#endregion
+export { Banner };

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

@@ -0,0 +1,11 @@
+import { Component, JSX } from "solid-js";
+//#region src/components/breadcrumb/index.d.ts
+export declare const Breadcrumb: Component<Record<string, unknown>> & {
+  Root: Component<Record<string, unknown>>;
+  List: Component<Record<string, unknown>>;
+  Item: Component<Record<string, unknown>>;
+  Link: Component<Record<string, unknown>>;
+  Current: Component<Record<string, unknown>>;
+  Separator: Component<JSX.HTMLAttributes<HTMLSpanElement>>;
+};
+//#endregion

package/dist/components/breadcrumb/index.mjs

@@ -0,0 +1,43 @@
+import { injectComponentStyle } from "@bysages/core";
+import { createComponent, mergeProps, spread, template } from "solid-js/web";
+import { mergeProps as mergeProps$1 } from "solid-js";
+//#region src/components/breadcrumb/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<span>`);
+/** A trail of waymarks: Root wraps the nav, List the ordered trail, and
+* each Item carries a Link — or the Current page — parted by a quiet
+* Separator. Links take href and the rest through attributes. */
+function part(name, tag, extra = {}) {
+	return ((props) => {
+		return createComponent(tag, mergeProps(extra, props, {
+			"data-scope": "breadcrumb",
+			get ["data-part"]() {
+				return name.toLowerCase();
+			}
+		}));
+	});
+}
+const Root = part("Root", "nav", { "aria-label": "Breadcrumb" });
+const List = part("List", "ol");
+const Item = part("Item", "li");
+const Link = part("Link", "a");
+const Current = part("Current", "span", { "aria-current": "page" });
+const Separator = (props) => (() => {
+	var _el$ = _tmpl$();
+	spread(_el$, mergeProps(() => mergeProps$1({ children: "/" }, props), {
+		"aria-hidden": "true",
+		"data-scope": "breadcrumb",
+		"data-part": "separator"
+	}), false, false);
+	return _el$;
+})();
+const Breadcrumb = Object.assign(Root, {
+	Root,
+	List,
+	Item,
+	Link,
+	Current,
+	Separator
+});
+injectComponentStyle("breadcrumb");
+//#endregion
+export { Breadcrumb };

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

@@ -0,0 +1,15 @@
+import { JSX } from "solid-js";
+//#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. The react package's asChild has
+ * no solid equivalent — compose a control around `<Button>` instead. */
+export interface ButtonProps extends JSX.ButtonHTMLAttributes<HTMLButtonElement> {
+  variant?: "solid" | "outline" | "ghost" | "subtle";
+  tone?: "ink" | "info" | "success" | "warning" | "danger";
+  size?: "sm" | "md" | "lg";
+  /** Icon-only: the silhouette squares to the control height. */
+  square?: boolean;
+}
+export declare function Button(props: ButtonProps): JSX.Element;
+//#endregion

package/dist/components/button/index.mjs

@@ -0,0 +1,45 @@
+import { injectComponentStyle } from "@bysages/core";
+import { mergeProps, spread, template } from "solid-js/web";
+import { splitProps } from "solid-js";
+//#region src/components/button/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<button>`);
+function Button(props) {
+	injectComponentStyle("button");
+	const [own, rest] = splitProps(props, [
+		"variant",
+		"tone",
+		"size",
+		"square",
+		"type",
+		"disabled"
+	]);
+	return (() => {
+		var _el$ = _tmpl$();
+		spread(_el$, mergeProps(rest, {
+			get type() {
+				return own.type ?? "button";
+			},
+			get disabled() {
+				return own.disabled;
+			},
+			"data-scope": "button",
+			"data-part": "root",
+			get ["data-variant"]() {
+				return own.variant ?? "solid";
+			},
+			get ["data-tone"]() {
+				return own.tone ?? "ink";
+			},
+			get ["data-size"]() {
+				return own.size ?? "md";
+			},
+			get ["data-square"]() {
+				return own.square ? "true" : void 0;
+			},
+			"data-motion": "ink-ripple lit"
+		}), false, false);
+		return _el$;
+	})();
+}
+//#endregion
+export { Button };

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

@@ -0,0 +1,23 @@
+import { JSX } from "solid-js";
+//#region src/components/button-group/index.d.ts
+export interface ButtonGroupProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  /** The seam runs across the group (default) or down it. */
+  orientation?: "horizontal" | "vertical";
+  /** One register for every member: falls onto data-size for the
+   * stylesheet to retune the buttons' heights. */
+  size?: "sm" | "md" | "lg";
+  /** The members' corner register: retunes --bs-radius-control for the
+   * whole fused shape — edges and trimmed seams keep one story. */
+  radius?: "sm" | "md" | "lg" | "xl" | "2xl" | "full";
+}
+/**
+ * Buttons fused into one control: the group owns only the joinery, so
+ * members keep every variant they were given — a solid action can sit
+ * beside an outline one and the seam still reads. Selection belongs to
+ * the toggle group; this is layout alone.
+ */
+export declare function ButtonGroupRoot(props: ButtonGroupProps): JSX.Element;
+export declare const ButtonGroup: typeof ButtonGroupRoot & {
+  Root: typeof ButtonGroupRoot;
+};
+//#endregion

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

@@ -0,0 +1,40 @@
+import { injectComponentStyle } from "@bysages/core";
+import { mergeProps, spread, template } from "solid-js/web";
+import { splitProps } from "solid-js";
+//#region src/components/button-group/index.tsx
+var _tmpl$ = /*#__PURE__*/ template(`<div>`);
+/**
+* Buttons fused into one control: the group owns only the joinery, so
+* members keep every variant they were given — a solid action can sit
+* beside an outline one and the seam still reads. Selection belongs to
+* the toggle group; this is layout alone.
+*/
+function ButtonGroupRoot(props) {
+	injectComponentStyle("button-group");
+	const [own, rest] = splitProps(props, [
+		"orientation",
+		"size",
+		"radius"
+	]);
+	return (() => {
+		var _el$ = _tmpl$();
+		spread(_el$, mergeProps(rest, {
+			"role": "group",
+			"data-scope": "button-group",
+			"data-part": "root",
+			get ["data-orientation"]() {
+				return own.orientation ?? "horizontal";
+			},
+			get ["data-size"]() {
+				return own.size;
+			},
+			get ["data-radius"]() {
+				return own.radius;
+			}
+		}), false, false);
+		return _el$;
+	})();
+}
+const ButtonGroup = Object.assign(ButtonGroupRoot, { Root: ButtonGroupRoot });
+//#endregion
+export { ButtonGroup, ButtonGroupRoot };

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

@@ -0,0 +1,17 @@
+import { JSX } from "solid-js";
+import { DatePickerRootProps } from "@ark-ui/solid/date-picker";
+//#region src/components/calendar/index.d.ts
+export interface CalendarProps extends JSX.HTMLAttributes<HTMLDivElement> {
+  /** Selected date(s) — an array, as the machine speaks in ranges. */
+  value?: DatePickerRootProps["value"];
+  min?: DatePickerRootProps["min"];
+  max?: DatePickerRootProps["max"];
+  onValueChange?: (value: NonNullable<DatePickerRootProps["value"]>) => void;
+}
+/** The date-picker's month grid, standing on the page without its
+ * popup: always open, the trigger gone, the vessel a quiet card. The
+ * title zooms out through month and year grids; the grids themselves
+ * are the shared machinery — value, range selection, and focus ride
+ * Ark's own contract. */
+export declare function Calendar(props: CalendarProps): JSX.Element;
+//#endregion