@elytracms/core 0.0.6

package/dist/starter-kits/manifests.d.ts

@@ -0,0 +1,7 @@
+import type { ComponentManifest } from '@elytracms/core/component-registry';
+/** Base primitives the kit graphs use (mirrors `@elytracms/core/runtime-renderer` shapes). */
+export declare const BASE_MANIFESTS: ComponentManifest[];
+/** Seeded project components (EC-116) — same ids/props the Studio registry implements. */
+export declare const PROJECT_MANIFESTS: ComponentManifest[];
+/** All manifests a kit may reference. */
+export declare const KIT_MANIFESTS: ComponentManifest[];

package/dist/starter-kits/manifests.js

@@ -0,0 +1,111 @@
+import { SPACING_TOKEN_NAMES, GRID_MIN_COLUMNS, GRID_MAX_COLUMNS } from '@elytracms/core/project-graph';
+import { defineComponent } from '@elytracms/core/component-registry';
+/**
+ * Component manifests a starter kit validates against (EC-116). Base primitives plus the seeded
+ * `project.*` components — declared to match the Studio registry's implementations (same ids and
+ * prop names), so a kit's graph both validates here and renders in the Builder. Kept React-free:
+ * these are manifests (shape), not implementations.
+ *
+ * EC-190 "props as fields": a prop is a `@elytracms/core/cms-core` field-def minus its `name` (the record
+ * key is the name). Every prop carries `context: 'prop'`; label/default live on `form`/`default`.
+ * These mirror the canonical `@elytracms/core/runtime-renderer` primitive manifests.
+ */
+// --- Field-def prop helpers -------------------------------------------------
+/** A plain-text prop. */
+const text = (label, defaultValue) => ({
+    type: 'text',
+    context: 'prop',
+    ...(defaultValue !== undefined ? { default: defaultValue } : {}),
+    form: { label },
+});
+/** A required (min length 1) text prop. */
+const textReq = (label, defaultValue) => ({
+    type: 'text',
+    context: 'prop',
+    ...(defaultValue !== undefined ? { default: defaultValue } : {}),
+    validation: { required: true, min: 1 },
+    form: { label },
+});
+/** A bounded numeric prop. */
+const number = (label, defaultValue, validation) => ({
+    type: 'number',
+    context: 'prop',
+    default: defaultValue,
+    ...(validation ? { validation } : {}),
+    form: { label },
+});
+/** A boolean prop. */
+const boolean = (label, defaultValue) => ({
+    type: 'boolean',
+    context: 'prop',
+    default: defaultValue,
+    form: { label },
+});
+/** A select prop over a fixed set of string options. */
+const select = (label, values, defaultValue) => ({
+    type: 'select',
+    context: 'prop',
+    default: defaultValue,
+    options: values.map((value) => ({ value, label: value })),
+    form: { label },
+});
+/** A gap prop: a `select` over the canonical design-token spacing step names (EC-161). */
+const gap = (defaultValue) => select('Gap', SPACING_TOKEN_NAMES, defaultValue);
+/** Base primitives the kit graphs use (mirrors `@elytracms/core/runtime-renderer` shapes). */
+export const BASE_MANIFESTS = [
+    defineComponent({ id: 'base.primitives.Container', namespace: 'base.primitives', title: 'Container', props: {}, slots: [{ name: 'children' }, { name: 'outlet' }] }),
+    defineComponent({ id: 'base.primitives.Stack', namespace: 'base.primitives', title: 'Stack', props: { gap: gap('4') }, slots: [{ name: 'children' }] }),
+    defineComponent({ id: 'base.primitives.Grid', namespace: 'base.primitives', title: 'Grid', props: { columns: number('Columns', 3, { min: GRID_MIN_COLUMNS, max: GRID_MAX_COLUMNS }), gap: gap('4') }, slots: [{ name: 'children' }] }),
+    defineComponent({ id: 'base.primitives.Heading', namespace: 'base.primitives', title: 'Heading', props: { text: text('Text', ''), level: number('Level', 2, { min: 1, max: 6 }) }, slots: [] }),
+    defineComponent({ id: 'base.primitives.Text', namespace: 'base.primitives', title: 'Text', props: { value: text('Text', '') }, slots: [] }),
+    defineComponent({ id: 'base.primitives.Button', namespace: 'base.primitives', title: 'Button', props: { label: text('Label', 'Button'), href: text('Href', '#') }, slots: [] }),
+    defineComponent({ id: 'base.primitives.Image', namespace: 'base.primitives', title: 'Image', props: { src: text('Source', ''), alt: text('Alt', '') }, slots: [] }),
+    // EC-190 DD7: a Repeater's `items` is a binding/iteration construct (an array) with no static
+    // field-def type; it rides node.props undeclared. No editable static prop — keep iterate + slots.
+    defineComponent({ id: 'base.primitives.Repeater', namespace: 'base.primitives', title: 'Repeater', props: {}, slots: [{ name: 'item', required: true }], iterate: { itemsProp: 'items', itemSlot: 'item' } }),
+];
+/** Seeded project components (EC-116) — same ids/props the Studio registry implements. */
+export const PROJECT_MANIFESTS = [
+    defineComponent({
+        id: 'project.MarketingHero',
+        namespace: 'project',
+        title: 'Marketing Hero',
+        category: 'marketing',
+        props: {
+            eyebrow: text('Eyebrow', 'New'),
+            heading: textReq('Heading', 'Build code-first websites'),
+            subheading: text('Subheading', 'One canonical graph.'),
+            ctaLabel: text('CTA label', 'Get started'),
+            align: select('Alignment', ['left', 'center'], 'left'),
+        },
+        slots: [],
+    }),
+    defineComponent({
+        id: 'project.FeatureCard',
+        namespace: 'project',
+        title: 'Feature Card',
+        category: 'content',
+        props: {
+            title: textReq('Title', 'Validation first'),
+            body: text('Body', 'Broken states are explicit.'),
+            tone: select('Tone', ['default', 'accent'], 'default'),
+        },
+        slots: [],
+    }),
+    defineComponent({
+        id: 'project.PricingCallout',
+        namespace: 'project',
+        title: 'Pricing Callout',
+        category: 'commerce',
+        props: {
+            plan: textReq('Plan', 'Pro'),
+            price: text('Price', '$29'),
+            period: text('Period', 'mo'),
+            featured: boolean('Featured', false),
+        },
+        slots: [],
+    }),
+];
+/** All manifests a kit may reference. */
+export const KIT_MANIFESTS = [...BASE_MANIFESTS, ...PROJECT_MANIFESTS];
+//# sourceMappingURL=manifests.js.map

