@refineui/react 0.0.12 → 0.1.0

package/dist/spec/authoring/schema/authoring-manifest.schema.json

@@ -0,0 +1,55 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://refineui.dev/schema/authoring-manifest-1.json",
+  "title": "RefineUI authoring manifest",
+  "type": "object",
+  "required": ["schema", "packageName", "packageVersion", "css", "components"],
+  "properties": {
+    "schema": { "const": "refineui.authoring/1" },
+    "packageName": { "const": "@refineui/react" },
+    "packageVersion": { "type": "string" },
+    "css": { "type": "array", "items": { "type": "string" } },
+    "components": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["id", "exportPath", "exportName", "kind", "category", "label", "props", "preview"],
+        "properties": {
+          "id": { "type": "string", "pattern": "^[a-z0-9-]+$" },
+          "exportPath": { "const": "@refineui/react" },
+          "exportName": { "type": "string" },
+          "kind": { "enum": ["root", "part", "provider", "portal"] },
+          "props": { "type": "array" },
+          "slots": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "required": ["name", "accepts"],
+              "properties": {
+                "name": { "type": "string" },
+                "target": { "enum": ["children", "prop"] },
+                "prop": { "type": "string" },
+                "accepts": { "type": "array", "items": { "type": "string" } }
+              }
+            }
+          },
+          "parents": { "type": "array" },
+          "presets": { "type": "array" },
+          "portal": {
+            "type": "object",
+            "required": ["strategy", "inheritsTheme"],
+            "properties": {
+              "strategy": { "enum": ["screen-root", "themed-overlay-root", "document-body"] },
+              "inheritsTheme": { "type": "boolean" },
+              "containerComponent": { "type": "string" },
+              "containerProp": { "type": "string" }
+            }
+          },
+          "preview": { "type": "object", "required": ["mode"], "properties": { "mode": { "enum": ["full", "limited"] } } }
+        },
+        "additionalProperties": true
+      }
+    }
+  },
+  "additionalProperties": false
+}

package/dist/spec/contract-index.json

@@ -3,7 +3,7 @@
   "contractLayer": "component-spec",
   "contractLayerVersion": "1.1",
   "status": "catalog",
-  "generatedAt": "2026-10-15T14:23:35.741Z",
+  "generatedAt": "2026-10-23T02:52:55.901Z",
   "role": "Behavior and DOM contracts — source of truth for Doctor, MCP, and Docs",
   "files": {
     "manifest": "./manifest.json",

package/dist/spec/token-trace-v2.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "generatedAt": "2026-10-15T14:23:35.737Z",
+  "generatedAt": "2026-10-23T02:52:55.897Z",
   "contractLayer": "component-token-trace",
   "tokens": {
     "webIcon.primary": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@refineui/react",
-  "version": "0.0.12",
+  "version": "0.1.0",
   "description": "RefineUI React components — Pelagornis RefineUI Web Kit",
   "type": "module",
   "license": "MIT",
@@ -13,6 +13,12 @@
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
     },
+    "./authoring-manifest": {
+      "types": "./dist/authoring-manifest.d.ts",
+      "import": "./dist/authoring-manifest.js",
+      "require": "./dist/authoring-manifest.cjs"
+    },
+    "./authoring-manifest.json": "./spec/authoring/manifest.json",
     "./package.json": "./package.json",
     "./refineui.css": "./refineui.css"
   },
@@ -22,12 +28,17 @@
     "refineui.css"
   ],
   "scripts": {
-    "build": "node ../../scripts/ws.mjs @refineui/utilities build && node ../../scripts/ws.mjs @refineui/tokens build && tsup && node scripts/generate-refineui-css.mjs && node scripts/generate-component-spec.mjs",
-    "dev": "tsup --watch"
+    "build": "node ../../scripts/ws.mjs @refineui/utilities build && node ../../scripts/ws.mjs @refineui/tokens build && node scripts/generate-authoring-manifest.mjs && node scripts/validate-authoring-manifest.mjs && tsup && node scripts/generate-refineui-css.mjs && node scripts/generate-component-spec.mjs",
+    "dev": "node scripts/generate-authoring-manifest.mjs && tsup --watch",
+    "generate:authoring": "node scripts/generate-authoring-manifest.mjs",
+    "validate:authoring": "node scripts/validate-authoring-manifest.mjs",
+    "verify:authoring-presets": "node scripts/verify-authoring-presets.mjs",
+    "test:authoring": "node scripts/validate-authoring-manifest.mjs && vitest run --config vitest.authoring.config.ts",
+    "test:authoring:browser": "vitest run --config vitest.authoring.browser.config.ts"
   },
   "dependencies": {
-    "@refineui/tokens": "1.0.2",
-    "@refineui/utilities": "0.0.3",
+    "@refineui/tokens": "1.0.4",
+    "@refineui/utilities": "0.0.4",
     "@refineui/web-icons": "^0.3.39",
     "clsx": "2.1.1"
   },
