@gridui/data-cell 1.0.5 → 1.0.6

package/README.md

@@ -6,3 +6,5 @@ Import components from `@gridui/data-cell` and load `@gridui/data-cell/styles.cs
 Load styles for any composed dependency used by this family. Applications own routes, labels, state persistence, and branding.
 
 See [component ownership](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/docs/component-ownership.md) and [release history](https://github.com/sudo-ui/GridUI-React-Monorepo/tree/main/packages-core/data-cell/.changeset/history).
+
+[Component reference](docs/reference/README.md) contains focused API pages for each public component.

package/docs/catalog.json

@@ -1,12 +1,16 @@
 {
   "schemaVersion": 1,
   "name": "@gridui/data-cell",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "category": "core",
   "description": "GridUI React data cell",
-  "usage": "GridUI React data cell",
+  "usage": "Component reference contains focused API pages for each public component.",
   "documentation": [
-    "README.md"
+    "README.md",
+    "docs/reference/README.md",
+    "docs/reference/data-badge.md",
+    "docs/reference/data-bar.md",
+    "docs/reference/data-value.md"
   ],
   "exports": [
     {
@@ -45,6 +49,7 @@
     "@gridui/data-cell/styles.css"
   ],
   "examples": [
+    "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/values.mdx",
     "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/data-badge.stories.tsx",
     "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/data-bar.stories.tsx",
     "https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/data-value.stories.tsx"

package/docs/reference/README.md

@@ -0,0 +1,6 @@
+<!-- Generated by pnpm docs:storybook. -->
+# Component reference
+
+- [DataBadge](data-badge.md)
+- [DataBar](data-bar.md)
+- [DataValue](data-value.md)

package/docs/reference/data-badge.md

@@ -0,0 +1,63 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# DataBadge
+
+Presents a short status or category with consistent data typography. Use it inside tables, lists, or summaries.
+
+Import from ``@gridui/data-cell`` and load Theme before this family's stylesheet.
+
+```tsx
+import { DataBadge } from "@gridui/data-cell";
+import "@gridui/theme/styles.css";
+import "@gridui/data-cell/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/data-badge.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLSpanElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLSpanElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### tone
+
+``"neutral" | "accent" | undefined`` · Optional
+
+Default: ``"neutral"``
+

package/docs/reference/data-bar.md

@@ -0,0 +1,73 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# DataBar
+
+Displays a value as a compact proportional bar. Use it to compare magnitudes within a list or table.
+
+Import from ``@gridui/data-cell`` and load Theme before this family's stylesheet.
+
+```tsx
+import { DataBar } from "@gridui/data-cell";
+import "@gridui/theme/styles.css";
+import "@gridui/data-cell/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/data-bar.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLSpanElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLSpanElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### value
+
+``number`` · Required
+
+Controlled value. Pair with the corresponding change callback.
+
+### maximum
+
+``number`` · Required
+
+### partial
+
+``boolean | undefined`` · Optional
+
+Default: ``false``
+

package/docs/reference/data-value.md

@@ -0,0 +1,67 @@
+<!-- Generated from public Props and owned stories. Run pnpm docs:storybook. -->
+# DataValue
+
+Formats a compact value for data-heavy layouts. Use it for consistent alignment and typography in cells and summaries.
+
+Import from ``@gridui/data-cell`` and load Theme before this family's stylesheet.
+
+```tsx
+import { DataValue } from "@gridui/data-cell";
+import "@gridui/theme/styles.css";
+import "@gridui/data-cell/styles.css";
+```
+
+Read the [package contract](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/README.md) for shared behavior and stylesheet dependencies.
+
+The [working composition](https://github.com/sudo-ui/GridUI-React-Monorepo/blob/main/packages-core/data-cell/stories/data-value.stories.tsx) demonstrates required context, state, and related components. Use View code in Storybook to inspect the actual implementation.
+
+## API
+
+The public Props type is the source of these signatures. Defaults below are explicit implementation defaults; story presets are separate. Native attributes remain available through the exported Props type.
+
+### children
+
+``ReactNode`` · Optional
+
+Content rendered inside the component.
+
+### onFocus
+
+``(event: FocusEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onBlur
+
+``(event: FocusEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onChange
+
+``(event: ChangeEvent<HTMLSpanElement, Element>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onSubmit
+
+``(event: SubmitEvent<HTMLSpanElement>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### onClick
+
+``(event: MouseEvent<HTMLSpanElement, MouseEvent>): void`` · Optional
+
+Called when the corresponding interaction occurs; inspect the arguments in Actions.
+
+### detail
+
+``ReactNode`` · Optional
+
+### mono
+
+``boolean | undefined`` · Optional
+
+Default: ``false``
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gridui/data-cell",
-  "version": "1.0.5",
+  "version": "1.0.6",
   "description": "GridUI React data cell",
   "license": "UNLICENSED",
   "type": "module",
@@ -27,7 +27,7 @@
     "react-dom": "^19.2.0"
   },
   "dependencies": {
-    "@gridui/style-utils": "^3.0.0",
+    "@gridui/style-utils": "^4.0.0",
     "@gridui/theme": "^2.5.3",
     "class-variance-authority": "0.7.1"
   },