@entifix/react-controls 0.1.0-0

package/dist/ui/atoms/button/button-link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-link.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/button/button-link.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGjE,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,SAAS,CAAC,EAAE,kBAAkB;IAC1E;;;;OAIG;IACH,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,GAAG,KAAK,EACT,EAAE,eAAe,+BAMjB"}

package/dist/ui/atoms/button/button-link.js

@@ -0,0 +1,23 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from '../../utils/cn.js';
+import { button } from './button-recipe.js';
+export function ButtonLink(_0) {
+    let { variant, size, className, children } = _0, props = _object_without_properties_loose(_0, [
+        "variant",
+        "size",
+        "className",
+        "children"
+    ]);
+    return /*#__PURE__*/ _jsx("a", _extends({
+        className: cn(button({
+            variant,
+            size
+        }), className)
+    }, props, {
+        children: children
+    }));
+}
+
+//# sourceMappingURL=button-link.js.map

package/dist/ui/atoms/button/button-link.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/button/button-link.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef, ReactNode } from 'react';\n\nimport { cn } from '../../utils/cn.js';\nimport { button, type ButtonVariantProps } from './button-recipe.js';\n\n/**\n * An anchor wearing {@link Button}'s clothes — and, unlike `Button`, a\n * **server** component.\n *\n * Most call-to-action buttons are not buttons: \"View product\", \"Browse\n * category\" and \"Keep shopping\" navigate, and a `<button>` that navigates is\n * both worse for the visitor (no middle-click, no open-in-new-tab, no status\n * bar) and more expensive for the page, because `Button` carries a\n * `'use client'` and would turn every card in a grid into its own client\n * boundary.\n *\n * Reach for `Button` when something actually happens on click; reach for this\n * when the click is a link. It takes no event handlers on purpose — accepting\n * one would quietly demand a client parent to pass it.\n */\nexport interface ButtonLinkProps\n  extends Omit<ComponentPropsWithoutRef<'a'>, 'onClick'>, ButtonVariantProps {\n  /**\n   * Required: a link with no content is invisible to a screen reader and\n   * unclickable to everyone else. `jsx-a11y/anchor-has-content` cannot see\n   * through the prop spread below, so the type is what enforces it.\n   */\n  children: ReactNode;\n}\n\nexport function ButtonLink({\n  variant,\n  size,\n  className,\n  children,\n  ...props\n}: ButtonLinkProps) {\n  return (\n    <a className={cn(button({ variant, size }), className)} {...props}>\n      {children}\n    </a>\n  );\n}\n"],"names":["cn","button","ButtonLink","variant","size","className","children","props","a"],"mappings":";;;AAEA,SAASA,EAAE,QAAQ,oBAAoB;AACvC,SAASC,MAAM,QAAiC,qBAAqB;AA2BrE,OAAO,SAASC,WAAW,EAMT;QANS,EACzBC,OAAO,EACPC,IAAI,EACJC,SAAS,EACTC,QAAQ,EAEQ,OADbC;;;;;;IAEH,qBACE,KAACC;QAAEH,WAAWL,GAAGC,OAAO;YAAEE;YAASC;QAAK,IAAIC;OAAgBE;kBACzDD;;AAGP"}

package/dist/ui/atoms/button/button-recipe.d.ts

