@airdraft/ui-core 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to `@airdraft/ui-core` will be documented here.
+
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.

package/dist/constants.d.ts

@@ -0,0 +1,3 @@
+/** Collection names reserved by built-in API routes. */
+export declare const RESERVED_COLLECTION_NAMES: Set<string>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,eAAO,MAAM,yBAAyB,aAOpC,CAAA"}

package/dist/constants.js

@@ -0,0 +1,10 @@
+/** Collection names reserved by built-in API routes. */
+export const RESERVED_COLLECTION_NAMES = new Set([
+    'schema',
+    'media',
+    'openapi',
+    'health',
+    'apply',
+    'collections',
+]);
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAAC;IAC/C,QAAQ;IACR,OAAO;IACP,SAAS;IACT,QAAQ;IACR,OAAO;IACP,aAAa;CACd,CAAC,CAAA"}

package/dist/field-type-meta.d.ts

@@ -0,0 +1,10 @@
+import type { FieldType } from '@airdraft/core';
+export interface FieldTypeMeta {
+    type: FieldType;
+    label: string;
+    description: string;
+    /** Lucide icon name (resolved by @airdraft/react-ui into actual components) */
+    icon: string;
+}
+export declare const FIELD_TYPE_META: Record<FieldType, FieldTypeMeta>;
+//# sourceMappingURL=field-type-meta.d.ts.map

package/dist/field-type-meta.d.ts.map

@@ -0,0 +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,CAe5D,CAAA"}

package/dist/field-type-meta.js

@@ -0,0 +1,17 @@
+export const FIELD_TYPE_META = {
+    string: { type: 'string', label: 'Short text', description: 'Single line of text', icon: 'Type' },
+    text: { type: 'text', label: 'Long text', description: 'Multi-line plain text', icon: 'AlignLeft' },
+    number: { type: 'number', label: 'Number', description: 'Integer or decimal value', icon: 'Hash' },
+    boolean: { type: 'boolean', label: 'Boolean', description: 'True / false toggle', icon: 'ToggleLeft' },
+    date: { type: 'date', label: 'Date', description: 'Calendar date (YYYY-MM-DD)', icon: 'Calendar' },
+    datetime: { type: 'datetime', label: 'Date & time', description: 'Date with time (ISO 8601)', icon: 'CalendarClock' },
+    list: { type: 'list', label: 'List', description: 'Array of scalar values', icon: 'List' },
+    select: { type: 'select', label: 'Select', description: 'One of a set of options', icon: 'ChevronDown' },
+    multiselect: { type: 'multiselect', label: 'Multi-select', description: 'Multiple selectable options', icon: 'ListChecks' },
+    'rich-text': { type: 'rich-text', label: 'Rich text', description: 'MDX / rich body content', icon: 'FileText' },
+    relation: { type: 'relation', label: 'Relation', description: 'Reference to another entry', icon: 'Link' },
+    relations: { type: 'relations', label: 'Relations', description: 'Multiple entry references', icon: 'Network' },
+    object: { type: 'object', label: 'Object', description: 'Nested field group', icon: 'Braces' },
+    image: { type: 'image', label: 'Image', description: 'Image URL or media asset', icon: 'Image' },
+};
+//# sourceMappingURL=field-type-meta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field-type-meta.js","sourceRoot":"","sources":["../src/field-type-meta.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,MAAM,eAAe,GAAqC;IAC/D,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,KAAK,EAAQ,EAAE,IAAI,EAAE,OAAO,EAAQ,KAAK,EAAE,OAAO,EAAS,WAAW,EAAE,0BAA0B,EAAQ,IAAI,EAAE,OAAO,EAAE;CAC1H,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { FIELD_TYPE_META } from './field-type-meta.js';
+export type { FieldTypeMeta } from './field-type-meta.js';
+export { RESERVED_COLLECTION_NAMES } from './constants.js';
+export { validateFieldKey, generateFieldKey, validateCollectionName, } from './validators.js';
+export { applyFieldUpdate, applyFieldDelete, buildDefaultPath } from './mutations.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAE1D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { FIELD_TYPE_META } from './field-type-meta.js';
+export { RESERVED_COLLECTION_NAMES } from './constants.js';
+export { validateFieldKey, generateFieldKey, validateCollectionName, } from './validators.js';
+export { applyFieldUpdate, applyFieldDelete, buildDefaultPath } from './mutations.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAE1D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/mutations.d.ts

@@ -0,0 +1,8 @@
+import type { CollectionMap, FieldConfig } from '@airdraft/core';
+/** Add or overwrite a field on a collection, returning a new CollectionMap. */
+export declare function applyFieldUpdate(collections: CollectionMap, collectionName: string, fieldKey: string, fieldConfig: FieldConfig): CollectionMap;
+/** Remove a field from a collection, returning a new CollectionMap. */
+export declare function applyFieldDelete(collections: CollectionMap, collectionName: string, fieldKey: string): CollectionMap;
+/** Build the default path template for a new collection. */
+export declare function buildDefaultPath(name: string, format: 'mdx' | 'json' | 'yaml'): string;
+//# sourceMappingURL=mutations.d.ts.map

