@santi020k/lumen 0.1.0

package/dist/registry-types.d.ts

@@ -0,0 +1,33 @@
+export interface LumenRegistryFile {
+    path: string;
+    source: string;
+}
+export interface LumenRegistryComponent {
+    category: string;
+    dependencies?: readonly string[];
+    description: string;
+    files: readonly (LumenRegistryFile | string)[];
+    name: string;
+    type: 'component';
+}
+export interface LumenRegistryItem {
+    components?: readonly string[];
+    files?: readonly (LumenRegistryFile | string)[];
+    name: string;
+    type: 'component-set' | 'documentation' | 'recipe';
+}
+export type LumenRegistryEntry = LumenRegistryComponent | LumenRegistryItem;
+export interface LumenRegistry {
+    components?: readonly LumenRegistryComponent[];
+    description: string;
+    items: readonly LumenRegistryItem[];
+    name: string;
+    packages: readonly string[];
+    version: number;
+}
+export interface LumenRegistryLoadOptions {
+    headers?: Record<string, string>;
+    timeoutMs?: number;
+    token?: string;
+}
+//# sourceMappingURL=registry-types.d.ts.map

package/dist/registry-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-types.d.ts","sourceRoot":"","sources":["../src/registry-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAChC,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,SAAS,CAAC,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAA;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,WAAW,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC9B,KAAK,CAAC,EAAE,SAAS,CAAC,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAA;IAC/C,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,eAAe,GAAG,eAAe,GAAG,QAAQ,CAAA;CACnD;AAED,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,GAAG,iBAAiB,CAAA;AAE3E,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;IAC9C,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAA;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}

package/dist/registry-types.js

@@ -0,0 +1 @@
+export {};

package/dist/registry.d.ts

@@ -0,0 +1,9 @@
+import { lumenRegistry } from './registry-data.js';
+import type { LumenRegistry, LumenRegistryComponent, LumenRegistryEntry, LumenRegistryFile, LumenRegistryItem, LumenRegistryLoadOptions } from './registry-types.js';
+export { lumenRegistry };
+export type { LumenRegistry, LumenRegistryComponent, LumenRegistryEntry, LumenRegistryFile, LumenRegistryItem, LumenRegistryLoadOptions };
+export declare const getLumenRegistryEntries: (registry?: LumenRegistry) => LumenRegistryEntry[];
+export declare const getLumenRegistryItem: (name: string, registry?: LumenRegistry) => LumenRegistryEntry | undefined;
+export declare const loadLumenRegistry: (source: string | URL, options?: LumenRegistryLoadOptions) => Promise<LumenRegistry>;
+export { addLumenRegistryItem, type LumenAddOptions, type LumenAddResult, type LumenAddTarget, type LumenMergeConflict } from './installer.js';
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,KAAK,EACV,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EAAE,aAAa,EAAE,CAAA;AAExB,YAAY,EACV,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACzB,CAAA;AAOD,eAAO,MAAM,uBAAuB,GAAI,WAAU,aAA6B,KAAG,kBAAkB,EAGnG,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,MAAM,MAAM,EACZ,WAAU,aAA6B,KACtC,kBAAkB,GAAG,SAMvB,CAAA;AAgFD,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,MAAM,GAAG,GAAG,EACpB,UAAS,wBAA6B,KACrC,OAAO,CAAC,aAAa,CAcvB,CAAA;AAED,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACxB,MAAM,gBAAgB,CAAA"}

package/dist/registry.js