package/dist/starter-kits/manifests.js.map

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

package/dist/starter-kits/upgrade.d.ts

@@ -0,0 +1,39 @@
+import type { StarterKit } from './kit';
+/**
+ * Template upgrade strategy (EC-120). Kits are semver-versioned. A project records the kit id +
+ * version it was instantiated from; when a newer kit version ships, an ordered list of
+ * {@link KitMigration}s describes how to move a project forward, one version at a time. Migrations
+ * are pure and inspectable — they transform a payload and report what changed — so an upgrade is
+ * reviewable and reversible, never a silent overwrite of the user's content.
+ */
+/** A reference to the kit + version a project was instantiated from. */
+export interface KitProvenance {
+    kitId: string;
+    version: string;
+}
+/** A single forward migration between two adjacent kit versions. */
+export interface KitMigration<T = unknown> {
+    from: string;
+    to: string;
+    description: string;
+    /** Pure transform of the project payload; also returns a human changelog of what it did. */
+    apply: (payload: T) => {
+        payload: T;
+        changes: string[];
+    };
+}
+export type CompareResult = 'behind' | 'current' | 'ahead' | 'unknown';
+/** Compare a project's kit version to the latest available kit version. */
+export declare function compareVersion(projectVersion: string, latestVersion: string): CompareResult;
+/** Whether a project instantiated from `provenance` can upgrade to `latest`. */
+export declare function canUpgrade(provenance: KitProvenance, latest: StarterKit): boolean;
+/**
+ * Build the ordered chain of migrations from `fromVersion` to `toVersion`. Migrations must form a
+ * contiguous from→to chain; a gap returns `undefined` so the host can surface "no upgrade path".
+ */
+export declare function migrationPath<T>(migrations: readonly KitMigration<T>[], fromVersion: string, toVersion: string): KitMigration<T>[] | undefined;
+/** Run a migration chain over a payload, accumulating the changelog. Pure. */
+export declare function runMigrations<T>(path: readonly KitMigration<T>[], payload: T): {
+    payload: T;
+    changes: string[];
+};

