@slotted/react 0.1.0-beta.3 → 0.1.0-beta.5

package/README.md

@@ -43,7 +43,22 @@ import { PT_BR } from '@slotted/core/i18n/pt-BR';
 
 ## Agents
 
-`dist/docs/AGENTS.snippet.md` is the section an application adds to the instructions its coding agent reads: `AGENTS.md`, or `CLAUDE.md` for Claude Code, directly or through `@AGENTS.md`. It points the agent at the family pages, the guidelines and the skills of the installed version.
+`dist/docs/AGENTS.snippet.md` is the section an application adds to the instructions its coding agent reads. It points the agent at the family pages, the guidelines and the skills of the installed version. The `slotted-agent-docs` command keeps it there, and keeps the skills where the agent finds them:
+
+```sh
+# Writes the snippet between <!-- slotted:begin --> and <!-- slotted:end --> in the file; the rest of the file is left as it is.
+slotted-agent-docs instructions write --file AGENTS.md
+# An instruction file outside the directory that holds node_modules names that directory, relative to the file.
+slotted-agent-docs instructions write --file ../AGENTS.md --app-root web
+# An application with its own theme.
+slotted-agent-docs instructions write --file AGENTS.md --theme brand --theme-css @acme/brand/theme.css
+# One entry per skill: a relative link, or a copy for an agent that does not follow links.
+slotted-agent-docs skills link --dir .agents/skills [--mode copy]
+```
+
+`instructions check` and `skills check` take the same arguments, print what differs, and exit 1 when the file or the directory is not what the matching write would produce: a `prepare` script runs the writes, CI runs the checks.
+
+Skill directories known to agents, as documentation only: `.agents/skills`, `.claude/skills`, `.github/skills`. Instruction files: `AGENTS.md`, `CLAUDE.md`, `.github/copilot-instructions.md`, `GEMINI.md`.
 
 ## License
 

package/dist/{accordion-D-YuMJzk.js → accordion-lCqrmQ3w.js}

@@ -1,10 +1,10 @@
 import { isHeldOpen as e, nextOpenValues as t, sameOpenValues as n } from "@slotted/core/disclosure";
 import { createArrowNavigation as r } from "@slotted/core/focus";
 import { createControllable as i } from "@slotted/core/state";
-import { createContext as a, useContext as o, useEffect as s, useImperativeHandle as c, useState as l } from "react";
-import { jsx as u } from "react/jsx-runtime";
+import { createContext as a, useContext as o, useEffect as s, useImperativeHandle as c, useRef as l, useState as u } from "react";
+import { jsx as d } from "react/jsx-runtime";
 //#region src/accordion/accordion-defaults.tsx