@@ -41,7 +52,8 @@
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "jsdom": "^30.1.3"
   },
   "repository": {
     "type": "git",

package/spec/authoring/README.md

@@ -0,0 +1,36 @@
+# RefineUI authoring manifest
+
+This is the editor-neutral authoring contract for `@refineui/react`. It is
+additive: the existing React API, CSS entrypoint, and behavior specs remain the
+source of runtime behavior.
+
+```ts
+import manifest, { renderAuthoringNode } from "@refineui/react/authoring-manifest";
+import * as RefineUI from "@refineui/react";
+
+const carousel = manifest.components.find((component) => component.exportName === "Carousel")!;
+const element = renderAuthoringNode(carousel.presets![0].root, RefineUI);
+```
+
+Tools that prefer data-only loading may import
+`@refineui/react/authoring-manifest.json`. Persist authoring nodes using the
+`component`, `props`, `slots`, and optional `text` fields. `text` represents a
+structural text child; it is intentionally not a React `children` prop.
+
+Slots normally become React children. A slot with `target: "prop"` and `prop`
+instead supplies a ReactNode-valued component property. For example, a Toast
+stores its message as a `Text` node in its `message` slot and an optional
+`WebIcon` node in its `icon` slot. This keeps content and icons structural and
+serializable rather than placing React nodes in `props`.
+
+For a portal contract with `containerComponent` and `containerProp`, pass the
+editor's themed overlay element as the optional third argument to
+`renderAuthoringNode`. The runtime injects that DOM reference only while
+rendering; the persisted authoring tree remains JSON-only.
+
+The manifest is generated with `bun run generate:authoring` and checked with
+`bun run validate:authoring`. Consumers should use `kind: "root"` for their
+insert palette, and use each part's explicit `parents` and slot constraints for
+child menus. Event callbacks, refs, React nodes, and portal DOM targets are not
+serializable props: they are represented by `events`, `stateBindings`,
+`iconSlots`, and `portal` contracts.

package/spec/authoring/components/accordion-content.json

@@ -0,0 +1,18 @@
+{
+  "id": "accordion-content",
+  "exportPath": "@refineui/react",
+  "exportName": "AccordionContent",
+  "kind": "part",
+  "category": "parts",
+  "label": "Accordion Content",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AccordionItem",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/accordion-item.json

@@ -0,0 +1,37 @@
+{
+  "id": "accordion-item",
+  "exportPath": "@refineui/react",
+  "exportName": "AccordionItem",
+  "kind": "part",
+  "category": "parts",
+  "label": "Accordion Item",
+  "props": [
+    {
+      "name": "value",
+      "label": "value",
+      "valueType": "string",
+      "control": "text",
+      "required": true,
+      "section": "properties"
+    }
+  ],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "Accordion",
+      "slot": "children"
+    }
+  ],
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AccordionTrigger",
+        "AccordionContent"
+      ],
+      "repeatable": true
+    }
+  ]
+}

package/spec/authoring/components/accordion-trigger.json

@@ -0,0 +1,18 @@
+{
+  "id": "accordion-trigger",
+  "exportPath": "@refineui/react",
+  "exportName": "AccordionTrigger",
+  "kind": "part",
+  "category": "parts",
+  "label": "Accordion Trigger",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AccordionItem",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/accordion.json

@@ -0,0 +1,102 @@
+{
+  "id": "accordion",
+  "exportPath": "@refineui/react",
+  "exportName": "Accordion",
+  "kind": "root",
+  "category": "components",
+  "label": "Accordion",
+  "props": [
+    {
+      "name": "size",
+      "label": "size",
+      "valueType": "enum",
+      "control": "segmented",
+      "options": [
+        "sm",
+        "md",
+        "lg"
+      ],
+      "defaultValue": "sm",
+      "section": "variants"
+    },
+    {
+      "name": "type",
+      "label": "type",
+      "valueType": "enum",
+      "control": "segmented",
+      "options": [
+        "single",
+        "multiple"
+      ],
+      "defaultValue": "single",
+      "section": "variants"
+    }
+  ],
+  "preview": {
+    "mode": "full"
+  },
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AccordionItem"
+      ],
+      "repeatable": true,
+      "min": 1
+    }
+  ],
+  "presets": [
+    {
+      "id": "items",
+      "label": "Accordion",
+      "root": {
+        "component": "Accordion",
+        "props": {
+          "type": "single",
+          "defaultValue": "item-1"
+        },
+        "slots": {
+          "children": [
+            {
+              "component": "AccordionItem",
+              "props": {
+                "value": "item-1"
+              },
+              "slots": {
+                "children": [
+                  {
+                    "component": "AccordionTrigger",
+                    "text": "What is RefineUI?"
+                  },
+                  {
+                    "component": "AccordionContent",
+                    "text": "A composable component library."
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ],
+  "stateBindings": [
+    {
+      "name": "value",
+      "valueProp": "value",
+      "defaultValueProp": "defaultValue",
+      "changeEvent": "onValueChange",
+      "valueType": "json"
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "payload": "void"
+    },
+    {
+      "name": "onValueChange",
+      "payload": "object"
+    }
+  ]
+}

package/spec/authoring/components/alert-action.json

@@ -0,0 +1,18 @@
+{
+  "id": "alert-action",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertAction",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Action",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AlertActions",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/alert-actions.json

@@ -0,0 +1,28 @@
+{
+  "id": "alert-actions",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertActions",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Actions",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "Alert",
+      "slot": "children"
+    }
+  ],
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AlertAction",
+        "AlertClose"
+      ],
+      "repeatable": true
+    }
+  ]
+}

package/spec/authoring/components/alert-body.json

@@ -0,0 +1,28 @@
+{
+  "id": "alert-body",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertBody",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Body",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AlertContent",
+      "slot": "children"
+    }
+  ],
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AlertTitle",
+        "AlertDescription"
+      ],
+      "repeatable": true
+    }
+  ]
+}

