@nadicodeai/ui 6.0.2 → 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/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/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

package/docs/contract.md

@@ -27,6 +27,9 @@ Physical role, not content importance, chooses depth:
   work chooses it explicitly.
 - `Card surface="plain"` is the explicit structural/auth/website escape and
   carries no elevation.
+- `Card surface="outlined"` is a flat panel with a single semantic border and
+  compact corners; it carries no elevation ring or shadow. Bounded fact cells
+  use it inside resting record sections. Portal's kit keeps the resting default.
 - Tooltip, menu, popover, select, combobox, navigation popup, hover card,
   chart tooltip, and toast roots own `nc-elevation-floating` internally.
 - Dialog, alert dialog, drawer, and sheet roots own `nc-elevation-modal`
@@ -64,11 +67,36 @@ transparent and unframed because the Card already owns containment.
 
 ### Tables
 
-`Table` owns the native table structure, solid semantic background, horizontal
-overflow, and one compact density: 36px header rows and 40px body rows. Consumers
+`Table` owns the native table structure, solid semantic background, an overflow
+safety boundary, and one compact density: 36px header rows and 40px body rows. Consumers
 compose `TableHeader`, `TableBody`, `TableRow`, `TableHead`, and `TableCell`; they
 do not replace table layout with grid or flex, hide the header to create another
-presentation, or reconstruct the native semantics with ARIA.
+presentation, or reconstruct the native semantics with ARIA. Portal collections
+must fit their available width without horizontal scrolling: preserve identity
+and actions in columns and place supporting facts in native detail rows before
+the full schema becomes cramped. Test the table container itself, not only the
+document width; retaining the overflow safety boundary must not conceal a
+layout defect.
+
+`CollectionScope` chooses the parent of one record collection. It places the
+scope selector and optional detail action above the collection toolbar. Empty
+parents stay in the selector. Apps bind authorized options and URL state; clearing
+record filters preserves the parent scope. Parent details belong on their detail
+page, not in repeated panels surrounding identical child tables.
+
+`BreakdownTable` owns its responsive comparison layout: identity and value stay
+in the main row; share moves into a labeled detail row when space is tight.
+Its caption names the table. Callers supply data and labels, not column-hiding CSS.
+
+### Record action menus
+
+`ActionMenu` is the shared three-dot composition of `Button` and `DropdownMenu`:
+a ghost icon trigger, horizontal ellipsis, and end-aligned popup. It inherits the
+menu's glass, elevation, motion, keyboard behavior, and focus return. Supply
+`label` as a localized, record-specific accessible name; `triggerId` supports
+focus return from an app-owned confirmation, and `children` supplies menu items.
+Apps own action selection, permission, placement, and confirmation. Reuse this
+composition instead of drawing another trigger or popup.
 
 ## Status Vocabulary
 
@@ -121,12 +149,15 @@ fundamental `Card` with explicit `visual`, `name`, `job`, `status`, `meta`,
 and `action` slots and owns presentation only; when it is the page identity,
 the `name` slot carries the page's `h1`. The app owns Agent data, recipe
 assignment, status grammar, routing, and actions; it assigns a recipe
-explicitly and never infers or randomizes one from a free-form role, and an
-Agent that is a recognizable content object renders through `AgentCard`. There is no `AgentGlyph`,
+explicitly and never infers or randomizes one from a free-form role.
+When the product chooses a card presentation, use `AgentCard`; registry cells,
+membership rows, and compact detail headers compose the shared `AgentVisual`
+within the structure their reading task requires. An Agent's presence does not
+by itself choose a card layout. There is no `AgentGlyph`,
 `AgentRow`, `KpiCard`, or product-domain `agent` object prop in the shared
 package.
 