package/dist/mutations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../src/mutations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEhE,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,aAAa,EAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,WAAW,GACvB,aAAa,CAUf;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,aAAa,EAC1B,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACf,aAAa,CAOf;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAEtF"}

package/dist/mutations.js

@@ -0,0 +1,26 @@
+/** Add or overwrite a field on a collection, returning a new CollectionMap. */
+export function applyFieldUpdate(collections, collectionName, fieldKey, fieldConfig) {
+    const col = collections[collectionName];
+    if (!col)
+        return collections;
+    return {
+        ...collections,
+        [collectionName]: {
+            ...col,
+            fields: { ...col.fields, [fieldKey]: fieldConfig },
+        },
+    };
+}
+/** Remove a field from a collection, returning a new CollectionMap. */
+export function applyFieldDelete(collections, collectionName, fieldKey) {
+    const col = collections[collectionName];
+    if (!col)
+        return collections;
+    const fields = Object.fromEntries(Object.entries(col.fields ?? {}).filter(([k]) => k !== fieldKey));
+    return { ...collections, [collectionName]: { ...col, fields } };
+}
+/** Build the default path template for a new collection. */
+export function buildDefaultPath(name, format) {
+    return `${name}/{slug}.${format}`;
+}
+//# sourceMappingURL=mutations.js.map

package/dist/mutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutations.js","sourceRoot":"","sources":["../src/mutations.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAC9B,WAA0B,EAC1B,cAAsB,EACtB,QAAgB,EAChB,WAAwB;IAExB,MAAM,GAAG,GAAG,WAAW,CAAC,cAAc,CAAC,CAAA;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,WAAW,CAAA;IAC5B,OAAO;QACL,GAAG,WAAW;QACd,CAAC,cAAc,CAAC,EAAE;YAChB,GAAG,GAAG;YACN,MAAM,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE;SACnD;KACF,CAAA;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAC9B,WAA0B,EAC1B,cAAsB,EACtB,QAAgB;IAEhB,MAAM,GAAG,GAAG,WAAW,CAAC,cAAc,CAAC,CAAA;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,WAAW,CAAA;IAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC/B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,CAAC,CACjE,CAAA;IACD,OAAO,EAAE,GAAG,WAAW,EAAE,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,EAAE,CAAA;AACjE,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAA+B;IAC5E,OAAO,GAAG,IAAI,WAAW,MAAM,EAAE,CAAA;AACnC,CAAC"}

package/dist/validators.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Validate a field key string.
+ * Returns an error message string, or null if valid.
+ */
+export declare function validateFieldKey(key: string): string | null;
+/**
+ * Derive a valid field key from a human-readable label.
+ * e.g. "Author Name" → "author_name"
+ */
+export declare function generateFieldKey(label: string): string;
+/**
+ * Validate a collection name.
+ * Returns an error message string, or null if valid.
+ */
+export declare function validateCollectionName(name: string): string | null;
+//# sourceMappingURL=validators.d.ts.map

package/dist/validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAO3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUlE"}

package/dist/validators.js

@@ -0,0 +1,43 @@
+import { RESERVED_COLLECTION_NAMES } from './constants.js';
+/**
+ * Validate a field key string.
+ * Returns an error message string, or null if valid.
+ */
+export function validateFieldKey(key) {
+    const trimmed = key.trim();
+    if (!trimmed)
+        return 'Field key is required.';
+    if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(trimmed)) {
+        return 'Field key must start with a letter and contain only a-z, A-Z, 0-9, _.';
+    }
+    return null;
+}
+/**
+ * Derive a valid field key from a human-readable label.
+ * e.g. "Author Name" → "author_name"
+ */
+export function generateFieldKey(label) {
+    return label
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .replace(/^(\d)/, '_$1');
+}
+/**
+ * Validate a collection name.
+ * Returns an error message string, or null if valid.
+ */
+export function validateCollectionName(name) {
+    const trimmed = name.trim().toLowerCase();
+    if (!trimmed)
+        return 'Collection name is required.';
+    if (RESERVED_COLLECTION_NAMES.has(trimmed)) {
+        return `"${trimmed}" is a reserved collection name.`;
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(trimmed)) {
+        return 'Collection name must start with a letter and contain only a-z, 0-9, -.';
+    }
+    return null;
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAA;AAE1D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAA;IAC1B,IAAI,CAAC,OAAO;QAAE,OAAO,wBAAwB,CAAA;IAC7C,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,OAAO,uEAAuE,CAAA;IAChF,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK;SACT,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACzC,IAAI,CAAC,OAAO;QAAE,OAAO,8BAA8B,CAAA;IACnD,IAAI,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,OAAO,kCAAkC,CAAA;IACtD,CAAC;IACD,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,OAAO,wEAAwE,CAAA;IACjF,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@airdraft/ui-core",
+  "version": "0.1.0",
+  "description": "Airdraft UI core — field type metadata, validators, and schema mutation helpers (zero framework deps)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": ["dist", "README.md", "CHANGELOG.md"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "release": "standard-version",
+    "release:patch": "standard-version --release-as patch",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major"
+  },
+  "publishConfig": { "access": "public" },
+  "license": "MIT",
+  "dependencies": {
+    "@airdraft/core": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "standard-version": "^9.5.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": { "node": ">=18.0.0" }
+}