@@ -0,0 +1,89 @@
+/* eslint-disable complexity */
+import { readFile } from 'node:fs/promises';
+import { lumenRegistry } from './registry-data.js';
+export { lumenRegistry };
+const defaultRegistryTimeoutMs = 30_000;
+const normalizeRegistryEntryName = (name) => name.replaceAll(/([a-z0-9])([A-Z])/g, '$1-$2').replaceAll(/[\s_]+/g, '-').toLowerCase();
+export const getLumenRegistryEntries = (registry = lumenRegistry) => [
+    ...(registry.components ?? []),
+    ...registry.items
+];
+export const getLumenRegistryItem = (name, registry = lumenRegistry) => {
+    const normalizedName = normalizeRegistryEntryName(name);
+    const entries = getLumenRegistryEntries(registry);
+    return entries.find(item => item.name === name) ??
+        entries.find(item => normalizeRegistryEntryName(item.name) === normalizedName);
+};
+const isRegistryFile = (value) => {
+    if (typeof value === 'string')
+        return value.length > 0;
+    if (!value || typeof value !== 'object')
+        return false;
+    const file = value;
+    return typeof file.path === 'string' && typeof file.source === 'string';
+};
+const isStringArray = (value) => Array.isArray(value) && value.every(entry => typeof entry === 'string');
+const isRegistryFileArray = (value) => Array.isArray(value) && value.every(entry => isRegistryFile(entry));
+const registryItemTypes = new Set(['component-set', 'documentation', 'recipe']);
+const isRegistryItem = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const item = value;
+    return typeof item.name === 'string' &&
+        typeof item.type === 'string' &&
+        registryItemTypes.has(item.type) &&
+        (item.components === undefined || isStringArray(item.components)) &&
+        (item.files === undefined || isRegistryFileArray(item.files));
+};
+const isRegistryComponent = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const component = value;
+    return typeof component.name === 'string' &&
+        component.type === 'component' &&
+        typeof component.description === 'string' &&
+        typeof component.category === 'string' &&
+        isRegistryFileArray(component.files) &&
+        (component.dependencies === undefined || isStringArray(component.dependencies));
+};
+const isLumenRegistry = (value) => {
+    if (!value || typeof value !== 'object')
+        return false;
+    const registry = value;
+    return typeof registry.name === 'string' &&
+        typeof registry.version === 'number' &&
+        typeof registry.description === 'string' &&
+        isStringArray(registry.packages) &&
+        Array.isArray(registry.items) &&
+        registry.items.every(item => isRegistryItem(item)) &&
+        (registry.components === undefined ||
+            (Array.isArray(registry.components) && registry.components.every(component => isRegistryComponent(component))));
+};
+const fetchRegistrySource = async (source, options) => {
+    if (options.token && source.startsWith('http://')) {
+        throw new Error('Refusing to send a Lumen registry token over plain HTTP. Use an https:// registry URL.');
+    }
+    const response = await fetch(source, {
+        headers: {
+            ...options.headers,
+            ...(options.token ? { authorization: `Bearer ${options.token}` } : {})
+        },
+        signal: AbortSignal.timeout(options.timeoutMs ?? defaultRegistryTimeoutMs)
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to load Lumen registry: ${response.status} ${response.statusText}`);
+    }
+    return response.text();
+};
+export const loadLumenRegistry = async (source, options = {}) => {
+    const sourceValue = String(source);
+    const raw = sourceValue.startsWith('http://') || sourceValue.startsWith('https://')
+        ? await fetchRegistrySource(sourceValue, options)
+        : await readFile(source, 'utf8');
+    const parsed = JSON.parse(raw);
+    if (!isLumenRegistry(parsed)) {
+        throw new Error('Invalid Lumen registry manifest');
+    }
+    return parsed;
+};
+export { addLumenRegistryItem } from './installer.js';

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@santi020k/lumen",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Umbrella package for the Lumen multi-framework primitive UI system.",
+  "type": "module",
+  "sideEffects": [
+    "./styles.css"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./registry": {
+      "types": "./dist/registry.d.ts",
+      "import": "./dist/registry.js"
+    },
+    "./styles.css": "./styles.css",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "styles.css",
+    "README.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "lumen": "./bin/lumen.mjs"
+  },
+  "dependencies": {
+    "@santi020k/lumen-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^26.1.1",
+    "@vitest/coverage-v8": "^4.1.10",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.10"
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/santi020k/lumen.git",
+    "directory": "packages/lumen"
+  },
+  "homepage": "https://lumen.santi020k.com",
+  "bugs": {
+    "url": "https://github.com/santi020k/lumen/issues"
+  },
+  "author": {
+    "name": "Santiago Molina",
+    "url": "https://santi020k.com"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch --preserveWatchOutput",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts --project lumen",
+    "test:coverage": "vitest run --config ../../vitest.config.ts --project lumen --coverage",
+    "lint": "eslint . --no-warn-ignored",
+    "lint:fix": "eslint . --fix --no-warn-ignored",
+    "clean": "rm -rf dist coverage"
+  }
+}