@elytracms/core 0.0.6

package/dist/studio-core/repository.js

@@ -0,0 +1,202 @@
+import { slugify } from './ids';
+import { BackendUnavailableError, ProjectConflictError, ProjectNotFoundError, ProjectValidationError, } from './errors';
+import { defaultEnvironments, projectSchema, toSummary, } from './metadata';
+import { allSectionsAvailable } from './sections';
+import { validateProjectIdentity, validateProjectSettings } from './validate';
+/**
+ * Deterministic clock for fixtures/tests: starts at `startISO` and advances a
+ * fixed step on each call, so repeated runs produce identical timestamps.
+ */
+export function createSequentialClock(startISO = '2026-01-01T00:00:00.000Z', stepMs = 1000) {
+    let current = Date.parse(startISO);
+    return () => {
+        const iso = new Date(current).toISOString();
+        current += stepMs;
+        return iso;
+    };
+}
+export function createSequentialIdFactory(prefix = 'prj') {
+    let n = 0;
+    return () => {
+        n += 1;
+        return `${prefix}_${String(n).padStart(6, '0')}`;
+    };
+}
+function defaultSettings() {
+    return {
+        locales: ['en'],
+        defaultLocale: 'en',
+        environments: defaultEnvironments(),
+        exportTarget: 'next-app-router',
+        sectionAvailability: allSectionsAvailable(),
+    };
+}
+function mergeSettings(base, patch) {
+    if (!patch)
+        return base;
+    return { ...base, ...patch };
+}
+/** Deep-ish clone so stored records never share mutable references with callers. */
+function cloneProject(project) {
+    return {
+        ...project,
+        settings: {
+            ...project.settings,
+            locales: [...project.settings.locales],
+            environments: project.settings.environments.map((e) => ({ ...e })),
+            sectionAvailability: { ...project.settings.sectionAvailability },
+        },
+    };
+}
+/**
+ * In-memory `ProjectRepository` (brief §10). Backs fixtures, tests, and browser
+ * inspection before Convex exists. Validates identity + settings on every write
+ * and enforces slug uniqueness across non-deleted projects.
+ */
+export class InMemoryProjectRepository {
+    projects = new Map();
+    order = [];
+    clock;
+    nextId;
+    constructor(options = {}) {
+        this.clock = options.clock ?? createSequentialClock();
+        this.nextId = options.idFactory ?? createSequentialIdFactory();
+        for (const project of options.seed ?? []) {
+            const parsed = projectSchemaSafeParse(project);
+            this.projects.set(parsed.id, cloneProject(parsed));
+            this.order.push(parsed.id);
+        }
+    }
+    async list() {
+        return this.order
+            .map((id) => this.projects.get(id))
+            .sort((a, b) => {
+            const av = a.updatedAt ?? '';
+            const bv = b.updatedAt ?? '';
+            return av < bv ? 1 : av > bv ? -1 : 0;
+        })
+            .map(toSummary);
+    }
+    async get(id) {
+        const project = this.projects.get(id);
+        if (!project)
+            throw new ProjectNotFoundError(id);
+        return cloneProject(project);
+    }
+    async create(input) {
+        const slug = (input.slug ?? slugify(input.name));
+        this.assertIdentity(input.name, slug);
+        this.assertSlugAvailable(slug, null);
+        const settings = mergeSettings(defaultSettings(), input.settings);
+        this.assertSettings(settings);
+        const now = this.clock();
+        const project = {
+            id: this.nextId(),
+            name: input.name.trim(),
+            slug,
+            createdAt: now,
+            updatedAt: now,
+            settings,
+        };
+        this.projects.set(project.id, cloneProject(project));
+        this.order.push(project.id);
+        return cloneProject(project);
+    }
+    async update(id, input) {
+        const existing = this.projects.get(id);
+        if (!existing)
+            throw new ProjectNotFoundError(id);
+        const name = input.name ?? existing.name;
+        const slug = (input.slug ?? existing.slug);
+        this.assertIdentity(name, slug);
+        if (slug !== existing.slug)
+            this.assertSlugAvailable(slug, id);
+        const settings = mergeSettings(existing.settings, input.settings);
+        this.assertSettings(settings);
+        const updated = {
+            ...existing,
+            name: name.trim(),
+            slug,
+            settings,
+            updatedAt: this.clock(),
+        };
+        this.projects.set(id, cloneProject(updated));
+        return cloneProject(updated);
+    }
+    async duplicate(id, input = {}) {
+        const source = this.projects.get(id);
+        if (!source)
+            throw new ProjectNotFoundError(id);
+        const name = input.name ?? `${source.name} copy`;
+        const slug = (input.slug ?? this.deriveUniqueSlug(slugify(name) || `${source.slug}-copy`));
+        this.assertIdentity(name, slug);
+        this.assertSlugAvailable(slug, null);
+        const now = this.clock();
+        const copy = {
+            ...cloneProject(source),
+            id: this.nextId(),
+            name: name.trim(),
+            slug,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.projects.set(copy.id, cloneProject(copy));
+        this.order.push(copy.id);
+        return cloneProject(copy);
+    }
+    async delete(id) {
+        if (!this.projects.has(id))
+            throw new ProjectNotFoundError(id);
+        this.projects.delete(id);
+        const index = this.order.indexOf(id);
+        if (index >= 0)
+            this.order.splice(index, 1);
+    }
+    // --- internals -----------------------------------------------------------
+    assertIdentity(name, slug) {
+        const issues = validateProjectIdentity({ name, slug });
+        if (issues.length > 0) {
+            throw new ProjectValidationError('Project identity is invalid.', issues);
+        }
+    }
+    assertSettings(settings) {
+        const issues = validateProjectSettings(settings);
+        if (issues.some((i) => i.severity === 'error')) {
+            throw new ProjectValidationError('Project settings are invalid.', issues);
+        }
+    }
+    assertSlugAvailable(slug, ignoreId) {
+        for (const project of this.projects.values()) {
+            if (project.id !== ignoreId && project.slug === slug) {
+                throw new ProjectConflictError(`A project with slug “${slug}” already exists.`, slug);
+            }
+        }
+    }
+    deriveUniqueSlug(base) {
+        const taken = new Set([...this.projects.values()].map((p) => p.slug));
+        if (!taken.has(base))
+            return base;
+        let n = 2;
+        while (taken.has(`${base}-${n}`))
+            n += 1;
+        return `${base}-${n}`;
+    }
+}
+/** Parse-and-throw helper that surfaces a typed validation error for bad seeds. */
+function projectSchemaSafeParse(project) {
+    const result = projectSchema.safeParse(project);
+    if (!result.success) {
+        throw new ProjectValidationError('Seed project failed schema validation.', result.error.issues.map((i) => ({
+            code: 'invalid-name',
+            severity: 'error',
+            message: i.message,
+            path: i.path.map((p) => (typeof p === 'symbol' ? String(p) : p)),
+        })));
+    }
+    return result.data;
+}
+/** Convenience guard used by callers that prefer a boolean to a thrown error. */
+export function isBackendUnavailable(error) {
+    return error instanceof BackendUnavailableError;
+}
+//# sourceMappingURL=repository.js.map

package/dist/studio-core/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../src/studio-core/repository.ts"],"names":[],"mappings":"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"}

package/dist/studio-core/sections.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/**
+ * The top-level Studio surfaces (brief §8.1). The Studio shell preserves the
+ * active project while the user moves between these.
+ *
+ * The former `data` section was retired (EC-167, vision AD-9): external data is
+ * a developer concern expressed as typed providers registered in code, surfaced
+ * to editors through the CMS Canvas tab — there is no standalone no-code data
+ * surface.
+ *
+ * The former `builder` section was retired (EC-210, vision AD-12): the canvas is
+ * no longer a standalone place but a composition-field surface inside the CMS
+ * detail editor. The `/builder` route survives only as a redirect.
+ */
+export declare const sectionIdSchema: z.ZodEnum<{
+    components: "components";
+    assets: "assets";
+    cms: "cms";
+    extensions: "extensions";
+    settings: "settings";
+}>;
+export type SectionId = z.infer<typeof sectionIdSchema>;
+/** Canonical order in which sections appear in navigation. */
+export declare const SECTION_IDS: ("components" | "assets" | "cms" | "extensions" | "settings")[];
+export interface SectionDescriptor {
+    readonly id: SectionId;
+    readonly label: string;
+    /** Short description used in tooltips / empty states. */
+    readonly description: string;
+}
+export declare const SECTIONS: Readonly<Record<SectionId, SectionDescriptor>>;
+/**
+ * Whether a section is usable for a given project. `available` renders the live
+ * surface; `planned` is reachable but shows a deterministic placeholder; the
+ * section is simply hidden/disabled when `unavailable`.
+ */
+export declare const sectionAvailabilitySchema: z.ZodEnum<{
+    available: "available";
+    planned: "planned";
+    unavailable: "unavailable";
+}>;
+export type SectionAvailability = z.infer<typeof sectionAvailabilitySchema>;
+/** Availability per section for a project. */
+export declare const sectionAvailabilityMapSchema: z.ZodRecord<z.ZodEnum<{
+    components: "components";
+    assets: "assets";
+    cms: "cms";
+    extensions: "extensions";
+    settings: "settings";
+}>, z.ZodEnum<{
+    available: "available";
+    planned: "planned";
+    unavailable: "unavailable";
+}>>;
+export type SectionAvailabilityMap = z.infer<typeof sectionAvailabilityMapSchema>;
+/**
+ * Deterministic runtime states a section surface can be in (brief §8.1, §11).
+ * Distinct from availability: an `available` section may still be `loading` or
+ * `error` at runtime.
+ */
+export declare const sectionStateSchema: z.ZodEnum<{
+    error: "error";
+    planned: "planned";
+    unavailable: "unavailable";
+    empty: "empty";
+    loading: "loading";
+    working: "working";
+}>;
+export type SectionState = z.infer<typeof sectionStateSchema>;
+/** Every section available — the default for a fully-provisioned project. */
+export declare function allSectionsAvailable(): SectionAvailabilityMap;
+/** Resolve availability for a section, treating an absent entry as `unavailable`. */
+export declare function availabilityOf(map: SectionAvailabilityMap, id: SectionId): SectionAvailability;

package/dist/studio-core/sections.js

@@ -0,0 +1,68 @@
+import { z } from 'zod';
+/**
+ * The top-level Studio surfaces (brief §8.1). The Studio shell preserves the
+ * active project while the user moves between these.
+ *
+ * The former `data` section was retired (EC-167, vision AD-9): external data is
+ * a developer concern expressed as typed providers registered in code, surfaced
+ * to editors through the CMS Canvas tab — there is no standalone no-code data
+ * surface.
+ *
+ * The former `builder` section was retired (EC-210, vision AD-12): the canvas is
+ * no longer a standalone place but a composition-field surface inside the CMS
+ * detail editor. The `/builder` route survives only as a redirect.
+ */
+export const sectionIdSchema = z.enum([
+    'components',
+    'cms',
+    'assets',
+    'extensions',
+    'settings',
+]);
+/** Canonical order in which sections appear in navigation. */
+export const SECTION_IDS = sectionIdSchema.options;
+export const SECTIONS = {
+    components: {
+        id: 'components',
+        label: 'Components',
+        description: 'Browse the registry of primitives and project components.',
+    },
+    cms: { id: 'cms', label: 'CMS', description: 'Model collections, fields, and documents.' },
+    assets: { id: 'assets', label: 'Assets', description: 'Manage uploaded media and metadata.' },
+    extensions: {
+        id: 'extensions',
+        label: 'Extensions',
+        description: 'Install components, field types, adapters, and templates from the marketplace.',
+    },
+    settings: { id: 'settings', label: 'Settings', description: 'Configure project metadata and locales.' },
+};
+/**
+ * Whether a section is usable for a given project. `available` renders the live
+ * surface; `planned` is reachable but shows a deterministic placeholder; the
+ * section is simply hidden/disabled when `unavailable`.
+ */
+export const sectionAvailabilitySchema = z.enum(['available', 'planned', 'unavailable']);
+/** Availability per section for a project. */
+export const sectionAvailabilityMapSchema = z.record(sectionIdSchema, sectionAvailabilitySchema);
+/**
+ * Deterministic runtime states a section surface can be in (brief §8.1, §11).
+ * Distinct from availability: an `available` section may still be `loading` or
+ * `error` at runtime.
+ */
+export const sectionStateSchema = z.enum([
+    'empty',
+    'loading',
+    'error',
+    'unavailable',
+    'planned',
+    'working',
+]);
+/** Every section available — the default for a fully-provisioned project. */
+export function allSectionsAvailable() {
+    return Object.fromEntries(SECTION_IDS.map((id) => [id, 'available']));
+}
+/** Resolve availability for a section, treating an absent entry as `unavailable`. */
+export function availabilityOf(map, id) {
+    return map[id] ?? 'unavailable';
+}
+//# sourceMappingURL=sections.js.map

package/dist/studio-core/sections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sections.js","sourceRoot":"","sources":["../../src/studio-core/sections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,YAAY;IACZ,KAAK;IACL,QAAQ;IACR,YAAY;IACZ,UAAU;CACX,CAAC,CAAA;AAGF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,OAAO,CAAA;AASlD,MAAM,CAAC,MAAM,QAAQ,GAAmD;IACtE,UAAU,EAAE;QACV,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,2DAA2D;KACzE;IACD,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,2CAA2C,EAAE;IAC1F,MAAM,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,qCAAqC,EAAE;IAC7F,UAAU,EAAE;QACV,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,gFAAgF;KAC9F;IACD,QAAQ,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,yCAAyC,EAAE;CACxG,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;AAGxF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC,CAAA;AAGhG;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACvC,OAAO;IACP,SAAS;IACT,OAAO;IACP,aAAa;IACb,SAAS;IACT,SAAS;CACV,CAAC,CAAA;AAGF,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB;IAClC,OAAO,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,WAAW,CAAC,CAAC,CAA2B,CAAA;AACjG,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAC5B,GAA2B,EAC3B,EAAa;IAEb,OAAO,GAAG,CAAC,EAAE,CAAC,IAAI,aAAa,CAAA;AACjC,CAAC"}

package/dist/studio-core/validate.d.ts

@@ -0,0 +1,15 @@
+import type { ProjectSettings } from './metadata';
+import type { StudioIssue } from './issues';
+/**
+ * Semantic validation of project settings (brief §7.7, §8.7). Never throws —
+ * returns structured issues so the Settings surface can show dirty/invalid
+ * states while the user edits. Field *shapes* are checked by
+ * `projectSettingsSchema`; this layer checks cross-field and content rules.
+ */
+export declare function validateProjectSettings(settings: ProjectSettings): StudioIssue[];
+export interface ProjectIdentity {
+    name: string;
+    slug: string;
+}
+/** Validate the identity fields (name + slug) of a project (brief §7.7). */
+export declare function validateProjectIdentity(identity: ProjectIdentity): StudioIssue[];

package/dist/studio-core/validate.js

@@ -0,0 +1,119 @@
+import { isValidLocale, isValidSlug } from './ids';
+import { SECTION_IDS } from './sections';
+/**
+ * Semantic validation of project settings (brief §7.7, §8.7). Never throws —
+ * returns structured issues so the Settings surface can show dirty/invalid
+ * states while the user edits. Field *shapes* are checked by
+ * `projectSettingsSchema`; this layer checks cross-field and content rules.
+ */
+export function validateProjectSettings(settings) {
+    const issues = [];
+    // Locales -----------------------------------------------------------------
+    if (settings.locales.length === 0) {
+        issues.push({
+            code: 'empty-locales',
+            severity: 'error',
+            message: 'At least one locale is required.',
+            path: ['locales'],
+        });
+    }
+    const seenLocales = new Set();
+    settings.locales.forEach((locale, index) => {
+        if (!isValidLocale(locale)) {
+            issues.push({
+                code: 'invalid-locale',
+                severity: 'error',
+                message: `“${locale}” is not a valid locale tag.`,
+                path: ['locales', index],
+            });
+        }
+        if (seenLocales.has(locale)) {
+            issues.push({
+                code: 'duplicate-locale',
+                severity: 'error',
+                message: `Locale “${locale}” is listed more than once.`,
+                path: ['locales', index],
+            });
+        }
+        seenLocales.add(locale);
+    });
+    // Default locale ----------------------------------------------------------
+    if (!settings.locales.includes(settings.defaultLocale)) {
+        issues.push({
+            code: 'default-locale-not-in-locales',
+            severity: 'error',
+            message: `Default locale “${settings.defaultLocale}” must be one of the configured locales.`,
+            path: ['defaultLocale'],
+        });
+    }
+    // Environments ------------------------------------------------------------
+    if (settings.environments.length === 0) {
+        issues.push({
+            code: 'no-environments',
+            severity: 'error',
+            message: 'At least one environment is required.',
+            path: ['environments'],
+        });
+    }
+    const seenEnvKeys = new Set();
+    settings.environments.forEach((env, index) => {
+        if (!isValidSlug(env.key)) {
+            issues.push({
+                code: 'invalid-environment',
+                severity: 'error',
+                message: `Environment key “${env.key}” must be a valid slug.`,
+                path: ['environments', index, 'key'],
+            });
+        }
+        if (env.label.trim().length === 0) {
+            issues.push({
+                code: 'invalid-environment',
+                severity: 'error',
+                message: 'Environment label cannot be empty.',
+                path: ['environments', index, 'label'],
+            });
+        }
+        if (seenEnvKeys.has(env.key)) {
+            issues.push({
+                code: 'duplicate-environment',
+                severity: 'error',
+                message: `Environment key “${env.key}” is used more than once.`,
+                path: ['environments', index, 'key'],
+            });
+        }
+        seenEnvKeys.add(env.key);
+    });
+    // Section availability ----------------------------------------------------
+    const missing = SECTION_IDS.filter((id) => settings.sectionAvailability[id] === undefined);
+    if (missing.length > 0) {
+        issues.push({
+            code: 'incomplete-section-availability',
+            severity: 'warning',
+            message: `Section availability is unspecified for: ${missing.join(', ')}.`,
+            path: ['sectionAvailability'],
+        });
+    }
+    return issues;
+}
+/** Validate the identity fields (name + slug) of a project (brief §7.7). */
+export function validateProjectIdentity(identity) {
+    const issues = [];
+    if (identity.name.trim().length === 0) {
+        issues.push({
+            code: 'invalid-name',
+            severity: 'error',
+            message: 'Project name cannot be empty.',
+            path: ['name'],
+        });
+    }
+    if (!isValidSlug(identity.slug)) {
+        issues.push({
+            code: 'invalid-slug',
+            severity: 'error',
+            message: `“${identity.slug}” is not a valid slug (lowercase, hyphen-separated).`,
+            path: ['slug'],
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=validate.js.map

package/dist/studio-core/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/studio-core/validate.ts"],"names":[],"mappings":"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"}