@@ -0,0 +1,19 @@
+import { type VariantProps } from 'class-variance-authority';
+/**
+ * The button's visual recipe, kept in its own module so it can be shared with
+ * components that must **not** be client ones.
+ *
+ * `Button` is `'use client'` for a single reason — it renders HeadlessUI's
+ * `Button` — and a server page that puts one inside every card in a grid pays a
+ * client boundary per card. `cva` and the token classes have no such
+ * constraint, so a link-shaped variant (`ButtonLink`) can wear the same clothes
+ * and still render entirely on the server.
+ */
+export declare const button: (props?: ({
+    variant?: "destructive" | "primary" | "secondary" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type ButtonVariant = NonNullable<VariantProps<typeof button>['variant']>;
+export type ButtonSize = NonNullable<VariantProps<typeof button>['size']>;
+export type ButtonVariantProps = VariantProps<typeof button>;
+//# sourceMappingURL=button-recipe.d.ts.map

package/dist/ui/atoms/button/button-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button-recipe.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/button/button-recipe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM;;;8EAmClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAChF,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC1E,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,OAAO,MAAM,CAAC,CAAC"}

package/dist/ui/atoms/button/button-recipe.js

@@ -0,0 +1,42 @@
+import { cva } from 'class-variance-authority';
+/**
+ * The button's visual recipe, kept in its own module so it can be shared with
+ * components that must **not** be client ones.
+ *
+ * `Button` is `'use client'` for a single reason — it renders HeadlessUI's
+ * `Button` — and a server page that puts one inside every card in a grid pays a
+ * client boundary per card. `cva` and the token classes have no such
+ * constraint, so a link-shaped variant (`ButtonLink`) can wear the same clothes
+ * and still render entirely on the server.
+ */ export const button = cva([
+    'inline-flex items-center justify-center rounded-lg font-medium',
+    'transition duration-200 ease-smooth active:scale-[0.97]',
+    'focus-ring',
+    'disabled:cursor-not-allowed disabled:opacity-50 disabled:shadow-none disabled:active:scale-100'
+], {
+    variants: {
+        variant: {
+            primary: 'bg-primary text-primary-content shadow-raised hover:opacity-90 hover:shadow-card',
+            secondary: 'border border-border bg-surface-elevated text-content shadow-edge hover:border-primary hover:shadow-raised',
+            ghost: 'bg-transparent text-content hover:bg-surface-elevated',
+            // For an act that destroys something — ending every session a user
+            // holds, deleting a record. The `--color-danger*` tokens already
+            // existed and were being reached for as raw classes at call sites; this
+            // only gives them a name, so a destructive action looks the same
+            // wherever it appears rather than depending on who wrote the screen.
+            destructive: 'bg-danger text-danger-content shadow-raised hover:opacity-90 hover:shadow-card'
+        },
+        // Padding uses the fluid spacing tokens so buttons scale with the viewport.
+        size: {
+            sm: 'px-xs py-3xs text-step-0',
+            md: 'px-s py-2xs text-step-0',
+            lg: 'px-m py-xs text-step-1'
+        }
+    },
+    defaultVariants: {
+        variant: 'primary',
+        size: 'md'
+    }
+});
+
+//# sourceMappingURL=button-recipe.js.map

package/dist/ui/atoms/button/button-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/button/button-recipe.ts"],"sourcesContent":["import { cva, type VariantProps } from 'class-variance-authority';\n\n/**\n * The button's visual recipe, kept in its own module so it can be shared with\n * components that must **not** be client ones.\n *\n * `Button` is `'use client'` for a single reason — it renders HeadlessUI's\n * `Button` — and a server page that puts one inside every card in a grid pays a\n * client boundary per card. `cva` and the token classes have no such\n * constraint, so a link-shaped variant (`ButtonLink`) can wear the same clothes\n * and still render entirely on the server.\n */\nexport const button = cva(\n  [\n    'inline-flex items-center justify-center rounded-lg font-medium',\n    'transition duration-200 ease-smooth active:scale-[0.97]',\n    'focus-ring',\n    'disabled:cursor-not-allowed disabled:opacity-50 disabled:shadow-none disabled:active:scale-100',\n  ],\n  {\n    variants: {\n      variant: {\n        primary:\n          'bg-primary text-primary-content shadow-raised hover:opacity-90 hover:shadow-card',\n        secondary:\n          'border border-border bg-surface-elevated text-content shadow-edge hover:border-primary hover:shadow-raised',\n        ghost: 'bg-transparent text-content hover:bg-surface-elevated',\n        // For an act that destroys something — ending every session a user\n        // holds, deleting a record. The `--color-danger*` tokens already\n        // existed and were being reached for as raw classes at call sites; this\n        // only gives them a name, so a destructive action looks the same\n        // wherever it appears rather than depending on who wrote the screen.\n        destructive:\n          'bg-danger text-danger-content shadow-raised hover:opacity-90 hover:shadow-card',\n      },\n      // Padding uses the fluid spacing tokens so buttons scale with the viewport.\n      size: {\n        sm: 'px-xs py-3xs text-step-0',\n        md: 'px-s py-2xs text-step-0',\n        lg: 'px-m py-xs text-step-1',\n      },\n    },\n    defaultVariants: {\n      variant: 'primary',\n      size: 'md',\n    },\n  },\n);\n\nexport type ButtonVariant = NonNullable<VariantProps<typeof button>['variant']>;\nexport type ButtonSize = NonNullable<VariantProps<typeof button>['size']>;\nexport type ButtonVariantProps = VariantProps<typeof button>;\n"],"names":["cva","button","variants","variant","primary","secondary","ghost","destructive","size","sm","md","lg","defaultVariants"],"mappings":"AAAA,SAASA,GAAG,QAA2B,2BAA2B;AAElE;;;;;;;;;CASC,GACD,OAAO,MAAMC,SAASD,IACpB;IACE;IACA;IACA;IACA;CACD,EACD;IACEE,UAAU;QACRC,SAAS;YACPC,SACE;YACFC,WACE;YACFC,OAAO;YACP,mEAAmE;YACnE,iEAAiE;YACjE,wEAAwE;YACxE,iEAAiE;YACjE,qEAAqE;YACrEC,aACE;QACJ;QACA,4EAA4E;QAC5EC,MAAM;YACJC,IAAI;YACJC,IAAI;YACJC,IAAI;QACN;IACF;IACAC,iBAAiB;QACfT,SAAS;QACTK,MAAM;IACR;AACF,GACA"}

package/dist/ui/atoms/button/button.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentPropsWithoutRef } from 'react';
+import { type ButtonVariantProps } from './button-recipe.js';
+export type { ButtonSize, ButtonVariant } from './button-recipe.js';
+export interface ButtonProps extends ComponentPropsWithoutRef<'button'>, ButtonVariantProps {
+}
+export declare function Button({ variant, size, className, ...props }: ButtonProps): import("react").JSX.Element;
+//# sourceMappingURL=button.d.ts.map

package/dist/ui/atoms/button/button.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/button/button.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,EAAU,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAErE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEpE,MAAM,WAAW,WACf,SAAQ,wBAAwB,CAAC,QAAQ,CAAC,EAAE,kBAAkB;CAAG;AAEnE,wBAAgB,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,WAAW,+BAOzE"}

package/dist/ui/atoms/button/button.js

@@ -0,0 +1,22 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Button as HeadlessButton } from '@headlessui/react';
+import { cn } from '../../utils/cn.js';
+import { button } from './button-recipe.js';
+export function Button(_0) {
+    let { variant, size, className } = _0, props = _object_without_properties_loose(_0, [
+        "variant",
+        "size",
+        "className"
+    ]);
+    return /*#__PURE__*/ _jsx(HeadlessButton, _extends({
+        className: cn(button({
+            variant,
+            size
+        }), className)
+    }, props));
+}
+
+//# sourceMappingURL=button.js.map

package/dist/ui/atoms/button/button.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/button/button.tsx"],"sourcesContent":["'use client';\n\nimport { Button as HeadlessButton } from '@headlessui/react';\nimport type { ComponentPropsWithoutRef } from 'react';\n\nimport { cn } from '../../utils/cn.js';\nimport { button, type ButtonVariantProps } from './button-recipe.js';\n\nexport type { ButtonSize, ButtonVariant } from './button-recipe.js';\n\nexport interface ButtonProps\n  extends ComponentPropsWithoutRef<'button'>, ButtonVariantProps {}\n\nexport function Button({ variant, size, className, ...props }: ButtonProps) {\n  return (\n    <HeadlessButton\n      className={cn(button({ variant, size }), className)}\n      {...props}\n    />\n  );\n}\n"],"names":["Button","HeadlessButton","cn","button","variant","size","className","props"],"mappings":"AAAA;;;;AAEA,SAASA,UAAUC,cAAc,QAAQ,oBAAoB;AAG7D,SAASC,EAAE,QAAQ,oBAAoB;AACvC,SAASC,MAAM,QAAiC,qBAAqB;AAOrE,OAAO,SAASH,OAAO,EAAmD;QAAnD,EAAEI,OAAO,EAAEC,IAAI,EAAEC,SAAS,EAAyB,OAApBC;;;;;IACpD,qBACE,KAACN;QACCK,WAAWJ,GAAGC,OAAO;YAAEC;YAASC;QAAK,IAAIC;OACrCC;AAGV"}

package/dist/ui/atoms/button/index.d.ts

@@ -0,0 +1,4 @@
+export * from './button.js';
+export * from './button-link.js';
+export * from './button-recipe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/atoms/button/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/button/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/ui/atoms/button/index.js

@@ -0,0 +1,5 @@
+export * from './button.js';
+export * from './button-link.js';
+export * from './button-recipe.js';
+
+//# sourceMappingURL=index.js.map

package/dist/ui/atoms/button/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/button/index.ts"],"sourcesContent":["export * from './button.js';\nexport * from './button-link.js';\nexport * from './button-recipe.js';\n"],"names":[],"mappings":"AAAA,cAAc,cAAc;AAC5B,cAAc,mBAAmB;AACjC,cAAc,qBAAqB"}

package/dist/ui/atoms/cell-value/cell-value.d.ts

@@ -0,0 +1,12 @@
+import { type EntityFieldDescriptor } from '@entifix/core';
+export interface CellValueProps {
+    value: unknown;
+    descriptor: EntityFieldDescriptor;
+}
+/**
+ * Renders one entity member according to its metadata type. Centralizing this
+ * is what lets a table stay generic: a link, a date and a number all arrive as
+ * "the value of an accessor", and only the descriptor decides how they read.
+ */
+export declare function CellValue({ value, descriptor }: CellValueProps): import("react").JSX.Element;
+//# sourceMappingURL=cell-value.d.ts.map

package/dist/ui/atoms/cell-value/cell-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-value.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/cell-value/cell-value.tsx"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,qBAAqB,EAG3B,MAAM,eAAe,CAAC;AAqHvB,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,qBAAqB,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,cAAc,+BA6B9D"}

package/dist/ui/atoms/cell-value/cell-value.js

@@ -0,0 +1,101 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { EntityCollectionLink, EntityLink } from '@entifix/core';
+import { useEnumLabel, useFormatters, useT } from '../../../i18n/index.js';
+/** Stand-in for an absent value, so an empty cell still reads as intentional. */ const EMPTY = '—';
+/**
+ * A link reads as its target's label when the target is loaded (embedded or
+ * resolved), and as the bare foreign key when it is not — the same cell markup
+ * covers both shapes a relation can arrive in.
+ */ function entityLabel(target, linkLabelProperty) {
+    const label = target == null ? void 0 : target[linkLabelProperty];
+    return label == null ? undefined : String(label);
+}
+function formatLink(link, linkLabelProperty) {
+    var _entityLabel;
+    return (_entityLabel = entityLabel(link.value, linkLabelProperty)) != null ? _entityLabel : link.id == null ? EMPTY : String(link.id);
+}
+function formatCollectionLink(link, linkLabelProperty) {
+    const loaded = link.values;
+    if (loaded !== undefined) {
+        return loaded.map((target, index)=>{
+            var _entityLabel, _ref, _target_id;
+            return (_entityLabel = entityLabel(target, linkLabelProperty)) != null ? _entityLabel : String((_ref = (_target_id = target.id) != null ? _target_id : link.ids[index]) != null ? _ref : '');
+        }).join(', ');
+    }
+    return link.ids.map(String).join(', ');
+}
+function formatByType(value, type, linkLabelProperty, formatting) {
+    switch(type){
+        case 'date':
+            return formatting.formatters.date(value instanceof Date ? value : String(value));
+        case 'number':
+            return typeof value === 'number' ? formatting.formatters.number(value) : String(value);
+        case 'boolean':
+            return value ? formatting.yes : formatting.no;
+        case 'enum':
+            return formatting.enumLabel(String(value));
+        case 'link':
+            return value instanceof EntityLink ? formatLink(value, linkLabelProperty) : String(value);
+        case 'linkCollection':
+            return value instanceof EntityCollectionLink ? formatCollectionLink(value, linkLabelProperty) : String(value);
+        case 'scalarCollection':
+            // The same comma list the draft holds, spaced for reading. Not `String`:
+            // an array's own `toString` joins on a bare comma, which reads as one
+            // run-on token in a narrow column.
+            return Array.isArray(value) ? value.join(', ') : String(value);
+        case 'composition':
+            // Owned rows have no useful one-line form — a receipt's lines are not a
+            // sentence — and the master's own screen is where they are read and
+            // edited. So the cell reports the count and stops.
+            return Array.isArray(value) ? formatting.rowCount(value.length) : String(value);
+        default:
+            return String(value);
+    }
+}
+/**
+ * Tabular figures, applied once, here — not on `--font-sans` and not per call
+ * site. A column of numbers or dates must align on the digit; a paragraph must
+ * not, because proportional figures are what prose is set in. The descriptor
+ * already knows which is which, so the cell is the only place that has to.
+ */ const NUMERIC_CLASS = {
+    number: 'tabular-nums',
+    date: 'tabular-nums'
+};
+/**
+ * Renders one entity member according to its metadata type. Centralizing this
+ * is what lets a table stay generic: a link, a date and a number all arrive as
+ * "the value of an accessor", and only the descriptor decides how they read.
+ */ export function CellValue({ value, descriptor }) {
+    var _NUMERIC_CLASS_descriptor_type;
+    const t = useT();
+    const formatters = useFormatters();
+    const enumLabel = useEnumLabel();
+    if (value === undefined || value === null) {
+        return /*#__PURE__*/ _jsx("span", {
+            className: "text-content-muted",
+            children: EMPTY
+        });
+    }
+    const text = formatByType(value, descriptor.type, descriptor.linkLabelProperty, {
+        formatters,
+        yes: t('value.yes'),
+        no: t('value.no'),
+        enumLabel: (raw)=>enumLabel(descriptor, raw),
+        rowCount: (count)=>t('value.rowCount', {
+                count
+            })
+    });
+    if (text === '') {
+        return /*#__PURE__*/ _jsx("span", {
+            className: "text-content-muted",
+            children: EMPTY
+        });
+    }
+    return /*#__PURE__*/ _jsx("span", {
+        className: (_NUMERIC_CLASS_descriptor_type = NUMERIC_CLASS[descriptor.type]) != null ? _NUMERIC_CLASS_descriptor_type : undefined,
+        children: text
+    });
+}
+
+//# sourceMappingURL=cell-value.js.map

package/dist/ui/atoms/cell-value/cell-value.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/cell-value/cell-value.tsx"],"sourcesContent":["'use client';\n\nimport type { Formatters } from '@entifix/core';\nimport {\n  type Entity,\n  EntityCollectionLink,\n  type EntityFieldDescriptor,\n  EntityLink,\n  type MetaAccessorType,\n} from '@entifix/core';\n\nimport { useEnumLabel, useFormatters, useT } from '../../../i18n/index.js';\n\n/** Stand-in for an absent value, so an empty cell still reads as intentional. */\nconst EMPTY = '—';\n\n/**\n * A link reads as its target's label when the target is loaded (embedded or\n * resolved), and as the bare foreign key when it is not — the same cell markup\n * covers both shapes a relation can arrive in.\n */\nfunction entityLabel(\n  target: Entity | undefined,\n  linkLabelProperty: string,\n): string | undefined {\n  const label = (target as Record<string, unknown> | undefined)?.[\n    linkLabelProperty\n  ];\n  return label == null ? undefined : String(label);\n}\n\nfunction formatLink(\n  link: EntityLink<Entity>,\n  linkLabelProperty: string,\n): string {\n  return (\n    entityLabel(link.value, linkLabelProperty) ??\n    (link.id == null ? EMPTY : String(link.id))\n  );\n}\n\nfunction formatCollectionLink(\n  link: EntityCollectionLink<Entity>,\n  linkLabelProperty: string,\n): string {\n  const loaded = link.values;\n  if (loaded !== undefined) {\n    return loaded\n      .map(\n        (target, index) =>\n          entityLabel(target, linkLabelProperty) ??\n          String(target.id ?? link.ids[index] ?? ''),\n      )\n      .join(', ');\n  }\n  return link.ids.map(String).join(', ');\n}\n\n/**\n * Everything locale-dependent, resolved once by the component and handed down.\n * The formatters carry an explicit locale, which is what keeps a date rendered\n * on the server byte-identical to the same date rendered in the browser.\n */\ninterface CellFormatting {\n  readonly formatters: Formatters;\n  readonly yes: string;\n  readonly no: string;\n  readonly enumLabel: (value: string) => string;\n  readonly rowCount: (count: number) => string;\n}\n\nfunction formatByType(\n  value: unknown,\n  type: MetaAccessorType,\n  linkLabelProperty: string,\n  formatting: CellFormatting,\n): string {\n  switch (type) {\n    case 'date':\n      return formatting.formatters.date(\n        value instanceof Date ? value : String(value),\n      );\n    case 'number':\n      return typeof value === 'number'\n        ? formatting.formatters.number(value)\n        : String(value);\n    case 'boolean':\n      return value ? formatting.yes : formatting.no;\n    case 'enum':\n      return formatting.enumLabel(String(value));\n    case 'link':\n      return value instanceof EntityLink\n        ? formatLink(value, linkLabelProperty)\n        : String(value);\n    case 'linkCollection':\n      return value instanceof EntityCollectionLink\n        ? formatCollectionLink(value, linkLabelProperty)\n        : String(value);\n    case 'scalarCollection':\n      // The same comma list the draft holds, spaced for reading. Not `String`:\n      // an array's own `toString` joins on a bare comma, which reads as one\n      // run-on token in a narrow column.\n      return Array.isArray(value) ? value.join(', ') : String(value);\n    case 'composition':\n      // Owned rows have no useful one-line form — a receipt's lines are not a\n      // sentence — and the master's own screen is where they are read and\n      // edited. So the cell reports the count and stops.\n      return Array.isArray(value)\n        ? formatting.rowCount(value.length)\n        : String(value);\n    default:\n      return String(value);\n  }\n}\n\n/**\n * Tabular figures, applied once, here — not on `--font-sans` and not per call\n * site. A column of numbers or dates must align on the digit; a paragraph must\n * not, because proportional figures are what prose is set in. The descriptor\n * already knows which is which, so the cell is the only place that has to.\n */\nconst NUMERIC_CLASS: Partial<Record<MetaAccessorType, string>> = {\n  number: 'tabular-nums',\n  date: 'tabular-nums',\n};\n\nexport interface CellValueProps {\n  value: unknown;\n  descriptor: EntityFieldDescriptor;\n}\n\n/**\n * Renders one entity member according to its metadata type. Centralizing this\n * is what lets a table stay generic: a link, a date and a number all arrive as\n * \"the value of an accessor\", and only the descriptor decides how they read.\n */\nexport function CellValue({ value, descriptor }: CellValueProps) {\n  const t = useT();\n  const formatters = useFormatters();\n  const enumLabel = useEnumLabel();\n\n  if (value === undefined || value === null) {\n    return <span className=\"text-content-muted\">{EMPTY}</span>;\n  }\n\n  const text = formatByType(\n    value,\n    descriptor.type,\n    descriptor.linkLabelProperty,\n    {\n      formatters,\n      yes: t('value.yes'),\n      no: t('value.no'),\n      enumLabel: raw => enumLabel(descriptor, raw),\n      rowCount: count => t('value.rowCount', { count }),\n    },\n  );\n\n  if (text === '') {\n    return <span className=\"text-content-muted\">{EMPTY}</span>;\n  }\n\n  return (\n    <span className={NUMERIC_CLASS[descriptor.type] ?? undefined}>{text}</span>\n  );\n}\n"],"names":["EntityCollectionLink","EntityLink","useEnumLabel","useFormatters","useT","EMPTY","entityLabel","target","linkLabelProperty","label","undefined","String","formatLink","link","value","id","formatCollectionLink","loaded","values","map","index","ids","join","formatByType","type","formatting","formatters","date","Date","number","yes","no","enumLabel","Array","isArray","rowCount","length","NUMERIC_CLASS","CellValue","descriptor","t","span","className","text","raw","count"],"mappings":"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"}

package/dist/ui/atoms/cell-value/index.d.ts

@@ -0,0 +1,2 @@
+export * from './cell-value.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/atoms/cell-value/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/cell-value/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/ui/atoms/cell-value/index.js

@@ -0,0 +1,3 @@
+export * from './cell-value.js';
+
+//# sourceMappingURL=index.js.map

package/dist/ui/atoms/cell-value/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/cell-value/index.ts"],"sourcesContent":["export * from './cell-value.js';\n"],"names":[],"mappings":"AAAA,cAAc,kBAAkB"}

package/dist/ui/atoms/field/checkbox.d.ts

@@ -0,0 +1,35 @@
+import { type ComponentPropsWithoutRef } from 'react';
+export interface CheckboxProps extends Omit<ComponentPropsWithoutRef<'input'>, 'type'> {
+    /**
+     * The visible caption. Omit it for a box whose meaning comes from where it
+     * sits — a row's selection box, where the column header is the caption and
+     * the row itself is the subject — and pass `aria-label` instead, so the
+     * control still announces itself to a screen reader. A box with neither is
+     * unlabelled.
+     */
+    label?: string;
+    /**
+     * The third state: some of the rows below are selected, but not all.
+     *
+     * It is a DOM **property**, not an attribute, so React cannot set it from
+     * JSX — `<input indeterminate>` is silently dropped — and it has to be
+     * written through a ref after render. That is the whole reason this component
+     * is separate from its siblings in `field.tsx`, and the reason it carries
+     * `'use client'`: those two are hook-free and stay server-renderable, because
+     * the storefront's search page is a Server Component that imports `TextInput`
+     * and must not pull a client boundary into a prerendered route.
+     */
+    indeterminate?: boolean;
+}
+/**
+ * A checkbox, with its caption when it has one.
+ *
+ * Two shapes, and the difference is not cosmetic. With `label` it renders the
+ * caption inside a `<label>` and the whole pair is the click target — the form
+ * control every other field is. Without one it renders a bare box that takes
+ * its meaning from its position, which is what a selection column needs: a
+ * caption per row would repeat the column header on every line, and the row's
+ * own cells are already the subject.
+ */
+export declare function Checkbox({ label, className, indeterminate, ...props }: CheckboxProps): import("react").JSX.Element;
+//# sourceMappingURL=checkbox.d.ts.map

package/dist/ui/atoms/field/checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/field/checkbox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,wBAAwB,EAAqB,MAAM,OAAO,CAAC;AAIzE,MAAM,WAAW,aAAc,SAAQ,IAAI,CACzC,wBAAwB,CAAC,OAAO,CAAC,EACjC,MAAM,CACP;IACC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;;;;OAUG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,SAAS,EACT,aAAqB,EACrB,GAAG,KAAK,EACT,EAAE,aAAa,+BAiCf"}

package/dist/ui/atoms/field/checkbox.js

@@ -0,0 +1,46 @@
+'use client';
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef } from 'react';
+import { cn } from '../../utils/cn.js';
+/**
+ * A checkbox, with its caption when it has one.
+ *
+ * Two shapes, and the difference is not cosmetic. With `label` it renders the
+ * caption inside a `<label>` and the whole pair is the click target — the form
+ * control every other field is. Without one it renders a bare box that takes
+ * its meaning from its position, which is what a selection column needs: a
+ * caption per row would repeat the column header on every line, and the row's
+ * own cells are already the subject.
+ */ export function Checkbox(_0) {
+    let { label, className, indeterminate = false } = _0, props = _object_without_properties_loose(_0, [
+        "label",
+        "className",
+        "indeterminate"
+    ]);
+    const ref = useRef(null);
+    useEffect(()=>{
+        // The effect only runs once the input is mounted, so the ref is always
+        // filled here; the guard is what keeps a future refactor that renders the
+        // box conditionally from throwing rather than no-op'ing.
+        /* v8 ignore next */ if (ref.current) ref.current.indeterminate = indeterminate;
+    }, [
+        indeterminate
+    ]);
+    const box = /*#__PURE__*/ _jsx("input", _extends({
+        ref: ref,
+        type: "checkbox",
+        className: cn('size-4 accent-primary', label ? undefined : className)
+    }, props));
+    if (label === undefined) return box;
+    return /*#__PURE__*/ _jsxs("label", {
+        className: cn('flex cursor-pointer items-center gap-2xs text-step-sm text-content', className),
+        children: [
+            box,
+            label
+        ]
+    });
+}
+
+//# sourceMappingURL=checkbox.js.map

package/dist/ui/atoms/field/checkbox.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/field/checkbox.tsx"],"sourcesContent":["'use client';\n\nimport { type ComponentPropsWithoutRef, useEffect, useRef } from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\nexport interface CheckboxProps extends Omit<\n  ComponentPropsWithoutRef<'input'>,\n  'type'\n> {\n  /**\n   * The visible caption. Omit it for a box whose meaning comes from where it\n   * sits — a row's selection box, where the column header is the caption and\n   * the row itself is the subject — and pass `aria-label` instead, so the\n   * control still announces itself to a screen reader. A box with neither is\n   * unlabelled.\n   */\n  label?: string;\n  /**\n   * The third state: some of the rows below are selected, but not all.\n   *\n   * It is a DOM **property**, not an attribute, so React cannot set it from\n   * JSX — `<input indeterminate>` is silently dropped — and it has to be\n   * written through a ref after render. That is the whole reason this component\n   * is separate from its siblings in `field.tsx`, and the reason it carries\n   * `'use client'`: those two are hook-free and stay server-renderable, because\n   * the storefront's search page is a Server Component that imports `TextInput`\n   * and must not pull a client boundary into a prerendered route.\n   */\n  indeterminate?: boolean;\n}\n\n/**\n * A checkbox, with its caption when it has one.\n *\n * Two shapes, and the difference is not cosmetic. With `label` it renders the\n * caption inside a `<label>` and the whole pair is the click target — the form\n * control every other field is. Without one it renders a bare box that takes\n * its meaning from its position, which is what a selection column needs: a\n * caption per row would repeat the column header on every line, and the row's\n * own cells are already the subject.\n */\nexport function Checkbox({\n  label,\n  className,\n  indeterminate = false,\n  ...props\n}: CheckboxProps) {\n  const ref = useRef<HTMLInputElement>(null);\n\n  useEffect(() => {\n    // The effect only runs once the input is mounted, so the ref is always\n    // filled here; the guard is what keeps a future refactor that renders the\n    // box conditionally from throwing rather than no-op'ing.\n    /* v8 ignore next */\n    if (ref.current) ref.current.indeterminate = indeterminate;\n  }, [indeterminate]);\n\n  const box = (\n    <input\n      ref={ref}\n      type=\"checkbox\"\n      className={cn('size-4 accent-primary', label ? undefined : className)}\n      {...props}\n    />\n  );\n\n  if (label === undefined) return box;\n\n  return (\n    <label\n      className={cn(\n        'flex cursor-pointer items-center gap-2xs text-step-sm text-content',\n        className,\n      )}\n    >\n      {box}\n      {label}\n    </label>\n  );\n}\n"],"names":["useEffect","useRef","cn","Checkbox","label","className","indeterminate","props","ref","current","box","input","type","undefined"],"mappings":"AAAA;;;;AAEA,SAAwCA,SAAS,EAAEC,MAAM,QAAQ,QAAQ;AAEzE,SAASC,EAAE,QAAQ,oBAAoB;AA4BvC;;;;;;;;;CASC,GACD,OAAO,SAASC,SAAS,EAKT;QALS,EACvBC,KAAK,EACLC,SAAS,EACTC,gBAAgB,KAAK,EAEP,OADXC;;;;;IAEH,MAAMC,MAAMP,OAAyB;IAErCD,UAAU;QACR,uEAAuE;QACvE,0EAA0E;QAC1E,yDAAyD;QACzD,kBAAkB,GAClB,IAAIQ,IAAIC,OAAO,EAAED,IAAIC,OAAO,CAACH,aAAa,GAAGA;IAC/C,GAAG;QAACA;KAAc;IAElB,MAAMI,oBACJ,KAACC;QACCH,KAAKA;QACLI,MAAK;QACLP,WAAWH,GAAG,yBAAyBE,QAAQS,YAAYR;OACvDE;IAIR,IAAIH,UAAUS,WAAW,OAAOH;IAEhC,qBACE,MAACN;QACCC,WAAWH,GACT,sEACAG;;YAGDK;YACAN;;;AAGP"}

package/dist/ui/atoms/field/field.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentPropsWithoutRef } from 'react';
+export declare function TextInput({ className, ...props }: ComponentPropsWithoutRef<'input'>): import("react").JSX.Element;
+export declare function Select({ className, ...props }: ComponentPropsWithoutRef<'select'>): import("react").JSX.Element;
+//# sourceMappingURL=field.d.ts.map

package/dist/ui/atoms/field/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/field/field.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAatD,wBAAgB,SAAS,CAAC,EACxB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,wBAAwB,CAAC,OAAO,CAAC,+BAEnC;AAED,wBAAgB,MAAM,CAAC,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,wBAAwB,CAAC,QAAQ,CAAC,+BAEpC"}

package/dist/ui/atoms/field/field.js

@@ -0,0 +1,29 @@
+import { _ as _extends } from "@swc/helpers/_/_extends";
+import { _ as _object_without_properties_loose } from "@swc/helpers/_/_object_without_properties_loose";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from '../../utils/cn.js';
+/** Shared shell for the interactive form controls below. */ const CONTROL_CLASS = [
+    'rounded-lg border border-border bg-surface-elevated px-2xs py-3xs',
+    'text-step-sm text-content',
+    'transition-colors duration-200 ease-smooth',
+    'focus-ring',
+    'disabled:cursor-not-allowed disabled:opacity-50'
+].join(' ');
+export function TextInput(_0) {
+    let { className } = _0, props = _object_without_properties_loose(_0, [
+        "className"
+    ]);
+    return /*#__PURE__*/ _jsx("input", _extends({
+        className: cn(CONTROL_CLASS, className)
+    }, props));
+}
+export function Select(_0) {
+    let { className } = _0, props = _object_without_properties_loose(_0, [
+        "className"
+    ]);
+    return /*#__PURE__*/ _jsx("select", _extends({
+        className: cn(CONTROL_CLASS, className)
+    }, props));
+}
+
+//# sourceMappingURL=field.js.map

package/dist/ui/atoms/field/field.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/field/field.tsx"],"sourcesContent":["import type { ComponentPropsWithoutRef } from 'react';\n\nimport { cn } from '../../utils/cn.js';\n\n/** Shared shell for the interactive form controls below. */\nconst CONTROL_CLASS = [\n  'rounded-lg border border-border bg-surface-elevated px-2xs py-3xs',\n  'text-step-sm text-content',\n  'transition-colors duration-200 ease-smooth',\n  'focus-ring',\n  'disabled:cursor-not-allowed disabled:opacity-50',\n].join(' ');\n\nexport function TextInput({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'input'>) {\n  return <input className={cn(CONTROL_CLASS, className)} {...props} />;\n}\n\nexport function Select({\n  className,\n  ...props\n}: ComponentPropsWithoutRef<'select'>) {\n  return <select className={cn(CONTROL_CLASS, className)} {...props} />;\n}\n"],"names":["cn","CONTROL_CLASS","join","TextInput","className","props","input","Select","select"],"mappings":";;;AAEA,SAASA,EAAE,QAAQ,oBAAoB;AAEvC,0DAA0D,GAC1D,MAAMC,gBAAgB;IACpB;IACA;IACA;IACA;IACA;CACD,CAACC,IAAI,CAAC;AAEP,OAAO,SAASC,UAAU,EAGU;QAHV,EACxBC,SAAS,EAEyB,OAD/BC;;;IAEH,qBAAO,KAACC;QAAMF,WAAWJ,GAAGC,eAAeG;OAAgBC;AAC7D;AAEA,OAAO,SAASE,OAAO,EAGc;QAHd,EACrBH,SAAS,EAE0B,OADhCC;;;IAEH,qBAAO,KAACG;QAAOJ,WAAWJ,GAAGC,eAAeG;OAAgBC;AAC9D"}

package/dist/ui/atoms/field/index.d.ts

@@ -0,0 +1,3 @@
+export * from './checkbox.js';
+export * from './field.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/atoms/field/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/field/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC"}

package/dist/ui/atoms/field/index.js

@@ -0,0 +1,4 @@
+export * from './checkbox.js';
+export * from './field.js';
+
+//# sourceMappingURL=index.js.map

package/dist/ui/atoms/field/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/ui/atoms/field/index.ts"],"sourcesContent":["export * from './checkbox.js';\nexport * from './field.js';\n"],"names":[],"mappings":"AAAA,cAAc,gBAAgB;AAC9B,cAAc,aAAa"}

package/dist/ui/atoms/field-control/field-control.d.ts

@@ -0,0 +1,50 @@
+import type { EntityFieldDescriptor } from '@entifix/core';
+export interface FieldControlProps {
+    descriptor: EntityFieldDescriptor;
+    /**
+     * ARIA wiring the caller owns, because only the caller knows the shape it is
+     * rendered into.
+     *
+     * A form labels its control with a `<label for>` and needs none of this; a
+     * detail grid's cell has no label of its own — the column header is the
+     * label, and the cell's message is the description — so it points at both by
+     * id. Passing them through here rather than duplicating the type→input map
+     * in the grid is what keeps one control deciding what a `date` member looks
+     * like.
+     */
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+    /**
+     * The draft value as a string — the shape a native input round-trips. A form
+     * holds its whole draft as `Record<string, string>` and reconstructs typed
+     * values only at submit, so the control never sees a domain value.
+     */
+    value: string;
+    onChange: (value: string) => void;
+    id?: string;
+}
+/**
+ * The edit-mode inverse of {@link CellValue}: it turns one metadata descriptor
+ * into the input that edits it. Centralizing the type→control choice is what
+ * lets a form stay generic, the same way `CellValue` keeps a table generic.
+ *
+ * A relation (`link`/`linkCollection`) is rendered read-only here, deliberately:
+ * editing one needs a picker that can search and page the target, which is a
+ * different control with different dependencies. So this atom stays a pure
+ * type→input map and a relation never falls back to a broken text box.
+ *
+ * For a to-one `link` that is only half the story — `EntityForm` wires the
+ * picker in one level up from its `linkSources`, so the member does get an
+ * editor, just not from here. A `linkCollection` has no editor anywhere yet
+ * (#26), and read-only is all it gets. A `composition` is the same: its rows
+ * need a detail grid (#122), and a text box holding `[object Object]` would be
+ * strictly worse than an honest disabled field.
+ *
+ * A `scalarCollection` is the exception among the collections and falls through
+ * to the plain text input on purpose: a `string[]` has a lossless comma form,
+ * so the draft it round-trips through *is* editable text. Splitting on the
+ * comma is `reconstructEntity`'s half of that same contract.
+ */
+export declare function FieldControl({ descriptor, value, onChange, id, ...aria }: FieldControlProps): import("react").JSX.Element;
+//# sourceMappingURL=field-control.d.ts.map

package/dist/ui/atoms/field-control/field-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-control.d.ts","sourceRoot":"","sources":["../../../../src/ui/atoms/field-control/field-control.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAoB,MAAM,eAAe,CAAC;AAK7E,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,qBAAqB,CAAC;IAClC;;;;;;;;;;OAUG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAQD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,YAAY,CAAC,EAC3B,UAAU,EACV,KAAK,EACL,QAAQ,EACR,EAAE,EACF,GAAG,IAAI,EACR,EAAE,iBAAiB,+BAkDnB"}