@elytracms/core 0.0.6

package/dist/studio-core/fixtures.js

@@ -0,0 +1,83 @@
+import { allSectionsAvailable } from './sections';
+import { InMemoryProjectRepository, createSequentialClock, createSequentialIdFactory, } from './repository';
+/**
+ * Deterministic sample projects (brief §10, §11). Ids and timestamps are
+ * hard-coded so every run, test, and browser inspection sees byte-identical
+ * state. They deliberately span varied locales and section availability so the
+ * Studio shell can demonstrate each.
+ */
+function availability(overrides) {
+    return { ...allSectionsAvailable(), ...overrides };
+}
+/** Fully-provisioned, multi-locale marketing site — the "happy path" project. */
+export const auroraMarketing = {
+    id: 'prj_aurora',
+    name: 'Aurora Marketing',
+    slug: 'aurora-marketing',
+    createdAt: '2026-01-04T09:00:00.000Z',
+    updatedAt: '2026-05-20T16:30:00.000Z',
+    settings: {
+        locales: ['en', 'de', 'fr'],
+        defaultLocale: 'en',
+        environments: [
+            { key: 'production', label: 'Production' },
+            { key: 'staging', label: 'Staging' },
+            { key: 'preview', label: 'Preview' },
+        ],
+        exportTarget: 'next-app-router',
+        sectionAvailability: allSectionsAvailable(),
+    },
+};
+/** Single-locale docs site where the assets surface is still planned. */
+export const northwindDocs = {
+    id: 'prj_northwind',
+    name: 'Northwind Docs',
+    slug: 'northwind-docs',
+    createdAt: '2026-02-11T11:15:00.000Z',
+    updatedAt: '2026-05-28T08:05:00.000Z',
+    settings: {
+        locales: ['en'],
+        defaultLocale: 'en',
+        environments: [
+            { key: 'production', label: 'Production' },
+            { key: 'preview', label: 'Preview' },
+        ],
+        exportTarget: 'next-app-router',
+        sectionAvailability: availability({ assets: 'planned' }),
+    },
+};
+/** Regional storefront with two locales and a components surface still planned. */
+export const lumenStore = {
+    id: 'prj_lumen',
+    name: 'Lumen Store',
+    slug: 'lumen-store',
+    createdAt: '2026-03-02T14:45:00.000Z',
+    updatedAt: '2026-06-01T10:00:00.000Z',
+    settings: {
+        locales: ['en-US', 'es-MX'],
+        defaultLocale: 'en-US',
+        environments: [
+            { key: 'production', label: 'Production' },
+            { key: 'preview', label: 'Preview' },
+        ],
+        exportTarget: 'next-app-router',
+        sectionAvailability: availability({ components: 'planned' }),
+    },
+};
+/** All sample projects in a stable order. */
+export const sampleProjects = [auroraMarketing, northwindDocs, lumenStore];
+/** Lookup by id for tests and shell bootstrapping. */
+export const sampleProjectsById = Object.fromEntries(sampleProjects.map((p) => [p.id, p]));
+/**
+ * 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 function createFixtureRepository() {
+    return new InMemoryProjectRepository({
+        seed: sampleProjects,
+        clock: createSequentialClock('2026-06-07T00:00:00.000Z'),
+        idFactory: createSequentialIdFactory('prj_new'),
+    });
+}
+//# sourceMappingURL=fixtures.js.map

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

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

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

@@ -0,0 +1,22 @@
+import { z } from 'zod';
+/** Stable, non-empty project identifier (opaque; not user-facing). */
+export declare const projectIdSchema: z.ZodString;
+export type ProjectId = z.infer<typeof projectIdSchema>;
+/**
+ * URL-safe project slug: lowercase alphanumeric segments joined by single hyphens.
+ * The slug is user-facing and editable; the id is the stable key.
+ */
+export declare const SLUG_PATTERN: RegExp;
+export declare const slugSchema: z.ZodString;
+export type Slug = z.infer<typeof slugSchema>;
+export declare function isValidSlug(value: string): boolean;
+/**
+ * Permissive BCP-47-ish locale tag: a primary subtag plus optional script/region
+ * subtags, e.g. `en`, `en-US`, `pt-BR`, `zh-Hans`, `zh-Hant-HK`.
+ */
+export declare const LOCALE_PATTERN: RegExp;
+export declare const localeSchema: z.ZodString;
+export type Locale = z.infer<typeof localeSchema>;
+export declare function isValidLocale(value: string): boolean;
+/** Derive a slug candidate from a free-form name. Never throws; may yield ''. */
+export declare function slugify(input: string): string;

