@nadicodeai/ui 6.0.1 → 6.1.0

package/dist/eslint/rules/no-resting-settings-control.js

@@ -6,8 +6,8 @@
  * editor that changes them. The regression this catches is a form control
  * rendered beside those facts rather than inside the editor they summon.
  *
- * "Inside the editor" means inside an `ActionDialogForm`'s `fields` prop, or
- * inside a `Dialog`/`Drawer` subtree for a surface that owns its own. Being a
+ * "Inside the editor" means inside a `SettingsSection`, an `ActionDialogForm`'s
+ * `fields` prop, or a `Dialog`/`Drawer` subtree for a surface that owns its own. Being a
  * CHILD of `ActionDialogForm` is the opposite: children are the resting surface
  * the dialog is opened from, which is exactly where a control must not be.
  *
@@ -21,6 +21,7 @@
  * here. Replaces `restingSettingsControlViolations` in the retired portal
  * page-grammar analyzers (#821).
  */
+import { jsxComponentName } from "./jsx-class-utility.js";
 
 // The controls a person types or picks into. Lowercase `input` is deliberately
 // absent: a hidden field carries context a summoned editor already decided, and
@@ -37,15 +38,15 @@ const RESTING_CONTROL_TAGS = new Set([
 
 const FACTS_SECTION_TAG = "SettingsFactsSection";
 
-function elementName(node) {
-  return node?.name?.type === "JSXIdentifier" ? node.name.name : undefined;
-}
-
-function summons(node) {
-  if (node.type === "JSXAttribute") return node.name.name === "fields";
+function summons(node, context) {
+  if (node.type === "JSXAttribute") {
+    return (
+      node.name.name === "fields" && jsxComponentName(node.parent, context) === "ActionDialogForm"
+    );
+  }
   if (node.type !== "JSXElement") return false;
-  const name = elementName(node.openingElement);
-  return Boolean(name && (name.startsWith("Dialog") || name.startsWith("Drawer")));
+  const name = jsxComponentName(node.openingElement, context);
+  return ["SettingsSection", "Dialog", "DialogContent", "Drawer", "DrawerContent"].includes(name);
 }
 
 export const noRestingSettingsControl = {
@@ -58,7 +59,7 @@ export const noRestingSettingsControl = {
     schema: [],
     messages: {
       restingControl:
-        "<{{tag}}> rests beside its facts: put it in the editor the facts summon (an ActionDialogForm `fields` prop, or a Dialog/Drawer subtree).",
+        "<{{tag}}> rests beside its facts: use SettingsSection for a form, or put it in the summoned editor (ActionDialogForm `fields`, Dialog, or Drawer).",
     },
   },
   create(context) {
@@ -67,13 +68,14 @@ export const noRestingSettingsControl = {
 
     return {
       JSXOpeningElement(node) {
-        const name = elementName(node);
+        const name = jsxComponentName(node, context);
         if (name === FACTS_SECTION_TAG) {
           declaresFacts = true;
           return;
         }
         if (!name || !RESTING_CONTROL_TAGS.has(name)) return;
-        if (context.sourceCode.getAncestors(node).some(summons)) return;
+        if (context.sourceCode.getAncestors(node).some((ancestor) => summons(ancestor, context)))
+          return;
         resting.push({ node, name });
       },
       "Program:exit"() {

package/dist/eslint/rules/no-shadcn-appearance-override.js

@@ -12,6 +12,8 @@
  * of which still compile and still fork the primitive. Those are what survives
  * here; the raw-palette names are gone from the sets below with the palette.
  */
+import { posix } from "node:path";
+
 import {
   classUtilities,
   openingElementClassUtilities,
@@ -19,6 +21,127 @@ import {
   skipsPackageOwnedPrimitive,
 } from "./jsx-class-utility.js";
 
+// These exact Portal adapters forward props to package primitives. Card
+// chooses its typed surface default; Table owns only structural geometry.
+// Their other exports are direct reexports.
+const portalCardExports = new Set([
+  "Card",
+  "CardHeader",
+  "CardTitle",
+  "CardDescription",
+  "CardAction",
+  "CardContent",
+]);
+const portalTableExports = new Set([
+  "Table",
+  "TableHead",
+  "TableCell",
+  "TableBody",
+  "TableCaption",
+  "TableFooter",
+  "TableHeader",
+  "TableRow",
+]);
+
+function primitiveModule(source, filename) {
+  if (source.startsWith("@nadicodeai/ui/components/")) {
+    return { card: source === "@nadicodeai/ui/components/card", exports: undefined };
+  }
+  const normalized = filename.replaceAll("\\", "/");
+  const portalStart = normalized.lastIndexOf("/apps/portal/src/");
+  if (portalStart === -1) return undefined;
+  const portalSource = `${normalized.slice(0, portalStart)}/apps/portal/src`;
+  const resolved = source.startsWith(".")
+    ? posix.normalize(posix.join(posix.dirname(normalized), source)).replace(/\.[jt]sx?$/, "")
+    : undefined;
+  if (source === "@/components/kit/card" || resolved === `${portalSource}/components/kit/card`) {
+    return { card: true, exports: portalCardExports };
+  }
+  if (source === "@/components/kit/table" || resolved === `${portalSource}/components/kit/table`) {
+    return { card: false, exports: portalTableExports };
+  }
+  return undefined;
+}
+
+function primitiveExport(module, name) {
+  if (module.exports && !module.exports.has(name)) return undefined;
+  return { cardRoot: module.card && name === "Card" };
+}
+
+const appearanceStyleProperties = new Set([
+  "appearance",
+  "WebkitAppearance",
+  "MozAppearance",
+  "color",
+  "background",
+  "backgroundColor",
+  "backgroundImage",
+  "boxShadow",
+  "textShadow",
+  "opacity",
+  "outlineColor",
+  "filter",
+  "backdropFilter",
+  "WebkitBackdropFilter",
+  "fill",
+  "fillOpacity",
+  "stroke",
+  "strokeOpacity",
+  ...[
+    "",
+    "Top",
+    "Right",
+    "Bottom",
+    "Left",
+    "Block",
+    "Inline",
+    "BlockStart",
+    "BlockEnd",
+    "InlineStart",
+    "InlineEnd",
+  ].map((side) => `border${side}Color`),
+  ...[
+    "",
+    "TopLeft",
+    "TopRight",
+    "BottomLeft",
+    "BottomRight",
+    "StartStart",
+    "StartEnd",
+    "EndStart",
+    "EndEnd",
+  ].map((corner) => `border${corner}Radius`),
+]);
+
+function staticStyleValue(node) {
+  if (node.type === "Literal") return node.value;
+  if (node.type === "TemplateLiteral" && node.expressions.length === 0) {
+    return node.quasis[0]?.value.cooked;
+  }
+  return undefined;
+}
+
+// Inline object literals only. Unknown values, computed keys, imported style
+// objects and spreads remain review work; layout properties are not paint.
+function inlineAppearanceProperties(attribute) {
+  if (attribute.type !== "JSXAttribute" || attribute.name.name !== "style") return [];
+  const expression =
+    attribute.value?.type === "JSXExpressionContainer" ? attribute.value.expression : undefined;
+  if (expression?.type !== "ObjectExpression") return [];
+  return expression.properties.filter((property) => {
+    if (property.type !== "Property") return false;
+    const name =
+      property.key.type === "Literal"
+        ? property.key.value
+        : !property.computed && property.key.type === "Identifier"
+          ? property.key.name
+          : undefined;
+    if (!appearanceStyleProperties.has(name)) return false;
+    const value = staticStyleValue(property.value);
+    return typeof value === "number" || (typeof value === "string" && value.trim() !== "");
+  });
+}
+
 function withoutVariants(utility) {
   return utility.slice(utility.lastIndexOf(":") + 1);
 }
@@ -74,7 +197,10 @@ function isAppearanceUtility(utility) {
 
 function isProhibitedAppearanceUtility(utility, { cardRoot = false } = {}) {
   const base = withoutVariants(utility);
-  return isAppearanceUtility(utility) && (!isBorderRemoval(base) || cardRoot);
+  return (
+    targetsSharedSlot(utility) ||
+    (isAppearanceUtility(utility) && (!isBorderRemoval(base) || cardRoot))
+  );
 }
 
 function targetsSharedSlot(utility) {
@@ -92,15 +218,14 @@ export const noShadcnAppearanceOverride = {
   meta: {
     type: "problem",
     docs: {
-      description:
-        "Disallow app callers repainting imported shadcn primitives; compose their structural layout only",
+      description: "Keep shared component appearance and internal slot layout at their owner",
     },
     // Default "exempt": inside @nadicodeai/ui the primitives ARE the appearance,
     // so every utility here would be a false positive.
     schema: [packageOwnedPrimitivesSchema],
     messages: {
       appearanceOverride:
-        "Do not repaint an imported @nadicodeai/ui primitive with {{utility}}; use its semantic variant or package primitive.",
+        "Do not override shared component appearance or internal slot layout with {{utility}}; use a component prop or fix its shared owner.",
     },
   },
   create(context) {
@@ -108,48 +233,76 @@ export const noShadcnAppearanceOverride = {
       return {};
     }
 
-    const sharedPrimitiveNames = new Set();
-    const sharedCardRootNames = new Set();
-    const isSharedPrimitive = (node) =>
-      node?.type === "JSXOpeningElement" &&
-      node.name.type === "JSXIdentifier" &&
-      sharedPrimitiveNames.has(node.name.name);
-    const isSharedCardRoot = (node) =>
-      node?.type === "JSXOpeningElement" &&
-      node.name.type === "JSXIdentifier" &&
-      sharedCardRootNames.has(node.name.name);
+    const sourceCode = context.sourceCode;
+    const sharedBindings = new Map();
+
+    function importedBinding(identifier) {
+      for (let scope = sourceCode.getScope(identifier); scope; scope = scope.upper) {
+        const variable = scope.set.get(identifier.name);
+        if (variable) return sharedBindings.get(variable);
+      }
+      return undefined;
+    }
+
+    function sharedPrimitive(node) {
+      if (node?.type !== "JSXOpeningElement") return undefined;
+      if (node.name.type === "JSXIdentifier") {
+        const binding = importedBinding(node.name);
+        return binding && binding.name !== "*"
+          ? primitiveExport(binding.module, binding.name)
+          : undefined;
+      }
+      if (node.name.type === "JSXMemberExpression" && node.name.object.type === "JSXIdentifier") {
+        const binding = importedBinding(node.name.object);
+        return binding?.name === "*"
+          ? primitiveExport(binding.module, node.name.property.name)
+          : undefined;
+      }
+      return undefined;
+    }
+
     return {
-      ImportDeclaration(node) {
-        if (
-          typeof node.source.value !== "string" ||
-          !node.source.value.startsWith("@nadicodeai/ui/components/")
-        ) {
-          return;
-        }
-        for (const specifier of node.specifiers) {
-          sharedPrimitiveNames.add(specifier.local.name);
-          if (
-            node.source.value === "@nadicodeai/ui/components/card" &&
-            specifier.type === "ImportSpecifier" &&
-            specifier.imported.name === "Card"
-          ) {
-            sharedCardRootNames.add(specifier.local.name);
+      Program(node) {
+        // Imports are hoisted; collect their declared variables before visiting
+        // JSX. Binding identity also distinguishes shadowing parameters/locals.
+        for (const declaration of node.body) {
+          if (declaration.type !== "ImportDeclaration" || declaration.importKind === "type")
+            continue;
+          const module = primitiveModule(declaration.source.value, context.filename);
+          if (!module) continue;
+          for (const specifier of declaration.specifiers) {
+            if (specifier.importKind === "type") continue;
+            const name =
+              specifier.type === "ImportNamespaceSpecifier"
+                ? "*"
+                : specifier.type === "ImportSpecifier"
+                  ? (specifier.imported.name ?? specifier.imported.value)
+                  : "default";
+            for (const variable of sourceCode.getDeclaredVariables(specifier)) {
+              sharedBindings.set(variable, { module, name });
+            }
           }
         }
       },
       JSXOpeningElement(node) {
-        if (!isSharedPrimitive(node)) return;
-        for (const utility of openingElementClassUtilities(node, context)) {
-          if (
-            utility &&
-            isProhibitedAppearanceUtility(utility, { cardRoot: isSharedCardRoot(node) })
-          ) {
+        const primitive = sharedPrimitive(node);
+        if (!primitive) return;
+        for (const utility of openingElementClassUtilities(node, context, true)) {
+          if (utility && isProhibitedAppearanceUtility(utility, primitive)) {
             context.report({ node, messageId: "appearanceOverride", data: { utility } });
           }
         }
+        for (const property of node.attributes.flatMap(inlineAppearanceProperties)) {
+          const name = property.key.name ?? property.key.value;
+          context.report({
+            node: property,
+            messageId: "appearanceOverride",
+            data: { utility: `style.${name}` },
+          });
+        }
       },
       JSXAttribute(node) {
-        if (isSharedPrimitive(node.parent)) return;
+        if (sharedPrimitive(node.parent)) return;
         for (const utility of classUtilities(node, context)) {
           if (
             !targetsSharedSlot(utility) ||

package/dist/eslint/rules/shadcn-composition.js

@@ -1,5 +1,5 @@
 /*
- * The four composition conventions the shadcn primitives are built to, checked
+ * The composition conventions the shared components are built to, checked
  * where they are composed:
  *
  * - an overlay carries its title, so a screen reader announces what opened
@@ -9,7 +9,9 @@
  * - an `AvatarImage` has an `AvatarFallback` beside it, or the avatar is blank
  *   until the image loads;
  * - a lucide icon inside a `Button` carries `data-icon`, the hook the button's
- *   own spacing rules key on.
+ *   own spacing rules key on;
+ * - a settings submit action uses SettingsSection's shared footer, so each
+ *   caller cannot rebuild its own divider, padding, and action position.
  *
  * Standard tool checked first: `jsx-a11y` covers roles and ARIA on
  * intrinsic elements and says nothing about these composed components;
@@ -18,7 +20,11 @@
  * of the retired @nadicodeai/ui composition-conventions scanner (#822); stock
  * upstream shapes carry an inline disable with the reason at the site.
  */
-import { packageOwnedPrimitivesSchema, skipsPackageOwnedPrimitive } from "./jsx-class-utility.js";
+import {
+  jsxComponentName,
+  packageOwnedPrimitivesSchema,
+  skipsPackageOwnedPrimitive,
+} from "./jsx-class-utility.js";
 
 const OVERLAY_TITLES = {
   AlertDialogContent: "AlertDialogTitle",
@@ -75,6 +81,39 @@ function isIconTag(tagName) {
   return tagName === "Icon" || tagName.endsWith("Icon");
 }
 
+function misplacedSettingsSubmit(node, context) {
+  if (jsxComponentName(node, context) !== "Button") return false;
+  const attribute = node.attributes.find(
+    (entry) => entry.type === "JSXAttribute" && entry.name.name === "type",
+  );
+  const value =
+    attribute?.value?.type === "JSXExpressionContainer"
+      ? attribute.value.expression
+      : attribute?.value;
+  const type =
+    value?.type === "TemplateLiteral" && value.expressions.length === 0
+      ? value.quasis[0]?.value.cooked
+      : value?.value;
+  if (type !== "submit") return false;
+  const ancestors = context.sourceCode.getAncestors(node);
+  const section = ancestors.findLast(
+    (ancestor) =>
+      ancestor.type === "JSXElement" &&
+      jsxComponentName(ancestor.openingElement, context) === "SettingsSection",
+  );
+  if (!section) return false;
+  return !ancestors.slice(ancestors.indexOf(section) + 1).some((ancestor) => {
+    if (ancestor.type === "JSXAttribute")
+      return ancestor.name.name === "footer" && ancestor.parent === section.openingElement;
+    return (
+      ancestor.type === "JSXElement" &&
+      ["DialogContent", "DrawerContent", "AlertDialogContent"].includes(
+        jsxComponentName(ancestor.openingElement, context),
+      )
+    );
+  });
+}
+
 export const shadcnComposition = {
   meta: {
     type: "problem",
@@ -88,6 +127,8 @@ export const shadcnComposition = {
       selectGroup: "SelectItem must be rendered inside SelectGroup.",
       avatarFallback: "AvatarImage requires an AvatarFallback in the same Avatar.",
       buttonIcon: "An icon inside Button must carry data-icon.",
+      settingsFooter:
+        "Put a SettingsSection submit action in its footer prop; the shared component owns the divider, spacing, and action position.",
     },
   },
   create(context) {
@@ -101,6 +142,10 @@ export const shadcnComposition = {
         if (!tag) return;
         const element = node.parent;
 
+        if (misplacedSettingsSubmit(node, context)) {
+          context.report({ node, messageId: "settingsFooter" });
+        }
+
         const title = OVERLAY_TITLES[tag];
         if (title && !hasDescendant(element, title)) {
           context.report({ node, messageId: "overlayTitle", data: { tag, title } });

package/dist/hooks/use-confirm-action.d.ts

@@ -1,9 +1,3 @@
-export interface ConfirmActionGate {
-    busy: boolean;
-}
-export declare function requestConfirmAction<T>(gate: ConfirmActionGate, value: T, setPending: (value: T | null) => void): void;
-export declare function cancelConfirmAction<T>(gate: ConfirmActionGate, setPending: (value: T | null) => void): void;
-export declare function runConfirmAction<T>(gate: ConfirmActionGate, pending: T | null, onConfirm: (value: T) => void | Promise<void>, setPending: (value: T | null) => void, setBusy: (busy: boolean) => void): Promise<void>;
 export declare function useConfirmAction<T>({ onConfirm, }: {
     onConfirm: (value: T) => void | Promise<void>;
 }): {

package/dist/hooks/use-confirm-action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-confirm-action.d.ts","sourceRoot":"","sources":["../../src/hooks/use-confirm-action.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,OAAO,CAAC;CACf;AAID,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,CAAC,EACR,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,GACpC,IAAI,CAKN;AAID,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,GACpC,IAAI,CAKN;AAKD,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,IAAI,EAAE,iBAAiB,EACvB,OAAO,EAAE,CAAC,GAAG,IAAI,EACjB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAC7C,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,EACrC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,GAC/B,OAAO,CAAC,IAAI,CAAC,CAef;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAClC,SAAS,GACV,EAAE;IACD,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;8BAK2C,CAAC;;;;;;EAqB5C"}
+{"version":3,"file":"use-confirm-action.d.ts","sourceRoot":"","sources":["../../src/hooks/use-confirm-action.ts"],"names":[],"mappings":"AAwDA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,EAClC,SAAS,GACV,EAAE;IACD,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;8BAK2C,CAAC;;;;;;EAqB5C"}

package/dist/hooks/use-confirm-action.js

@@ -1,25 +1,18 @@
 "use client";
 import * as React from "react";
-// Request stages a value for confirmation; ignored while a confirm is in
-// flight so the pending value cannot change under a running action.
-export function requestConfirmAction(gate, value, setPending) {
+function requestConfirmAction(gate, value, setPending) {
     if (gate.busy) {
         return;
     }
     setPending(value);
 }
-// Cancel clears the pending value, but is a no-op while a confirm is in flight
-// so the dialog cannot be dismissed mid-action.
-export function cancelConfirmAction(gate, setPending) {
+function cancelConfirmAction(gate, setPending) {
     if (gate.busy) {
         return;
     }
     setPending(null);
 }
-// Confirm marks busy, awaits `onConfirm`, and clears the pending value on
-// success. A thrown error is swallowed so the dialog stays open (the caller
-// surfaces the error inside `onConfirm`); busy always resets in `finally`.
-export async function runConfirmAction(gate, pending, onConfirm, setPending, setBusy) {
+async function confirmOrKeepOpen(gate, pending, onConfirm, setPending, setBusy) {
     if (gate.busy || pending === null) {
         return;
     }
@@ -30,7 +23,7 @@ export async function runConfirmAction(gate, pending, onConfirm, setPending, set
         setPending(null);
     }
     catch {
-        // Keep the pending value so the dialog stays open.
+        return;
     }
     finally {
         gate.busy = false;
@@ -47,7 +40,7 @@ export function useConfirmAction({ onConfirm, }) {
     const cancel = React.useCallback(() => {
         cancelConfirmAction(gateRef.current, setPending);
     }, []);
-    const confirm = React.useCallback(() => runConfirmAction(gateRef.current, pending, onConfirm, setPending, setIsBusy), [pending, onConfirm]);
+    const confirm = React.useCallback(() => confirmOrKeepOpen(gateRef.current, pending, onConfirm, setPending, setIsBusy), [pending, onConfirm]);
     return {
         request,
         cancel,

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./components/accordion.js";
 export * from "./components/action-band.js";
+export * from "./components/action-menu.js";
 export * from "./components/action-status.js";
 export * from "./components/activity-orb.js";
 export * from "./components/alert.js";
@@ -20,6 +21,7 @@ export * from "./components/button.js";
 export * from "./components/button-group.js";
 export * from "./components/calendar.js";
 export * from "./components/card.js";
+export * from "./components/collection-scope.js";
 export * from "./components/card-marketing.js";
 export * from "./components/carousel.js";
 export * from "./components/chart.js";
@@ -105,6 +107,9 @@ export * from "./components/security-grid.js";
 export * from "./components/select.js";
 export * from "./components/separator.js";
 export * from "./components/settings-section.js";
+export * from "./components/settings-facts.js";
+export * from "./components/collection-toolbar.js";
+export * from "./components/collection-filters.js";
 export * from "./components/sheet.js";
 export * from "./components/shift-band.js";
 export * from "./components/sidebar.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from "./components/accordion.js";
 export * from "./components/action-band.js";
+export * from "./components/action-menu.js";
 export * from "./components/action-status.js";
 export * from "./components/activity-orb.js";
 export * from "./components/alert.js";
@@ -20,6 +21,7 @@ export * from "./components/button.js";
 export * from "./components/button-group.js";
 export * from "./components/calendar.js";
 export * from "./components/card.js";
+export * from "./components/collection-scope.js";
 export * from "./components/card-marketing.js";
 export * from "./components/carousel.js";
 export * from "./components/chart.js";
@@ -105,6 +107,9 @@ export * from "./components/security-grid.js";
 export * from "./components/select.js";
 export * from "./components/separator.js";
 export * from "./components/settings-section.js";
+export * from "./components/settings-facts.js";
+export * from "./components/collection-toolbar.js";
+export * from "./components/collection-filters.js";
 export * from "./components/sheet.js";
 export * from "./components/shift-band.js";
 export * from "./components/sidebar.js";

package/dist/lib/use-copy-to-clipboard.d.ts

@@ -1,44 +1,3 @@
-/**
- * The copy affordance behind every "copy" button in the package.
- *
- * The decision half and the timer half are exported as plain functions, with the
- * hook a thin binding over them (the shape `use-confirm-action` established), so
- * both are testable in the package's node-only default suite instead of needing a
- * DOM render harness.
- */
-export type CopyAttempt = 
-/** No clipboard to write to — an insecure origin, typically. */
-{
-    kind: "unavailable";
-    error: Error;
-}
-/** Already showing "copied" and the caller asked not to repeat. */
- | {
-    kind: "skipped";
-} | {
-    kind: "copied";
-} | {
-    kind: "failed";
-    error: Error;
-};
-/** Attempts the write and classifies the result; performs no state or timer work. */
-export declare function attemptCopy(input: {
-    text: string;
-    isCopied: boolean;
-    skipWhileCopied: boolean;
-    writeText: ((text: string) => Promise<void>) | undefined;
-}): Promise<CopyAttempt>;
-export type ResetTimers = {
-    clear: (handle: number) => void;
-    set: (onReset: () => void, timeout: number) => number;
-};
-/**
- * Starts the "copied" reset window, dropping whichever reset was already
- * pending. Without the clear, an earlier press's timer keeps its own schedule and
- * fires part-way through this press's window, so the feedback disappears early.
- * Returns the new handle for the caller to hold.
- */
-export declare function restartResetTimer(timers: ResetTimers, pendingHandle: number, onReset: () => void, timeout: number): number;
 export declare function useCopyToClipboard({ text, onCopy, onError, timeout, skipWhileCopied, }: {
     text: string;
     onCopy?: () => void;

package/dist/lib/use-copy-to-clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../src/lib/use-copy-to-clipboard.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW;AACrB,gEAAgE;AAC9D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE;AACvC,mEAAmE;GACjE;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAErC,qFAAqF;AACrF,wBAAsB,WAAW,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC;CAC1D,GAAG,OAAO,CAAC,WAAW,CAAC,CAavB;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,IAAI,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;CACvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,IAAI,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAGR;AAED,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,MAAM,EACN,OAAO,EACP,OAAO,EACP,eAAuB,GACxB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;;;EAyCA"}
+{"version":3,"file":"use-copy-to-clipboard.d.ts","sourceRoot":"","sources":["../../src/lib/use-copy-to-clipboard.ts"],"names":[],"mappings":"AA4BA,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,MAAM,EACN,OAAO,EACP,OAAO,EACP,eAAuB,GACxB,EAAE;IACD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;;;EAsCA"}

package/dist/lib/use-copy-to-clipboard.js

@@ -1,6 +1,5 @@
 import { useCallback, useEffect, useRef, useState } from "react";
-/** Attempts the write and classifies the result; performs no state or timer work. */
-export async function attemptCopy(input) {
+async function attemptCopy(input) {
     if (!input.writeText) {
         return { kind: "unavailable", error: new Error("Clipboard API not available") };
     }
@@ -15,18 +14,9 @@ export async function attemptCopy(input) {
         return { kind: "failed", error: error };
     }
 }
-/**
- * Starts the "copied" reset window, dropping whichever reset was already
- * pending. Without the clear, an earlier press's timer keeps its own schedule and
- * fires part-way through this press's window, so the feedback disappears early.
- * Returns the new handle for the caller to hold.
- */
-export function restartResetTimer(timers, pendingHandle, onReset, timeout) {
-    timers.clear(pendingHandle);
-    return timers.set(onReset, timeout);
-}
 export function useCopyToClipboard({ text, onCopy, onError, timeout, skipWhileCopied = false, }) {
-    const [isCopied, setIsCopied] = useState(false);
+    const [copiedText, setCopiedText] = useState(null);
+    const isCopied = copiedText === text;
     const timeoutRef = useRef(0);
     const copyToClipboard = useCallback(async () => {
         const attempt = await attemptCopy({
@@ -44,9 +34,10 @@ export function useCopyToClipboard({ text, onCopy, onError, timeout, skipWhileCo
         if (attempt.kind === "skipped") {
             return;
         }
-        setIsCopied(true);
+        setCopiedText(text);
         onCopy?.();
-        timeoutRef.current = restartResetTimer({ clear: window.clearTimeout.bind(window), set: window.setTimeout.bind(window) }, timeoutRef.current, () => setIsCopied(false), timeout);
+        window.clearTimeout(timeoutRef.current);
+        timeoutRef.current = window.setTimeout(() => setCopiedText(null), timeout);
     }, [isCopied, onCopy, onError, skipWhileCopied, text, timeout]);
     useEffect(() => () => {
         window.clearTimeout(timeoutRef.current);