package/dist/starter-kits/upgrade.js

@@ -0,0 +1,54 @@
+function parse(version) {
+    const m = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
+    return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
+}
+/** Compare a project's kit version to the latest available kit version. */
+export function compareVersion(projectVersion, latestVersion) {
+    const a = parse(projectVersion);
+    const b = parse(latestVersion);
+    if (!a || !b)
+        return 'unknown';
+    for (let i = 0; i < 3; i++) {
+        if (a[i] < b[i])
+            return 'behind';
+        if (a[i] > b[i])
+            return 'ahead';
+    }
+    return 'current';
+}
+/** Whether a project instantiated from `provenance` can upgrade to `latest`. */
+export function canUpgrade(provenance, latest) {
+    return provenance.kitId === latest.id && compareVersion(provenance.version, latest.version) === 'behind';
+}
+/**
+ * Build the ordered chain of migrations from `fromVersion` to `toVersion`. Migrations must form a
+ * contiguous from→to chain; a gap returns `undefined` so the host can surface "no upgrade path".
+ */
+export function migrationPath(migrations, fromVersion, toVersion) {
+    const byFrom = new Map(migrations.map((m) => [m.from, m]));
+    const path = [];
+    let current = fromVersion;
+    const guard = migrations.length + 1;
+    for (let i = 0; i <= guard; i++) {
+        if (current === toVersion)
+            return path;
+        const next = byFrom.get(current);
+        if (!next)
+            return undefined;
+        path.push(next);
+        current = next.to;
+    }
+    return undefined;
+}
+/** Run a migration chain over a payload, accumulating the changelog. Pure. */
+export function runMigrations(path, payload) {
+    let current = payload;
+    const changes = [];
+    for (const migration of path) {
+        const result = migration.apply(current);
+        current = result.payload;
+        changes.push(`${migration.from} → ${migration.to}: ${result.changes.join('; ') || migration.description}`);
+    }
+    return { payload: current, changes };
+}
+//# sourceMappingURL=upgrade.js.map

package/dist/starter-kits/upgrade.js.map

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

package/dist/starter-kits/validate.d.ts

@@ -0,0 +1,16 @@
+import type { StarterKit } from './kit';
+/**
+ * Validate a starter kit before import (EC-119, EC-116, EC-118). Reuses the canonical validators:
+ * the envelope (meta), the component manifests (registry), the page graph (against those
+ * manifests), the CMS schemas (collection registry), and the seed documents (against the
+ * schemas). Returns structured issues; never throws. A kit with any `error` must not be imported.
+ */
+export interface KitIssue {
+    code: 'meta' | 'manifest' | 'graph' | 'schema' | 'content' | 'token';
+    severity: 'error' | 'warning';
+    message: string;
+    ref?: string;
+}
+export declare function validateKit(kit: StarterKit): KitIssue[];
+/** True when a kit has no error-severity issues and is safe to import. */
+export declare function isKitValid(issues: KitIssue[]): boolean;

package/dist/starter-kits/validate.js

