@nadicodeai/ui 6.0.2 → 6.2.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/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/internal/forma/stored-appearance.d.ts

@@ -0,0 +1,29 @@
+import { type FormaChoice, type FormaColor } from "./model.js";
+/** What Hermes stores for an Agent's look. Both may be absent or unknown. */
+export interface StoredAppearance {
+    shape?: string | null;
+    color?: string | null;
+}
+/** The `shape` value a chosen form is stored as. */
+export declare const shapeFor: (form: FormaChoice) => string;
+/** The stored shape of the form an Agent wears until a customer chooses one. */
+export declare const defaultShape: string;
+/**
+ * The hex each palette colour is stored as. Hermes keeps an Agent's colour as
+ * a CSS colour for its own surfaces, so the stored spelling is a value rather
+ * than a token reference; `stored-appearance.test.ts` holds this table to the
+ * shipped design-system tokens, and the ESLint colour-literal exemption in the
+ * root config names this file.
+ */
+export declare const formaColorValues: Record<FormaColor, string>;
+/**
+ * Resolve the stored strings to what `FormaAvatar` draws. An unknown shape is
+ * the default form and an unknown colour is undefined, which leaves the form
+ * its own pigment. The root Agent is the caller's business: a caller that owns
+ * one passes `form="nadia"` instead of asking here.
+ */
+export declare function resolveAppearance(stored: StoredAppearance): {
+    form: FormaChoice;
+    color: FormaColor | undefined;
+};
+//# sourceMappingURL=stored-appearance.d.ts.map

package/dist/internal/forma/stored-appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stored-appearance.d.ts","sourceRoot":"","sources":["../../../src/internal/forma/stored-appearance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAA0C,MAAM,SAAS,CAAC;AAEpG,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,oDAAoD;AACpD,eAAO,MAAM,QAAQ,GAAI,MAAM,WAAW,KAAG,MAAyB,CAAC;AAEvE,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,MAA8B,CAAC;AAc1D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOvD,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG;IAC3D,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,UAAU,GAAG,SAAS,CAAC;CAC/B,CAEA"}

package/dist/internal/forma/stored-appearance.js

@@ -0,0 +1,53 @@
+import { defaultForm, formaChoices, formaColors } from "./model.js";
+/** The `shape` value a chosen form is stored as. */
+export const shapeFor = (form) => `forma:${form}`;
+/** The stored shape of the form an Agent wears until a customer chooses one. */
+export const defaultShape = shapeFor(defaultForm);
+/**
+ * The five role names the launch Agents were stored under, each kept at the
+ * form it wore. Forms are shapes, never roles: nothing new is stored this way.
+ */
+const legacyShapes = new Map([
+    ["forma:research", "uovo"],
+    ["forma:build", "goccia"],
+    ["forma:design", "nuvola"],
+    ["forma:operate", "quadrato"],
+    ["forma:review", "esagono"],
+]);
+/**
+ * The hex each palette colour is stored as. Hermes keeps an Agent's colour as
+ * a CSS colour for its own surfaces, so the stored spelling is a value rather
+ * than a token reference; `stored-appearance.test.ts` holds this table to the
+ * shipped design-system tokens, and the ESLint colour-literal exemption in the
+ * root config names this file.
+ */
+export const formaColorValues = {
+    verde: "#00a85a",
+    cobalto: "#1e3cff",
+    rosso: "#d3302f",
+    arancio: "#ff5a1f",
+    giallo: "#ffc220",
+    avorio: "#e9e7db",
+};
+/**
+ * Resolve the stored strings to what `FormaAvatar` draws. An unknown shape is
+ * the default form and an unknown colour is undefined, which leaves the form
+ * its own pigment. The root Agent is the caller's business: a caller that owns
+ * one passes `form="nadia"` instead of asking here.
+ */
+export function resolveAppearance(stored) {
+    return { form: formFor(stored.shape), color: colorFor(stored.color) };
+}
+function formFor(shape) {
+    if (!shape)
+        return defaultForm;
+    // A Map, not an object: the shape is a stored string from a machine, and an
+    // object lookup would hand back `toString` or `constructor` for those spellings.
+    return (formaChoices.find((form) => shape === shapeFor(form)) ?? legacyShapes.get(shape) ?? defaultForm);
+}
+function colorFor(color) {
+    if (!color)
+        return undefined;
+    const stored = color.toLowerCase();
+    return formaColors.find((name) => stored === formaColorValues[name] || color === name);
+}

package/docs/component-classification.md

@@ -19,8 +19,9 @@ copy, and behavior.
 
 | Component | Classification | Built on | Required states | Package-owned accessibility | Fixture |
 | --- | --- | --- | --- | --- | --- |
-| `SettingsSection` | Net-new NadicodeAI product composition. | shadcn `FieldGroup` plus standard section markup. | header with optional actions; field group content. | section structure; no form behavior. | `../tests/guards/product-compositions.test.ts` |
-| `SettingsField` | Net-new NadicodeAI product composition. | shadcn `Field`, `FieldLabel`, `FieldDescription`, and `FieldError`. | valid and invalid field rows; disabled rows. | Label `htmlFor`; render props receive control attributes; element controls require an explicit matching `id` and described-by wiring. | `../tests/guards/product-compositions.test.ts` |
+| `ActionMenu` | Canonical record-action composition. | shadcn `Button` and `DropdownMenu`. | closed, open, keyboard selection, focus return. | Required accessible trigger name; inherited menu mechanics. | `../src/components/action-menu.test.tsx` |
+| `SettingsSection` | NadicodeAI product composition. | shadcn Card slots, Separator, and FieldGroup. | header, field group, and divided action footer. | Section structure; consumer owns the form transaction. | `../src/components/settings-section.test.tsx` |
+| `SettingsField` | NadicodeAI product composition. | shadcn Field, FieldLabel, FieldDescription, and FieldError. | valid, invalid, required, and disabled field rows. | Render callback supplies the control's label and message associations in server and client components. | `../src/components/settings-section.test.tsx` |
 | `FeedbackState` | Net-new central product state composition adapted from shadcn empty-state patterns. | shadcn `Empty` and lucide status icons. | `empty`, `loading`, `saving`, `error`, `permission`, `offline`, `no-results`, `fatal`. | `role="status"` for loading/saving; `role="alert"` for error, permission, offline, and fatal. | `../tests/guards/product-compositions.test.ts` |
 
 ## App-Owned Boundaries