-var d = a({
+var f = a({
 	headingLevel: "3",
 	indicator: "chevron",
 	loop: !0,
@@ -16,12 +16,12 @@ var d = a({
 	truncate: !1,
 	variant: "ruled"
 });
-function f() {
-	return o(d);
+function p() {
+	return o(f);
 }
-function p({ children: e, ...t }) {
-	let n = f();
-	return /* @__PURE__ */ u(d.Provider, {
+function m({ children: e, ...t }) {
+	let n = p();
+	return /* @__PURE__ */ d(f.Provider, {
 		value: {
 			headingLevel: t.headingLevel ?? n.headingLevel,
 			indicator: t.indicator ?? n.indicator,
@@ -39,87 +39,87 @@ function p({ children: e, ...t }) {
 }
 //#endregion
 //#region src/accordion/accordion.tsx
-var m = ":scope > * > [data-part=\"header\"] > [data-part=\"trigger\"]", h = {
+var h = ":scope > * > [data-part=\"header\"] > [data-part=\"trigger\"]", g = {
 	plain: "plain",
 	ruled: "ruled",
 	framed: "ruled",
 	separated: "framed"
-}, g = a(void 0);
-function _(e) {
+}, _ = a(void 0);
+function v(e) {
 	return e === null ? [] : [...e.querySelectorAll(":scope > [data-value]")].map((e) => ({
 		disabled: e.hasAttribute("data-disabled"),
 		value: e.getAttribute("data-value") ?? ""
 	}));
 }
-function v() {
-	return o(g);
+function y() {
+	return o(_);
 }
-function y({ children: a, className: o, defaultValue: d, disabled: p, handle: v, headingLevel: y, indicator: b, loop: x, mount: S, multiple: C, onValueChange: w, ref: T, render: E, requireOpen: D, size: O, style: k, togglePlacement: A, truncate: ee, value: j, variant: M, ...N }) {
-	let P = f(), [F, I] = l(d ?? []), L = j ?? F, [R, z] = l(null), B = p === !0, V = y ?? P.headingLevel, H = b ?? P.indicator, U = x ?? P.loop, W = S ?? P.mount, G = C ?? P.multiple, K = D ?? P.requireOpen, q = O ?? P.size, J = A ?? P.togglePlacement, Y = ee ?? P.truncate, X = M ?? P.variant, Z = {
+function b({ children: a, className: o, defaultValue: f, disabled: m, handle: y, headingLevel: b, indicator: x, loop: S, mount: C, multiple: w, onValueChange: T, ref: E, render: D, requireOpen: O, size: k, style: ee, togglePlacement: A, truncate: j, value: M, variant: N, ...P }) {
+	let F = p(), [I, L] = u(f ?? []), R = M ?? I, z = l(null), B = m === !0, V = b ?? F.headingLevel, H = x ?? F.indicator, U = S ?? F.loop, W = C ?? F.mount, G = w ?? F.multiple, K = O ?? F.requireOpen, q = k ?? F.size, J = A ?? F.togglePlacement, Y = j ?? F.truncate, X = N ?? F.variant, Z = {
 		multiple: G,
 		requireOpen: K
 	};
 	s(() => {
-		if (R === null) return;
-		let e = r(R, {
-			itemSelector: m,
+		let e = z.current;
+		if (e === null) return;
+		let t = r(e, {
+			itemSelector: h,
 			loop: U,
 			orientation: () => "vertical"
-		}), t = new MutationObserver(() => e.refresh());
-		return t.observe(R, {
+		}), n = new MutationObserver(() => t.refresh());
+		return n.observe(e, {
 			childList: !0,
 			subtree: !0
 		}), () => {
-			t.disconnect(), e.destroy();
+			n.disconnect(), t.destroy();
 		};
-	}, [R, U]);
+	}, [U]);
 	function Q(e, t, r) {
 		let a = !1, o = i({
-			controlled: j,
+			controlled: M,
 			equals: n,
-			initial: L,
+			initial: R,
 			onRequest: (e) => {
-				a = e.cancelled, w?.(e.value, e);
+				a = e.cancelled, T?.(e.value, e);
 			}
 		}).request(e, t, r);
-		a || o && I(e);
+		a || o && L(e);
 	}
 	let te = {
 		disabled: B,
 		indicator: H,
-		isHeld: (t) => e(L, t, Z),
-		isOpen: (e) => L.includes(e),
+		isHeld: (t) => e(R, t, Z),
+		isOpen: (e) => R.includes(e),
 		level: V,
 		mount: W,
 		size: q,
 		togglePlacement: J,
 		toggle: (e, n, r) => {
-			let i = t(L, e, Z);
-			i !== L && Q(i, n, r);
+			let i = t(R, e, Z);
+			i !== R && Q(i, n, r);
 		},
 		truncate: Y,
-		variant: h[X]
+		variant: g[X]
 	};
-	c(v, () => ({
+	c(y, () => ({
 		openAll: () => {
-			let e = _(R).filter((e) => !e.disabled).map((e) => e.value);
+			let e = v(z.current).filter((e) => !e.disabled).map((e) => e.value);
 			Q(G ? e : e.slice(0, 1), "programmatic", void 0);
 		},
 		closeAll: () => {
-			if (K && L.length > 0) {
-				Q(L.slice(0, 1), "programmatic", void 0);
+			if (K && R.length > 0) {
+				Q(R.slice(0, 1), "programmatic", void 0);
 				return;
 			}
 			Q([], "programmatic", void 0);
 		}
 	}), [
 		R,
-		L,
 		G,
 		K
 	]);
 	let $ = {
-		...N,
+		...P,
 		children: a,
 		className: o,
 		...B ? { "data-disabled": "" } : {},
@@ -127,17 +127,17 @@ function y({ children: a, className: o, defaultValue: d, disabled: p, handle: v,
 		"data-size": q,
 		"data-ui": "accordion",
 		"data-variant": X,
-		style: k
+		style: ee
 	};
-	return /* @__PURE__ */ u(g.Provider, {
+	return /* @__PURE__ */ d(_.Provider, {
 		value: te,
-		children: E === void 0 ? /* @__PURE__ */ u("div", {
+		children: D === void 0 ? /* @__PURE__ */ d("div", {
 			...$,
 			ref: (e) => {
-				z(e), typeof T == "function" ? T(e) : T != null && (T.current = e);
+				z.current = e, typeof E == "function" ? E(e) : E != null && (E.current = e);
 			}
-		}) : E($)
+		}) : D($)
 	});
 }
 //#endregion
-export { f as a, p as i, y as n, v as r, m as t };
+export { p as a, m as i, b as n, y as r, h as t };

package/dist/accordion.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, r, t as i } from "./accordion-D-YuMJzk.js";
+import { a as e, i as t, n, r, t as i } from "./accordion-lCqrmQ3w.js";
 export { i as ACCORDION_TRIGGER_SELECTOR, n as Accordion, t as AccordionDefaultsProvider, r as useAccordion, e as useAccordionDefaults };

package/dist/{action-bar-OACchRZw.js → action-bar-ti3e6FK1.js}

@@ -1,6 +1,6 @@
 import { t as e } from "./button-defaults-DNq_DDJh.js";
 import { n as t, t as n } from "./icon-T9Yt4tnm.js";
-import { _ as r, g as i, n as a, t as o } from "./menu-parts-W58pVNUt.js";
+import { _ as r, g as i, n as a, t as o } from "./menu-parts-D6v_mz6O.js";
 import { Fragment as s, createContext as c, useCallback as l, useContext as u, useEffect as d, useId as f, useMemo as p, useRef as m, useState as h } from "react";
 import { jsx as g, jsxs as _ } from "react/jsx-runtime";
 import { createCollapse as v } from "@slotted/core/overflow";

package/dist/action-bar.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./action-bar-OACchRZw.js";
+import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "./action-bar-ti3e6FK1.js";
 export { a as ActionBar, c as ActionBarAction, i as ActionBarActions, s as ActionBarDefaultsProvider, e as ActionBarOverflow, o as ActionBarSeparator, n as ActionBarStatus, t as useActionBarDefaults, r as useActionBarOverflow };