package/dist/studio-core/ids.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/** Stable, non-empty project identifier (opaque; not user-facing). */
+export const projectIdSchema = z.string().min(1);
+/**
+ * URL-safe project slug: lowercase alphanumeric segments joined by single hyphens.
+ * The slug is user-facing and editable; the id is the stable key.
+ */
+export const SLUG_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+export const slugSchema = z.string().min(1).max(63).regex(SLUG_PATTERN);
+export function isValidSlug(value) {
+    return slugSchema.safeParse(value).success;
+}
+/**
+ * Permissive BCP-47-ish locale tag: a primary subtag plus optional script/region
+ * subtags, e.g. `en`, `en-US`, `pt-BR`, `zh-Hans`, `zh-Hant-HK`.
+ */
+export const LOCALE_PATTERN = /^[a-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$/;
+export const localeSchema = z.string().regex(LOCALE_PATTERN);
+export function isValidLocale(value) {
+    return localeSchema.safeParse(value).success;
+}
+/** Derive a slug candidate from a free-form name. Never throws; may yield ''. */
+export function slugify(input) {
+    return input
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 63)
+        .replace(/-+$/g, '');
+}
+//# sourceMappingURL=ids.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/studio-core/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,sEAAsE;AACtE,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAGhD;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,4BAA4B,CAAA;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;AAGvE,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,oCAAoC,CAAA;AAClE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;AAG5D,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAA;AAC9C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,OAAO,KAAK;SACT,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;AACxB,CAAC"}

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

@@ -0,0 +1,11 @@
+export declare const PACKAGE = "@elytracms/core/studio-core";
+export * from './ids';
+export * from './sections';
+export * from './metadata';
+export * from './issues';
+export * from './validate';
+export * from './workspace-config';
+export * from './errors';
+export * from './context';
+export * from './repository';
+export * from './fixtures';

package/dist/studio-core/index.js

@@ -0,0 +1,12 @@
+export const PACKAGE = '@elytracms/core/studio-core';
+export * from './ids';
+export * from './sections';
+export * from './metadata';
+export * from './issues';
+export * from './validate';
+export * from './workspace-config';
+export * from './errors';
+export * from './context';
+export * from './repository';
+export * from './fixtures';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/studio-core/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,6BAA6B,CAAA;AAEpD,cAAc,OAAO,CAAA;AACrB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,oBAAoB,CAAA;AAClC,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

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

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+/**
+ * Stable codes for project-settings validation issues (brief §4.11, §7.7).
+ * Settings validation is first-class and non-throwing: the editing UI holds a
+ * draft and renders these issues rather than crashing.
+ */
+export declare const studioIssueCodeSchema: z.ZodEnum<{
+    "invalid-name": "invalid-name";
+    "invalid-slug": "invalid-slug";
+    "empty-locales": "empty-locales";
+    "duplicate-locale": "duplicate-locale";
+    "invalid-locale": "invalid-locale";
+    "default-locale-not-in-locales": "default-locale-not-in-locales";
+    "no-environments": "no-environments";
+    "duplicate-environment": "duplicate-environment";
+    "invalid-environment": "invalid-environment";
+    "missing-export-target": "missing-export-target";
+    "incomplete-section-availability": "incomplete-section-availability";
+}>;
+export type StudioIssueCode = z.infer<typeof studioIssueCodeSchema>;
+export declare const studioIssueSeveritySchema: z.ZodEnum<{
+    error: "error";
+    warning: "warning";
+}>;
+export type StudioIssueSeverity = z.infer<typeof studioIssueSeveritySchema>;
+/** A structured project-settings issue carrying a field path. */
+export declare const studioIssueSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        "invalid-name": "invalid-name";
+        "invalid-slug": "invalid-slug";
+        "empty-locales": "empty-locales";
+        "duplicate-locale": "duplicate-locale";
+        "invalid-locale": "invalid-locale";
+        "default-locale-not-in-locales": "default-locale-not-in-locales";
+        "no-environments": "no-environments";
+        "duplicate-environment": "duplicate-environment";
+        "invalid-environment": "invalid-environment";
+        "missing-export-target": "missing-export-target";
+        "incomplete-section-availability": "incomplete-section-availability";
+    }>;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+    }>;
+    message: z.ZodString;
+    path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+}, z.core.$strip>;
+export type StudioIssue = z.infer<typeof studioIssueSchema>;
+/** True when no error-severity issues are present (warnings are tolerated). */
+export declare function isSettingsValid(issues: readonly StudioIssue[]): boolean;