@@ -0,0 +1,77 @@
+import { ComponentRegistry } from '@elytracms/core/component-registry';
+import { createCollectionRegistry, createDocumentStore, validateDocuments } from '@elytracms/core/cms-core';
+import { colorTokens } from '@elytracms/core/design-tokens';
+import { validateProjectGraph } from '@elytracms/core/project-graph';
+import { kitMetaSchema } from './kit';
+const TOKEN_NAMES = new Set(colorTokens.map((t) => t.name));
+export function validateKit(kit) {
+    const issues = [];
+    // 1. Envelope.
+    const meta = kitMetaSchema.safeParse(kit);
+    if (!meta.success) {
+        for (const issue of meta.error.issues) {
+            issues.push({ code: 'meta', severity: 'error', message: `${issue.path.join('.')}: ${issue.message}` });
+        }
+    }
+    // 2. Component manifests (duplicate / non-namespaced ids).
+    const registry = new ComponentRegistry(kit.manifests);
+    for (const issue of registry.issues) {
+        issues.push({ code: 'manifest', severity: 'error', message: issue.message, ...(issue.componentId ? { ref: issue.componentId } : {}) });
+    }
+    // 3. Page graph (missing components, invalid props, missing slots).
+    for (const issue of validateProjectGraph(kit.graph, { components: registry.lookup })) {
+        issues.push({ code: 'graph', severity: issue.severity, message: issue.message, ...(issue.nodeId ? { ref: issue.nodeId } : {}) });
+    }
+    // 4. CMS schemas.
+    const collections = createCollectionRegistry(kit.collections);
+    for (const issue of collections.issues) {
+        issues.push({ code: 'schema', severity: issue.severity === 'error' ? 'error' : 'warning', message: issue.message });
+    }
+    // 5. Seed content against the schemas (EC-118 "seed content fits the schemas"). A store over the
+    //    kit's own documents lets relation/asset references between seeds resolve.
+    const store = createDocumentStore(kit.documents);
+    for (const issue of validateDocuments(collections, kit.documents, { store, localeConfig: kit.localeConfig })) {
+        issues.push({
+            code: 'content',
+            severity: issue.severity === 'error' ? 'error' : 'warning',
+            message: issue.message,
+            ...(typeof issue.meta?.documentId === 'string' ? { ref: issue.meta.documentId } : {}),
+        });
+    }
+    // 6. Cross-document field uniqueness (the per-document validator can't see siblings). A field
+    //    declared `unique` must not repeat a (non-localized) value across the collection's seeds.
+    for (const collection of kit.collections) {
+        const uniqueFields = collection.fields.filter((f) => f.validation?.unique);
+        const docs = kit.documents.filter((d) => d.collection === collection.id);
+        for (const field of uniqueFields) {
+            const seen = new Map();
+            for (const doc of docs) {
+                const value = doc.values[field.name];
+                if (value === undefined || value === null)
+                    continue;
+                const key = JSON.stringify(value);
+                seen.set(key, (seen.get(key) ?? 0) + 1);
+            }
+            for (const [key, count] of seen) {
+                if (count > 1) {
+                    issues.push({ code: 'content', severity: 'error', message: `Field "${collection.id}.${field.name}" must be unique, but ${count} seed documents share the value ${key}.` });
+                }
+            }
+        }
+    }
+    // 7. Brand token overrides (EC-117) — keys must be real token names; flag typos + half-overrides.
+    for (const [name, override] of Object.entries(kit.tokenOverrides)) {
+        if (!TOKEN_NAMES.has(name)) {
+            issues.push({ code: 'token', severity: 'warning', message: `Token override "${name}" is not a known design token and has no effect.`, ref: name });
+        }
+        else if (!override.light || !override.dark) {
+            issues.push({ code: 'token', severity: 'warning', message: `Token override "${name}" sets only ${override.light ? 'light' : 'dark'}; the other mode keeps the canonical value.`, ref: name });
+        }
+    }
+    return issues;
+}
+/** True when a kit has no error-severity issues and is safe to import. */
+export function isKitValid(issues) {
+    return !issues.some((i) => i.severity === 'error');
+}
+//# sourceMappingURL=validate.js.map

