@airdraft/ui-core 0.1.2 → 0.1.5

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 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.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)
+
+
+### Features
+
+* add `story` field type with schema definition and UI support; include media file for demo ([f5d3f88](https://github.com/aevrHQ/airdraft/commit/f5d3f884afda98e613c50ce1a0ebb3c591a84511))
+* enhance media field handling in renderTypes function to include metadata support ([b80245c](https://github.com/aevrHQ/airdraft/commit/b80245caf91e2a436172e875fff89c83a56b5ff3))
+* enhance MIME type handling in FilesSdkMediaAdapter and withMedia plugin ([186d33f](https://github.com/aevrHQ/airdraft/commit/186d33f33d31431c579a821eaa1a7a5ea13be4e7))
+* implement `blocks` field type with schema definition, validation, and UI support ([a3d57d1](https://github.com/aevrHQ/airdraft/commit/a3d57d11d82f38871fe044641bbb5a98cda3cb75))
+* **react-content:** add support for media lists and urls ([2cb0891](https://github.com/aevrHQ/airdraft/commit/2cb089102b0530217f305c782435138592f7754d))
+* **types:** add asCollectionConfig function for casting schema objects ([f5bcaaf](https://github.com/aevrHQ/airdraft/commit/f5bcaafa42fb43d749c89dfe7e7b075adcd18474))
+
+
+### Code Refactoring
+
+* code structure for improved readability and maintainability ([410de76](https://github.com/aevrHQ/airdraft/commit/410de761725340ea8edbb50b7de122797b58d942))
+
 ### [0.1.2](https://github.com/aevrHQ/airdraft/compare/ui-core@v0.1.1...ui-core@v0.1.2) (2026-05-23)
 
 ### [0.1.1](https://github.com/aevrHQ/airdraft/compare/ui-core@v0.1.0...ui-core@v0.1.1) (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/dist/field-type-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field-type-meta.d.ts","sourceRoot":"","sources":["../src/field-type-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAkBnF,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,aAEX,CAAA"}
+{"version":3,"file":"field-type-meta.d.ts","sourceRoot":"","sources":["../src/field-type-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAA;CACb;AAED,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,SAAS,EAAE,aAAa,GAAG;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAmBnF,CAAA;AAED,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,aAEX,CAAA"}

package/dist/field-type-meta.js

@@ -14,6 +14,7 @@ export const FIELD_TYPE_META = {
     object: { type: 'object', label: 'Object', description: 'Nested field group', icon: 'Braces' },
     url: { type: 'url', label: 'URL', description: 'Absolute or relative URL', icon: 'Link2' },
     media: { type: 'media', label: 'Media', description: 'File or media asset', icon: 'Paperclip' },
+    blocks: { type: 'blocks', label: 'Blocks', description: 'Structured nested fields', icon: 'LayoutList' },
     /** @deprecated hidden from picker — use 'media' for new fields */
     image: { type: 'image', label: 'Image', description: 'Image URL or media asset', icon: 'Image', hidden: true },
 };

package/dist/field-type-meta.js.map

@@ -1 +1 @@
-{"version":3,"file":"field-type-meta.js","sourceRoot":"","sources":["../src/field-type-meta.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,eAAe,GAA4D;IACtF,MAAM,EAAO,EAAE,IAAI,EAAE,QAAQ,EAAO,KAAK,EAAE,YAAY,EAAI,WAAW,EAAE,qBAAqB,EAAY,IAAI,EAAE,MAAM,EAAE;IACvH,IAAI,EAAS,EAAE,IAAI,EAAE,MAAM,EAAS,KAAK,EAAE,WAAW,EAAK,WAAW,EAAE,uBAAuB,EAAW,IAAI,EAAE,WAAW,EAAE;IAC7H,MAAM,EAAO,EAAE,IAAI,EAAE,QAAQ,EAAO,KAAK,EAAE,QAAQ,EAAQ,WAAW,EAAE,0BAA0B,EAAQ,IAAI,EAAE,MAAM,EAAE;IACxH,OAAO,EAAM,EAAE,IAAI,EAAE,SAAS,EAAM,KAAK,EAAE,SAAS,EAAO,WAAW,EAAE,qBAAqB,EAAa,IAAI,EAAE,YAAY,EAAE;IAC9H,IAAI,EAAS,EAAE,IAAI,EAAE,MAAM,EAAS,KAAK,EAAE,MAAM,EAAU,WAAW,EAAE,4BAA4B,EAAM,IAAI,EAAE,UAAU,EAAE;IAC5H,QAAQ,EAAK,EAAE,IAAI,EAAE,UAAU,EAAK,KAAK,EAAE,aAAa,EAAG,WAAW,EAAE,2BAA2B,EAAO,IAAI,EAAE,eAAe,EAAE;IACjI,IAAI,EAAS,EAAE,IAAI,EAAE,MAAM,EAAS,KAAK,EAAE,MAAM,EAAU,WAAW,EAAE,wBAAwB,EAAU,IAAI,EAAE,MAAM,EAAE;IACxH,MAAM,EAAO,EAAE,IAAI,EAAE,QAAQ,EAAO,KAAK,EAAE,QAAQ,EAAQ,WAAW,EAAE,yBAAyB,EAAS,IAAI,EAAE,aAAa,EAAE;IAC/H,WAAW,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,6BAA6B,EAAK,IAAI,EAAE,YAAY,EAAE;IAC9H,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAI,KAAK,EAAE,WAAW,EAAK,WAAW,EAAE,yBAAyB,EAAS,IAAI,EAAE,UAAU,EAAE;IAC5H,QAAQ,EAAK,EAAE,IAAI,EAAE,UAAU,EAAK,KAAK,EAAE,UAAU,EAAM,WAAW,EAAE,4BAA4B,EAAM,IAAI,EAAE,MAAM,EAAE;IACxH,SAAS,EAAI,EAAE,IAAI,EAAE,WAAW,EAAI,KAAK,EAAE,WAAW,EAAK,WAAW,EAAE,2BAA2B,EAAO,IAAI,EAAE,SAAS,EAAE;IAC3H,MAAM,EAAO,EAAE,IAAI,EAAE,QAAQ,EAAO,KAAK,EAAE,QAAQ,EAAQ,WAAW,EAAE,oBAAoB,EAAc,IAAI,EAAE,QAAQ,EAAE;IAC1H,GAAG,EAAU,EAAE,IAAI,EAAE,KAAK,EAAU,KAAK,EAAE,KAAK,EAAW,WAAW,EAAE,0BAA0B,EAAQ,IAAI,EAAE,OAAO,EAAE;IACzH,KAAK,EAAQ,EAAE,IAAI,EAAE,OAAO,EAAQ,KAAK,EAAE,OAAO,EAAS,WAAW,EAAE,qBAAqB,EAAa,IAAI,EAAE,WAAW,EAAE;IAC7H,kEAAkE;IAClE,KAAK,EAAQ,EAAE,IAAI,EAAE,OAAO,EAAQ,KAAK,EAAE,OAAO,EAAS,WAAW,EAAE,0BAA0B,EAAQ,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;CACxI,CAAA;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,mBAAmB,GAAI,MAAM,CAAC,MAAM,CAAC,eAAe,CAAiD;KAC/G,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;KACxB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA"}
+{"version":3,"file":"field-type-meta.js","sourceRoot":"","sources":["../src/field-type-meta.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@airdraft/ui-core",
-  "version": "0.1.2",
+  "version": "0.1.5",
   "description": "Airdraft UI core — field type metadata, validators, and schema mutation helpers (zero framework deps)",
   "type": "module",
   "main": "./dist/index.js",