package/dist/studio-core/issues.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+/**
+ * Stable codes for project-settings validation issues (brief §4.11, §7.7).
+ * Settings validation is first-class and non-throwing: the editing UI holds a
+ * draft and renders these issues rather than crashing.
+ */
+export const studioIssueCodeSchema = z.enum([
+    'invalid-name',
+    'invalid-slug',
+    'empty-locales',
+    'duplicate-locale',
+    'invalid-locale',
+    'default-locale-not-in-locales',
+    'no-environments',
+    'duplicate-environment',
+    'invalid-environment',
+    'missing-export-target',
+    'incomplete-section-availability',
+]);
+export const studioIssueSeveritySchema = z.enum(['error', 'warning']);
+/** A structured project-settings issue carrying a field path. */
+export const studioIssueSchema = z.object({
+    code: studioIssueCodeSchema,
+    severity: studioIssueSeveritySchema,
+    message: z.string(),
+    /** Field path into the settings object, e.g. ['defaultLocale'] or ['locales', 1]. */
+    path: z.array(z.union([z.string(), z.number()])),
+});
+/** True when no error-severity issues are present (warnings are tolerated). */
+export function isSettingsValid(issues) {
+    return !issues.some((issue) => issue.severity === 'error');
+}
+//# sourceMappingURL=issues.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"issues.js","sourceRoot":"","sources":["../../src/studio-core/issues.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC;IAC1C,cAAc;IACd,cAAc;IACd,eAAe;IACf,kBAAkB;IAClB,gBAAgB;IAChB,+BAA+B;IAC/B,iBAAiB;IACjB,uBAAuB;IACvB,qBAAqB;IACrB,uBAAuB;IACvB,iCAAiC;CAClC,CAAC,CAAA;AAGF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAA;AAGrE,iEAAiE;AACjE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,yBAAyB;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,qFAAqF;IACrF,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;CACjD,CAAC,CAAA;AAGF,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,MAA8B;IAC5D,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAA;AAC5D,CAAC"}

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

@@ -0,0 +1,109 @@
+import { z } from 'zod';
+/** A named deployment environment, e.g. production / preview (brief §7.7). */
+export declare const environmentSchema: z.ZodObject<{
+    key: z.ZodString;
+    label: z.ZodString;
+}, z.core.$strip>;
+export type Environment = z.infer<typeof environmentSchema>;
+/**
+ * Export target for generated code. Next.js App Router is the initial (and
+ * currently only) target (brief §6, §7.7).
+ */
+export declare const exportTargetSchema: z.ZodEnum<{
+    "next-app-router": "next-app-router";
+}>;
+export type ExportTarget = z.infer<typeof exportTargetSchema>;
+/**
+ * ISO-8601 timestamp string. Kept as a plain string (the repository owns the
+ * clock) so fixtures stay byte-for-byte deterministic across runs.
+ */
+export declare const timestampSchema: z.ZodString;
+export type Timestamp = z.infer<typeof timestampSchema>;
+/**
+ * Project settings — configuration that is separate from the canonical project
+ * graph (brief §7.7, §8.7). Field shapes are validated here; cross-field rules
+ * (e.g. default-locale ∈ locales) live in `validate.ts` so the editing UI can
+ * hold a temporarily-invalid draft and surface issues instead of throwing.
+ */
+export declare const projectSettingsSchema: z.ZodObject<{
+    locales: z.ZodArray<z.ZodString>;
+    defaultLocale: z.ZodString;
+    environments: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    exportTarget: z.ZodEnum<{
+        "next-app-router": "next-app-router";
+    }>;
+    sectionAvailability: z.ZodRecord<z.ZodEnum<{
+        components: "components";
+        assets: "assets";
+        cms: "cms";
+        extensions: "extensions";
+        settings: "settings";
+    }>, z.ZodEnum<{
+        available: "available";
+        planned: "planned";
+        unavailable: "unavailable";
+    }>>;
+}, z.core.$strip>;
+export type ProjectSettings = z.infer<typeof projectSettingsSchema>;
+/**
+ * Project metadata — identity, distinct from settings and from the project graph
+ * (brief §7.7). `createdAt`/`updatedAt` are optional: backend-stored projects
+ * carry them, but config-derived projects (identity owned by `elytra.config.ts`)
+ * have no backend timestamps.
+ */
+export declare const projectMetadataSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectMetadata = z.infer<typeof projectMetadataSchema>;
+/** A full project record: metadata plus settings. */
+export declare const projectSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodString>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+    settings: z.ZodObject<{
+        locales: z.ZodArray<z.ZodString>;
+        defaultLocale: z.ZodString;
+        environments: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            label: z.ZodString;
+        }, z.core.$strip>>;
+        exportTarget: z.ZodEnum<{
+            "next-app-router": "next-app-router";
+        }>;
+        sectionAvailability: z.ZodRecord<z.ZodEnum<{
+            components: "components";
+            assets: "assets";
+            cms: "cms";
+            extensions: "extensions";
+            settings: "settings";
+        }>, z.ZodEnum<{
+            available: "available";
+            planned: "planned";
+            unavailable: "unavailable";
+        }>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type Project = z.infer<typeof projectSchema>;
+/**
+ * Lightweight projection for list views and the switcher (brief §8.1). Avoids
+ * shipping full settings where only identity is needed.
+ */
+export declare const projectSummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    slug: z.ZodString;
+    updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ProjectSummary = z.infer<typeof projectSummarySchema>;
+export declare function toSummary(project: Project): ProjectSummary;
+/** Default environments for a freshly-created project. */
+export declare function defaultEnvironments(): Environment[];