package/dist/starter-kits/validate.js.map

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

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

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import type { ProjectId } from './ids';
+/** Maximum number of recent projects retained (most-recent-first). */
+export declare const MAX_RECENT_PROJECTS = 8;
+/**
+ * The active-project context the Studio shell preserves across section
+ * navigation (brief §4.3, §8.1). Pure data — reducers below derive new values
+ * without mutating.
+ */
+export declare const activeProjectContextSchema: z.ZodObject<{
+    activeProjectId: z.ZodNullable<z.ZodString>;
+    recentProjectIds: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ActiveProjectContext = z.infer<typeof activeProjectContextSchema>;
+export declare function emptyContext(): ActiveProjectContext;
+/**
+ * Mark a project active and move it to the front of the recents list (MRU),
+ * de-duplicating and capping length. Pure.
+ */
+export declare function activateProject(context: ActiveProjectContext, projectId: ProjectId): ActiveProjectContext;
+/**
+ * Forget a project entirely (e.g. after delete): drop it from recents and clear
+ * the active pointer if it was active. Pure.
+ */
+export declare function forgetProject(context: ActiveProjectContext, projectId: ProjectId): ActiveProjectContext;
+/** The active id if it still resolves against the known set, else null. */
+export declare function resolveActiveProjectId(context: ActiveProjectContext, knownIds: ReadonlySet<ProjectId>): ProjectId | null;

package/dist/studio-core/context.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { projectIdSchema } from './ids';
+/** Maximum number of recent projects retained (most-recent-first). */
+export const MAX_RECENT_PROJECTS = 8;
+/**
+ * The active-project context the Studio shell preserves across section
+ * navigation (brief §4.3, §8.1). Pure data — reducers below derive new values
+ * without mutating.
+ */
+export const activeProjectContextSchema = z.object({
+    activeProjectId: projectIdSchema.nullable(),
+    recentProjectIds: z.array(projectIdSchema),
+});
+export function emptyContext() {
+    return { activeProjectId: null, recentProjectIds: [] };
+}
+/**
+ * Mark a project active and move it to the front of the recents list (MRU),
+ * de-duplicating and capping length. Pure.
+ */
+export function activateProject(context, projectId) {
+    const recentProjectIds = [
+        projectId,
+        ...context.recentProjectIds.filter((id) => id !== projectId),
+    ].slice(0, MAX_RECENT_PROJECTS);
+    return { activeProjectId: projectId, recentProjectIds };
+}
+/**
+ * Forget a project entirely (e.g. after delete): drop it from recents and clear
+ * the active pointer if it was active. Pure.
+ */
+export function forgetProject(context, projectId) {
+    return {
+        activeProjectId: context.activeProjectId === projectId ? null : context.activeProjectId,
+        recentProjectIds: context.recentProjectIds.filter((id) => id !== projectId),
+    };
+}
+/** The active id if it still resolves against the known set, else null. */
+export function resolveActiveProjectId(context, knownIds) {
+    return context.activeProjectId && knownIds.has(context.activeProjectId)
+        ? context.activeProjectId
+        : null;
+}
+//# sourceMappingURL=context.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/studio-core/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAGvC,sEAAsE;AACtE,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAA;AAEpC;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,eAAe,EAAE,eAAe,CAAC,QAAQ,EAAE;IAC3C,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC;CAC3C,CAAC,CAAA;AAGF,MAAM,UAAU,YAAY;IAC1B,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,CAAA;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,OAA6B,EAC7B,SAAoB;IAEpB,MAAM,gBAAgB,GAAG;QACvB,SAAS;QACT,GAAG,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;KAC7D,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAA;IAC/B,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAA;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,OAA6B,EAC7B,SAAoB;IAEpB,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe;QACvF,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,SAAS,CAAC;KAC5E,CAAA;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,sBAAsB,CACpC,OAA6B,EAC7B,QAAgC;IAEhC,OAAO,OAAO,CAAC,eAAe,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC;QACrE,CAAC,CAAC,OAAO,CAAC,eAAe;QACzB,CAAC,CAAC,IAAI,CAAA;AACV,CAAC"}

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

@@ -0,0 +1,58 @@
+import { z } from 'zod';
+import type { StudioIssue } from './issues';
+/**
+ * Distinct, testable repository error categories (brief §7.7). Every failure
+ * mode is a distinct class with a stable `code`, so callers can branch on the
+ * category without string-matching messages. Provider-neutral: the Convex
+ * adapter (Phase 3) maps its failures onto these same types.
+ */
+export declare const repositoryErrorCodeSchema: z.ZodEnum<{
+    unknown: "unknown";
+    validation: "validation";
+    "not-found": "not-found";
+    conflict: "conflict";
+    "backend-unavailable": "backend-unavailable";
+}>;
+export type RepositoryErrorCode = z.infer<typeof repositoryErrorCodeSchema>;
+/** Base class for all project-repository errors. */
+export declare abstract class ProjectRepositoryError extends Error {
+    abstract readonly code: RepositoryErrorCode;
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Settings/identity validation failed; carries the structured issues. */
+export declare class ProjectValidationError extends ProjectRepositoryError {
+    readonly issues: readonly StudioIssue[];
+    readonly code: "validation";
+    constructor(message: string, issues: readonly StudioIssue[]);
+}
+/** No project exists for the given id. */
+export declare class ProjectNotFoundError extends ProjectRepositoryError {
+    readonly projectId: string;
+    readonly code: "not-found";
+    constructor(projectId: string);
+}
+/** A slug or identity collides with an existing project. */
+export declare class ProjectConflictError extends ProjectRepositoryError {
+    readonly conflictingSlug: string;
+    readonly code: "conflict";
+    constructor(message: string, conflictingSlug: string);
+}
+/** The backing store is unreachable or returned a transport-level failure. */
+export declare class BackendUnavailableError extends ProjectRepositoryError {
+    readonly code: "backend-unavailable";
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Any failure that does not map onto a more specific category. */
+export declare class UnknownRepositoryError extends ProjectRepositoryError {
+    readonly code: "unknown";
+    constructor(message?: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare function isProjectRepositoryError(value: unknown): value is ProjectRepositoryError;
+/** Map any thrown value onto the repository error taxonomy. */
+export declare function asRepositoryError(value: unknown): ProjectRepositoryError;

package/dist/studio-core/errors.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+/**
+ * Distinct, testable repository error categories (brief §7.7). Every failure
+ * mode is a distinct class with a stable `code`, so callers can branch on the
+ * category without string-matching messages. Provider-neutral: the Convex
+ * adapter (Phase 3) maps its failures onto these same types.
+ */
+export const repositoryErrorCodeSchema = z.enum([
+    'validation',
+    'not-found',
+    'conflict',
+    'backend-unavailable',
+    'unknown',
+]);
+/** Base class for all project-repository errors. */
+export class ProjectRepositoryError extends Error {
+    constructor(message, options) {
+        super(message, options);
+        this.name = new.target.name;
+    }
+}
+/** Settings/identity validation failed; carries the structured issues. */
+export class ProjectValidationError extends ProjectRepositoryError {
+    issues;
+    code = 'validation';
+    constructor(message, issues) {
+        super(message);
+        this.issues = issues;
+    }
+}
+/** No project exists for the given id. */
+export class ProjectNotFoundError extends ProjectRepositoryError {
+    projectId;
+    code = 'not-found';
+    constructor(projectId) {
+        super(`No project found with id “${projectId}”.`);
+        this.projectId = projectId;
+    }
+}
+/** A slug or identity collides with an existing project. */
+export class ProjectConflictError extends ProjectRepositoryError {
+    conflictingSlug;
+    code = 'conflict';
+    constructor(message, conflictingSlug) {
+        super(message);
+        this.conflictingSlug = conflictingSlug;
+    }
+}
+/** The backing store is unreachable or returned a transport-level failure. */
+export class BackendUnavailableError extends ProjectRepositoryError {
+    code = 'backend-unavailable';
+    constructor(message = 'The project backend is currently unavailable.', options) {
+        super(message, options);
+    }
+}
+/** Any failure that does not map onto a more specific category. */
+export class UnknownRepositoryError extends ProjectRepositoryError {
+    code = 'unknown';
+    constructor(message = 'An unknown repository error occurred.', options) {
+        super(message, options);
+    }
+}
+export function isProjectRepositoryError(value) {
+    return value instanceof ProjectRepositoryError;
+}
+/** Map any thrown value onto the repository error taxonomy. */
+export function asRepositoryError(value) {
+    if (isProjectRepositoryError(value))
+        return value;
+    if (value instanceof Error)
+        return new UnknownRepositoryError(value.message, { cause: value });
+    return new UnknownRepositoryError(String(value));
+}
+//# sourceMappingURL=errors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/studio-core/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9C,YAAY;IACZ,WAAW;IACX,UAAU;IACV,qBAAqB;IACrB,SAAS;CACV,CAAC,CAAA;AAGF,oDAAoD;AACpD,MAAM,OAAgB,sBAAuB,SAAQ,KAAK;IAExD,YAAY,OAAe,EAAE,OAA6B;QACxD,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QACvB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAA;IAC7B,CAAC;CACF;AAED,0EAA0E;AAC1E,MAAM,OAAO,sBAAuB,SAAQ,sBAAsB;IAIrD;IAHF,IAAI,GAAG,YAAqB,CAAA;IACrC,YACE,OAAe,EACN,MAA8B;QAEvC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFL,WAAM,GAAN,MAAM,CAAwB;IAGzC,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAEzC;IADZ,IAAI,GAAG,WAAoB,CAAA;IACpC,YAAqB,SAAiB;QACpC,KAAK,CAAC,6BAA6B,SAAS,IAAI,CAAC,CAAA;QAD9B,cAAS,GAAT,SAAS,CAAQ;IAEtC,CAAC;CACF;AAED,4DAA4D;AAC5D,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAInD;IAHF,IAAI,GAAG,UAAmB,CAAA;IACnC,YACE,OAAe,EACN,eAAuB;QAEhC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFL,oBAAe,GAAf,eAAe,CAAQ;IAGlC,CAAC;CACF;AAED,8EAA8E;AAC9E,MAAM,OAAO,uBAAwB,SAAQ,sBAAsB;IACxD,IAAI,GAAG,qBAA8B,CAAA;IAC9C,YAAY,OAAO,GAAG,+CAA+C,EAAE,OAA6B;QAClG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,OAAO,sBAAuB,SAAQ,sBAAsB;IACvD,IAAI,GAAG,SAAkB,CAAA;IAClC,YAAY,OAAO,GAAG,uCAAuC,EAAE,OAA6B;QAC1F,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IACzB,CAAC;CACF;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,KAAK,YAAY,sBAAsB,CAAA;AAChD,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,wBAAwB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACjD,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,IAAI,sBAAsB,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9F,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;AAClD,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { Project } from './metadata';
+import { InMemoryProjectRepository } from './repository';
+/** Fully-provisioned, multi-locale marketing site — the "happy path" project. */
+export declare const auroraMarketing: Project;
+/** Single-locale docs site where the assets surface is still planned. */
+export declare const northwindDocs: Project;
+/** Regional storefront with two locales and a components surface still planned. */
+export declare const lumenStore: Project;
+/** All sample projects in a stable order. */
+export declare const sampleProjects: readonly Project[];
+/** Lookup by id for tests and shell bootstrapping. */
+export declare const sampleProjectsById: Readonly<Record<string, Project>>;
+/**
+ * Build an in-memory repository seeded with the sample projects. The clock and
+ * id factory continue deterministically *after* the seeded ids/timestamps, so
+ * subsequent create/update operations are reproducible across runs.
+ */
+export declare function createFixtureRepository(): InMemoryProjectRepository;