package/spec/authoring/components/alert-close.json

@@ -0,0 +1,22 @@
+{
+  "id": "alert-close",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertClose",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Close",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AlertActions",
+      "slot": "children"
+    },
+    {
+      "component": "Alert",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/alert-content.json

@@ -0,0 +1,33 @@
+{
+  "id": "alert-content",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertContent",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Content",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "Alert",
+      "slot": "children"
+    },
+    {
+      "component": "AlertRow",
+      "slot": "children"
+    }
+  ],
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AlertBody",
+        "AlertTitle",
+        "AlertDescription"
+      ],
+      "repeatable": true
+    }
+  ]
+}

package/spec/authoring/components/alert-description.json

@@ -0,0 +1,22 @@
+{
+  "id": "alert-description",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertDescription",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Description",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AlertBody",
+      "slot": "children"
+    },
+    {
+      "component": "AlertContent",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/alert-icon.json

@@ -0,0 +1,18 @@
+{
+  "id": "alert-icon",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertIcon",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Icon",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AlertRow",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/alert-row.json

@@ -0,0 +1,28 @@
+{
+  "id": "alert-row",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertRow",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Row",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "Alert",
+      "slot": "children"
+    }
+  ],
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AlertIcon",
+        "AlertContent"
+      ],
+      "repeatable": true
+    }
+  ]
+}

package/spec/authoring/components/alert-title.json

@@ -0,0 +1,22 @@
+{
+  "id": "alert-title",
+  "exportPath": "@refineui/react",
+  "exportName": "AlertTitle",
+  "kind": "part",
+  "category": "parts",
+  "label": "Alert Title",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "AlertBody",
+      "slot": "children"
+    },
+    {
+      "component": "AlertContent",
+      "slot": "children"
+    }
+  ]
+}

package/spec/authoring/components/alert.json

@@ -0,0 +1,85 @@
+{
+  "id": "alert",
+  "exportPath": "@refineui/react",
+  "exportName": "Alert",
+  "kind": "root",
+  "category": "components",
+  "label": "Alert",
+  "props": [
+    {
+      "name": "variant",
+      "label": "variant",
+      "valueType": "enum",
+      "control": "select",
+      "options": [
+        "default",
+        "info",
+        "success",
+        "warning",
+        "danger",
+        "custom"
+      ],
+      "defaultValue": "default",
+      "section": "variants"
+    }
+  ],
+  "preview": {
+    "mode": "full"
+  },
+  "slots": [
+    {
+      "name": "children",
+      "accepts": [
+        "AlertRow",
+        "AlertContent",
+        "AlertActions",
+        "AlertClose"
+      ],
+      "repeatable": true
+    }
+  ],
+  "presets": [
+    {
+      "id": "notice",
+      "label": "Notice",
+      "root": {
+        "component": "Alert",
+        "props": {
+          "variant": "info"
+        },
+        "slots": {
+          "children": [
+            {
+              "component": "AlertRow",
+              "slots": {
+                "children": [
+                  {
+                    "component": "AlertContent",
+                    "slots": {
+                      "children": [
+                        {
+                          "component": "AlertTitle",
+                          "text": "Heads up"
+                        },
+                        {
+                          "component": "AlertDescription",
+                          "text": "This is a helpful message."
+                        }
+                      ]
+                    }
+                  }
+                ]
+              }
+            }
+          ]
+        }
+      }
+    }
+  ],
+  "events": [
+    {
+      "name": "click",
+      "payload": "void"
+    }
+  ]
+}

package/spec/authoring/components/avatar-badge.json

@@ -0,0 +1,18 @@
+{
+  "id": "avatar-badge",
+  "exportPath": "@refineui/react",
+  "exportName": "AvatarBadge",
+  "kind": "part",
+  "category": "parts",
+  "label": "Avatar Badge",
+  "props": [],
+  "preview": {
+    "mode": "full"
+  },
+  "parents": [
+    {
+      "component": "Avatar",
+      "slot": "children"
+    }
+  ]
+}