package/dist/studio-core/metadata.js

@@ -0,0 +1,74 @@
+import { z } from 'zod';
+import { localeSchema, projectIdSchema, slugSchema } from './ids';
+import { sectionAvailabilityMapSchema } from './sections';
+/** A named deployment environment, e.g. production / preview (brief §7.7). */
+export const environmentSchema = z.object({
+    key: slugSchema,
+    label: z.string().min(1),
+});
+/**
+ * Export target for generated code. Next.js App Router is the initial (and
+ * currently only) target (brief §6, §7.7).
+ */
+export const exportTargetSchema = z.enum(['next-app-router']);
+/**
+ * ISO-8601 timestamp string. Kept as a plain string (the repository owns the
+ * clock) so fixtures stay byte-for-byte deterministic across runs.
+ */
+export const timestampSchema = z.string().min(1);
+/**
+ * Project settings — configuration that is separate from the canonical project
+ * graph (brief §7.7, §8.7). Field shapes are validated here; cross-field rules
+ * (e.g. default-locale ∈ locales) live in `validate.ts` so the editing UI can
+ * hold a temporarily-invalid draft and surface issues instead of throwing.
+ */
+export const projectSettingsSchema = z.object({
+    locales: z.array(localeSchema),
+    defaultLocale: localeSchema,
+    environments: z.array(environmentSchema),
+    exportTarget: exportTargetSchema,
+    sectionAvailability: sectionAvailabilityMapSchema,
+});
+/**
+ * Project metadata — identity, distinct from settings and from the project graph
+ * (brief §7.7). `createdAt`/`updatedAt` are optional: backend-stored projects
+ * carry them, but config-derived projects (identity owned by `elytra.config.ts`)
+ * have no backend timestamps.
+ */
+export const projectMetadataSchema = z.object({
+    id: projectIdSchema,
+    name: z.string().min(1).max(120),
+    slug: slugSchema,
+    createdAt: timestampSchema.optional(),
+    updatedAt: timestampSchema.optional(),
+});
+/** A full project record: metadata plus settings. */
+export const projectSchema = projectMetadataSchema.extend({
+    settings: projectSettingsSchema,
+});
+/**
+ * Lightweight projection for list views and the switcher (brief §8.1). Avoids
+ * shipping full settings where only identity is needed.
+ */
+export const projectSummarySchema = projectMetadataSchema.pick({
+    id: true,
+    name: true,
+    slug: true,
+    updatedAt: true,
+});
+export function toSummary(project) {
+    return {
+        id: project.id,
+        name: project.name,
+        slug: project.slug,
+        updatedAt: project.updatedAt,
+    };
+}
+/** Default environments for a freshly-created project. */
+export function defaultEnvironments() {
+    return [
+        { key: 'production', label: 'Production' },
+        { key: 'preview', label: 'Preview' },
+    ];
+}
+//# sourceMappingURL=metadata.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../src/studio-core/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AAEzD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACzB,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAA;AAG7D;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AAGhD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAC9B,aAAa,EAAE,YAAY;IAC3B,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC;IACxC,YAAY,EAAE,kBAAkB;IAChC,mBAAmB,EAAE,4BAA4B;CAClD,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,eAAe;IACnB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IAChC,IAAI,EAAE,UAAU;IAChB,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;IACrC,SAAS,EAAE,eAAe,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAA;AAGF,qDAAqD;AACrD,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACxD,QAAQ,EAAE,qBAAqB;CAChC,CAAC,CAAA;AAGF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,qBAAqB,CAAC,IAAI,CAAC;IAC7D,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,IAAI;IACV,SAAS,EAAE,IAAI;CAChB,CAAC,CAAA;AAGF,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,SAAS,EAAE,OAAO,CAAC,SAAS;KAC7B,CAAA;AACH,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE;QAC1C,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;KACrC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,73 @@
+import type { ProjectId } from './ids';
+import { BackendUnavailableError } from './errors';
+import type { Project, ProjectSettings, ProjectSummary } from './metadata';
+export interface CreateProjectInput {
+    name: string;
+    /** Derived from `name` when omitted. */
+    slug?: string;
+    settings?: Partial<ProjectSettings>;
+}
+export interface UpdateProjectInput {
+    name?: string;
+    slug?: string;
+    settings?: Partial<ProjectSettings>;
+}
+export interface DuplicateProjectInput {
+    name?: string;
+    slug?: string;
+}
+/**
+ * Provider-neutral project repository contract (brief §7.7). Operations are async
+ * so a Convex-backed implementation satisfies the same interface. Failures are
+ * thrown as the `ProjectRepositoryError` taxonomy. (Project *identity* is owned by
+ * `elytra.config.ts`; this repository persists the backend project record used
+ * by CLI provisioning and playground.)
+ */
+export interface ProjectRepository {
+    list(): Promise<ProjectSummary[]>;
+    get(id: ProjectId): Promise<Project>;
+    create(input: CreateProjectInput): Promise<Project>;
+    update(id: ProjectId, input: UpdateProjectInput): Promise<Project>;
+    duplicate(id: ProjectId, input?: DuplicateProjectInput): Promise<Project>;
+    delete(id: ProjectId): Promise<void>;
+}
+/** Returns an ISO-8601 timestamp; injected so tests stay deterministic. */
+export type Clock = () => string;
+/**
+ * Deterministic clock for fixtures/tests: starts at `startISO` and advances a
+ * fixed step on each call, so repeated runs produce identical timestamps.
+ */
+export declare function createSequentialClock(startISO?: string, stepMs?: number): Clock;
+/** Generates stable opaque project ids; injected for determinism. */
+export type IdFactory = () => ProjectId;
+export declare function createSequentialIdFactory(prefix?: string): IdFactory;
+export interface InMemoryProjectRepositoryOptions {
+    clock?: Clock;
+    idFactory?: IdFactory;
+    /** Seed projects (cloned defensively on insert). */
+    seed?: readonly Project[];
+}
+/**
+ * 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 declare class InMemoryProjectRepository implements ProjectRepository {
+    private readonly projects;
+    private readonly order;
+    private readonly clock;
+    private readonly nextId;
+    constructor(options?: InMemoryProjectRepositoryOptions);
+    list(): Promise<ProjectSummary[]>;
+    get(id: ProjectId): Promise<Project>;
+    create(input: CreateProjectInput): Promise<Project>;
+    update(id: ProjectId, input: UpdateProjectInput): Promise<Project>;
+    duplicate(id: ProjectId, input?: DuplicateProjectInput): Promise<Project>;
+    delete(id: ProjectId): Promise<void>;
+    private assertIdentity;
+    private assertSettings;
+    private assertSlugAvailable;
+    private deriveUniqueSlug;
+}
+/** Convenience guard used by callers that prefer a boolean to a thrown error. */
+export declare function isBackendUnavailable(error: unknown): error is BackendUnavailableError;