-- **Standard components, not app-owned product features.** This package ships primitives, standard UI components, assistant-ui compositions, brand adapters, React adapters, reusable sections, and presentational product components. It must not ship app-specific feature/use-case screens or names such as operator-login, portal activation, customer credential control, or customer management. Generic data tables, command palettes, and chart cards are app-owned shadcn registry adaptations. The source-backed `chart-*` package surface is the plan-approved exception per issue #166; chart cards remain app-owned. Every data-shaped chart exposes an equivalent non-visual data alternative. A component whose complete value is already available in visible text or `aria-valuetext` does not add a redundant table.
+- **Standard components, not app-owned product features.** This package ships primitives, standard UI components, assistant-ui compositions, brand adapters, React adapters, reusable sections, and presentational product components. It must not ship app-specific feature/use-case screens or names such as operator-login, portal activation, customer credential control, or customer management. Domain registries, command search providers, and chart dashboards bind app data and routes in the app; that binding is not a reason to copy reusable presentation. Portal's DataTable owns its Next.js query and registry protocol once, while consuming the shared UI foundation. Product-independent compositions belong here with a real consumer. The source-backed `chart-*` package surface is the plan-approved exception per issue #166; apps select charts and bind their titles, data, and navigation. Every data-shaped chart exposes an equivalent non-visual data alternative. A component whose complete value is already available in visible text or `aria-valuetext` does not add a redundant table.
 - **Auth routes are consumer-owned shadcn block work.** Login, signup, OTP, two-factor, magic-link, and provider-button flows start from the selected shadcn block/example in the consuming app, with app-owned Better Auth behavior. Do not ship generic auth, signup, OTP, federated-login, or provider abstractions from this package unless a later explicit boundary decision replaces the selected shadcn block.
 - **Reusable sections and compositions live here after proof.** Bento grids, media mounts, demo surfaces, page frames, section intros, CTA bands, proof slots, benefits grids, generic shells, and homepage/use-case sections belong in `@nadicodeai/ui` when a second concrete consumer, a plan-approved shared component, or a named validation slice proves the package boundary. Website, portal, and sibling Nadia routes pass data and media children into existing compositions instead of rebuilding layout locally.
 - **Brand renderers live here for React consumers.** Logo geometry, asset generation, and usage semantics are owned by [`packages/design-system/DESIGN.md`, "Brand media authority"](../../design-system/DESIGN.md#brand-media-authority). `BrandLockup` supplies the approved horizontal lockup. `BrandMark` serves tight spaces and `BrandWordmark` serves placements where the name must read by itself. All three render the package's public neutral geometry seam with React-scoped SVG ids, dynamic theme paint, and accessible names. Consuming routes use these adapters; they never import raw logo assets, draw brand SVG inline, mask or recolor assets, or create another lockup rule.
@@ -141,11 +172,51 @@ package.
 
 The source tree, barrels, and package exports own the current reusable section vocabulary. When a page needs a variation, extend the owning source component with a small typed prop or slot; do not fork the layout in a consumer or document a second component inventory here.
 
+`KpiStatGroup` owns the metric strip, responsive tiles, and link treatment; `KpiStat` owns its value, note, delta, and decorative trend. Apps supply metrics and bind links through `render`. Time-series charts expose `size`; their lightweight layout module also sizes deferred placeholders, so consumers never select internal chart elements.
+
+`CollectionToolbar` owns the collection-control layout: compact filters at the
+leading edge, a flexible search field, and trailing actions. Its slot order is
+also the reading and focus order, including when controls wrap. Consumers supply
+existing controls and own their query state; they do not set independent search
+widths or align filters to table columns. `CollectionFilters` owns the controlled
+field/value picker and applied-filter chips; callers supply options, localized
+copy, and callbacks. The component owns discovery, edit/remove, keyboard focus,
+and empty search results. It does not own routing or fetch state.
+
+`SettingsFactsSection` owns a named record or settings reading section: its
+heading and optional action, header separator, and bounded responsive fact
+cells in two equal columns, stacked on compact screens. Consumers supply labels,
+values, an optional contextual footer, and a Card surface; paragraph facts take a full row. The stable heading remains a programmatic focus target
+when an editor closes. Keep fact labels, order, and cells stable when data is
+missing: null and undefined values use the required localized
+`missingValueLabel`, while zero remains a value. Consumers do not filter out
+unknown facts or replace them with indefinite loading skeletons. Editable
+controls remain in `SettingsSection`.
+
+`SettingsSection` composes Card's named header, divider, FieldGroup body, and
+optional divided `footer` for local save actions and feedback. The caller owns
+the form transaction and controls; the section owns their shared geometry.
+Header `actions` are optional supporting commands, distinct from footer submission.
+`SettingsField` uses one render callback in server and client components. Spread
+its `controlProps` onto the control to retain the visible label, descriptions,
+error association, and disabled/required state; do not wire another copy by hand.
+
+`TableDetailRow` keeps supporting collection facts readable at compact widths
+inside a native full-width table cell. It shares the owning column labels and
+values rather than requiring another responsive cell implementation. Identity
+and status retain their column headers. Missing values retain their place.
+`Table compactDetails` and `TableDetailRow layout` share `tableCompactLayouts`:
+`standard` retains full columns at 768px of container width, `wide` at 1024px,
+and `spacious` at 1152px for schemas with additional operational columns.
+The same owner switches column visibility, detail visibility, and row boundaries.
+Two supporting facts use two columns; additional facts can use three when they fit.
+The cell renderer supplies the value, leaving the label to the detail row.
+
 ## Consumer Boundary
 
 Consumers own routing, auth, app data, server actions, runtime construction and adapters, permission decisions, analytics, and app-specific copy. The package owns reusable React presentation and the public Agent UI dependency boundary. Agent state and behavior come through the Agents interface; non-React and TUI contracts belong to their consuming products.
 
-App source composes layout, data, behavior, and semantic content around package components. It does not restyle an imported component root: appearance changes enter through the component's typed variant or are added to the owning package component. App `className` values on package components are limited to structural layout and sizing. App source uses semantic roles such as `bg-background` and `text-foreground`; canonical `nc-*` color utilities stay behind package-owned primitives such as `BrandField`. Raw Tailwind palette colors are not available to anyone: the generated theme clears the `--color-*` namespace, so `bg-red-500` produces no CSS and `better-tailwindcss/no-unknown-classes` reports it. Visible controls come from `@nadicodeai/ui`, while hidden inputs remain valid form transport. The root ESLint rules `nadicodeai/no-shadcn-appearance-override` and `nadicodeai/no-native-visible-control` enforce the rest of this boundary; each takes a `packageOwnedPrimitives` option (`"exempt"` by default, `"lint"` to hold this package's own source to the same rule).
+App source composes layout, data, behavior, and semantic content around package components. It does not restyle an imported component root: appearance changes enter through the component's typed variant or are added to the owning package component. App `className` values on package components arrange and size the component root. Descendant `data-slot` selectors are not a public styling API; internal spacing, type, and sizing belong to the shared component, enforced by `nadicodeai/no-shadcn-appearance-override`. App source uses semantic roles such as `bg-background` and `text-foreground`; canonical `nc-*` color utilities stay behind package-owned primitives such as `BrandField`. Raw Tailwind palette colors are not available to anyone: the generated theme clears the `--color-*` namespace, so `bg-red-500` produces no CSS and `better-tailwindcss/no-unknown-classes` reports it. Visible controls come from `@nadicodeai/ui`, while hidden inputs remain valid form transport. The root ESLint rules `nadicodeai/no-shadcn-appearance-override` and `nadicodeai/no-native-visible-control` enforce the rest of this boundary; each takes a `packageOwnedPrimitives` option (`"exempt"` by default, `"lint"` to hold this package's own source to the same rule).
 
 When this package is read from an installed npm package, follow the [consumer setup guide](consuming-cross-repo.md) for setup and public import paths. The styling invariant above remains the authority for component implementation.