@airdraft/ui-core 0.1.3 → 0.1.6

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.1.6](https://github.com/aevrHQ/airdraft/compare/ui-core@v0.1.5...ui-core@v0.1.6) (2026-05-23)
+
+
+### Bug Fixes
+
+* **build:** bump react-content peer dependencies ([9c33815](https://github.com/aevrHQ/airdraft/commit/9c338158eca40c418f5ad37e829b0a2f213a2e33))
+* move @airdraft/core to peerDependencies in all consumer-facing packages ([f7653ff](https://github.com/aevrHQ/airdraft/commit/f7653ffd7109cbe76f09df8766a70de1b24afdba))
+* **react-content:** entryCard children injection and sub-component auto-read ([a57cc48](https://github.com/aevrHQ/airdraft/commit/a57cc483b96986d5825e1c6d28a66c400bd57972))
+
+### [0.1.5](https://github.com/aevrHQ/airdraft/compare/ui-core@v0.1.3...ui-core@v0.1.5) (2026-05-23)
+
+
+### Documentation
+
+* **ui-core:** add README.md for shared UI-layer constants and utilities ([91fb464](https://github.com/aevrHQ/airdraft/commit/91fb4643eb7340ea16b1db9fd06e33ce0866b4b3))
+
+### [0.1.4](https://github.com/aevrHQ/airdraft/compare/ui-core@v0.1.3...ui-core@v0.1.4) (2026-05-23)
+
 ### [0.1.3](https://github.com/aevrHQ/airdraft/compare/ui-core@v0.1.2...ui-core@v0.1.3) (2026-05-23)
 
 

package/README.md

@@ -0,0 +1,68 @@
+# @airdraft/ui-core
+
+Shared UI-layer constants and utilities for Airdraft. Provides field-type metadata (labels, icons, descriptions), the schema editor mutation helpers, and collection name validators consumed by `@airdraft/react-ui`.
+
+## Installation
+
+```bash
+npm install @airdraft/ui-core
+```
+
+This package is typically a transitive dependency — you don't need to install it directly unless you're building a custom schema editor or type picker.
+
+## Exports
+
+### Field type metadata
+
+```ts
+import { FIELD_TYPE_META, VISIBLE_FIELD_TYPES } from '@airdraft/ui-core'
+import type { FieldTypeMeta } from '@airdraft/ui-core'
+```
+
+| Export | Description |
+|---|---|
+| `FIELD_TYPE_META` | `Record<FieldType, FieldTypeMeta>` — label, description, and Lucide icon name for every field type |
+| `VISIBLE_FIELD_TYPES` | `FieldType[]` — all field types with `hidden !== true`; use this to populate a type picker (excludes the deprecated `image` type) |
+| `FieldTypeMeta` | `{ type, label, description, icon, hidden? }` |
+
+**Supported field types** (all included in `FIELD_TYPE_META`):
+
+`string` · `text` · `number` · `boolean` · `date` · `datetime` · `list` · `select` · `multiselect` · `rich-text` · `relation` · `relations` · `object` · `url` · `media` · `blocks`
+
+`image` is present but marked `hidden: true` — it is excluded from `VISIBLE_FIELD_TYPES` and the schema editor type picker. Use `media` for new fields.
+
+### Schema editor mutations
+
+```ts
+import { applyFieldUpdate, applyFieldDelete, buildDefaultPath } from '@airdraft/ui-core'
+```
+
+| Export | Description |
+|---|---|
+| `applyFieldUpdate(schema, collection, key, config)` | Returns a new `CmsSchema` with the field upserted |
+| `applyFieldDelete(schema, collection, key)` | Returns a new `CmsSchema` with the field removed |
+| `buildDefaultPath(collection, format, slugSource?)` | Generates a default `path` pattern for a new collection |
+
+### Validators
+
+```ts
+import { validateFieldKey, generateFieldKey, validateCollectionName } from '@airdraft/ui-core'
+```
+
+| Export | Description |
+|---|---|
+| `validateFieldKey(key)` | Returns an error string if the key is invalid (empty, reserved, non-slug), or `null` if valid |
+| `generateFieldKey(label)` | Converts a human label to a valid snake_case field key |
+| `validateCollectionName(name)` | Returns an error string if the name collides with a reserved route, or `null` if valid |
+
+### Constants
+
+```ts
+import { RESERVED_COLLECTION_NAMES } from '@airdraft/ui-core'
+```
+
+`RESERVED_COLLECTION_NAMES` — `Set<string>` of names that cannot be used as collection names (`schema`, `media`, `openapi`, `health`, etc.).
+
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airdraft/ui-core",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Airdraft UI core — field type metadata, validators, and schema mutation helpers (zero framework deps)",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,15 +31,16 @@
     "access": "public"
   },
   "license": "MIT",
-  "dependencies": {
-    "@airdraft/core": "*"
-  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "standard-version": "^9.5.0",
-    "typescript": "^5.4.0"
+    "typescript": "^5.4.0",
+    "@airdraft/core": "*"
   },
   "engines": {
     "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@airdraft/core": ">=0.1.8"
   }
 }