@crowdedkingdoms/crowdyjs 9.0.0 → 11.0.0

package/dist/crowdy-studio/models.d.ts

@@ -0,0 +1,149 @@
+/** Compile targets supported by player-authored projects. */
+export type CrowdyStudioTarget = 'SERVER' | 'CLIENT';
+/** The target layout selected when a project is created. */
+export type CrowdyStudioProjectKind = 'SERVER' | 'CLIENT' | 'FULL_STACK';
+/**
+ * Whether a full-stack server should advertise its client companion.
+ * `OPTIONAL` records author intent without creating a runtime requirement;
+ * `REQUIRED` is applied with `playerCompute.setRequires` after both targets
+ * compile successfully.
+ */
+export type CrowdyStudioPairingPreference = 'NONE' | 'OPTIONAL' | 'REQUIRED';
+/** A source file in one project target. Paths are relative to that target. */
+export interface CrowdyStudioProjectFile {
+    target: CrowdyStudioTarget;
+    path: string;
+    content: string;
+}
+/** A read-only source file made available to the browser language worker. */
+export interface CrowdyStudioReferenceFile {
+    id: string;
+    source: 'PERSONAL_LIBRARY' | 'COMMON';
+    title: string;
+    /** Optional target fence. Omitted files are useful from either target. */
+    target?: CrowdyStudioTarget;
+    path: string;
+    content: string;
+    tags?: string[];
+    updatedAt?: string;
+}
+export interface CrowdyStudioProjectMetadata {
+    name: string;
+    description?: string;
+    serverModuleName?: string;
+    clientModuleName?: string;
+    pairingPreference: CrowdyStudioPairingPreference;
+}
+/** Immutable revision identity returned by the cloud project service. */
+export interface CrowdyStudioProjectRevision {
+    id: string;
+    savedAt: string;
+}
+/**
+ * One atomic cloud project snapshot. SERVER and CLIENT files intentionally
+ * share a project revision so a full-stack save cannot persist half a pair.
+ */
+export interface CrowdyStudioProject {
+    projectId: string;
+    appId: string;
+    gridId: string;
+    kind: CrowdyStudioProjectKind;
+    metadata: CrowdyStudioProjectMetadata;
+    files: CrowdyStudioProjectFile[];
+    sdkVersion: string;
+    abiVersion: number;
+    revision: CrowdyStudioProjectRevision;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CrowdyStudioProjectSummary {
+    projectId: string;
+    name: string;
+    kind: CrowdyStudioProjectKind;
+    revisionId: string;
+    serverModuleName?: string;
+    clientModuleName?: string;
+    updatedAt: string;
+}
+/** Explicit persistence state rendered by Crowdy Studio. */
+export type CrowdyStudioSaveState = 'SAVING' | 'SAVED' | 'CONFLICT' | 'OFFLINE';
+export interface CrowdyStudioFileRef {
+    source: 'PROJECT' | 'PERSONAL_LIBRARY' | 'COMMON';
+    target?: CrowdyStudioTarget;
+    path: string;
+    referenceId?: string;
+}
+export interface CreateCrowdyStudioProjectInput {
+    appId: string;
+    gridId: string;
+    kind: CrowdyStudioProjectKind;
+    metadata: CrowdyStudioProjectMetadata;
+    files: CrowdyStudioProjectFile[];
+}
+export interface SaveCrowdyStudioProjectInput {
+    appId: string;
+    gridId: string;
+    projectId: string;
+    /** Optimistic-concurrency precondition for the atomic project write. */
+    expectedRevisionId: string;
+    metadata: CrowdyStudioProjectMetadata;
+    files: CrowdyStudioProjectFile[];
+}
+export interface CrowdyStudioProjectScope {
+    appId: string;
+    gridId: string;
+}
+export interface ImportCrowdyStudioReferenceFileInput extends CrowdyStudioProjectScope {
+    projectId: string;
+    expectedRevisionId: string;
+    source: 'PERSONAL_LIBRARY' | 'COMMON';
+    referenceId: string;
+    destinationPath?: string;
+}
+export interface SaveCrowdyStudioLibraryFileInput extends CrowdyStudioProjectScope {
+    title: string;
+    target: CrowdyStudioTarget;
+    path: string;
+    content: string;
+    tags?: string[];
+}
+/**
+ * Storage contract consumed by Crowdy Studio. It deliberately has no generated
+ * GraphQL types, JSON source maps, or transport-specific errors.
+ */
+export interface CrowdyStudioProjectProvider {
+    listProjects(scope: CrowdyStudioProjectScope): Promise<CrowdyStudioProjectSummary[]>;
+    getProject(scope: CrowdyStudioProjectScope & {
+        projectId: string;
+    }): Promise<CrowdyStudioProject>;
+    createProject(input: CreateCrowdyStudioProjectInput): Promise<CrowdyStudioProject>;
+    saveProject(input: SaveCrowdyStudioProjectInput): Promise<CrowdyStudioProject>;
+    listPersonalLibraryFiles(scope: CrowdyStudioProjectScope): Promise<CrowdyStudioReferenceFile[]>;
+    listCommonFiles(scope: CrowdyStudioProjectScope): Promise<CrowdyStudioReferenceFile[]>;
+    importReferenceFile(input: ImportCrowdyStudioReferenceFileInput): Promise<CrowdyStudioProject>;
+    savePersonalLibraryFile(input: SaveCrowdyStudioLibraryFileInput): Promise<CrowdyStudioReferenceFile>;
+}
+/** Provider error indicating that the expected revision lost a save race. */
+export declare class CrowdyStudioRevisionConflictError extends Error {
+    readonly remoteProject?: CrowdyStudioProject | undefined;
+    readonly code = "PROJECT_REVISION_CONFLICT";
+    constructor(message?: string, remoteProject?: CrowdyStudioProject | undefined);
+}
+/** Provider error indicating that the write should be retried when online. */
+export declare class CrowdyStudioOfflineError extends Error {
+    readonly code = "PROJECT_OFFLINE";
+    readonly cause?: unknown;
+    constructor(message?: string, cause?: unknown);
+}
+/** Validate and normalize a target-relative project path. */
+export declare function normalizeCrowdyStudioPath(path: string): string;
+/** Stable key for maps, tabs, diagnostics, and tests. */
+export declare function crowdyStudioFileKey(target: CrowdyStudioTarget, path: string): string;
+/**
+ * Target-prefixed URI used by Monaco and the browser VFS. Both targets can
+ * therefore load `Cargo.toml` and `src/lib.rs` at the same time.
+ */
+export declare function crowdyStudioFileUri(workspaceUri: string, target: CrowdyStudioTarget, path: string): string;
+export declare function projectTargets(kind: CrowdyStudioProjectKind): CrowdyStudioTarget[];
+export declare function cloneCrowdyStudioProject(project: CrowdyStudioProject): CrowdyStudioProject;
+//# sourceMappingURL=models.d.ts.map

package/dist/crowdy-studio/models.d.ts.map

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

package/dist/crowdy-studio/models.js

@@ -0,0 +1,62 @@
+/** Provider error indicating that the expected revision lost a save race. */
+export class CrowdyStudioRevisionConflictError extends Error {
+    constructor(message = 'The project changed in another session', remoteProject) {
+        super(message);
+        this.remoteProject = remoteProject;
+        this.code = 'PROJECT_REVISION_CONFLICT';
+        this.name = 'CrowdyStudioRevisionConflictError';
+    }
+}
+/** Provider error indicating that the write should be retried when online. */
+export class CrowdyStudioOfflineError extends Error {
+    constructor(message = 'The project service is offline', cause) {
+        super(message);
+        this.code = 'PROJECT_OFFLINE';
+        this.name = 'CrowdyStudioOfflineError';
+        this.cause = cause;
+    }
+}
+/** Validate and normalize a target-relative project path. */
+export function normalizeCrowdyStudioPath(path) {
+    const normalized = path.trim().replace(/\\/gu, '/').replace(/^\.\/+/u, '');
+    if (normalized.length === 0 ||
+        normalized.length > 240 ||
+        normalized.startsWith('/') ||
+        normalized.endsWith('/') ||
+        normalized.split('/').some((part) => part === '' || part === '.' || part === '..') ||
+        /[\u0000-\u001f\u007f]/u.test(normalized)) {
+        throw new Error(`Invalid project file path: ${path}`);
+    }
+    return normalized;
+}
+/** Stable key for maps, tabs, diagnostics, and tests. */
+export function crowdyStudioFileKey(target, path) {
+    return `${target}:${normalizeCrowdyStudioPath(path)}`;
+}
+/**
+ * Target-prefixed URI used by Monaco and the browser VFS. Both targets can
+ * therefore load `Cargo.toml` and `src/lib.rs` at the same time.
+ */
+export function crowdyStudioFileUri(workspaceUri, target, path) {
+    const root = workspaceUri.replace(/\/+$/u, '');
+    const encodedPath = normalizeCrowdyStudioPath(path)
+        .split('/')
+        .map(encodeURIComponent)
+        .join('/');
+    return `${root}/${target.toLowerCase()}/${encodedPath}`;
+}
+export function projectTargets(kind) {
+    if (kind === 'SERVER')
+        return ['SERVER'];
+    if (kind === 'CLIENT')
+        return ['CLIENT'];
+    return ['SERVER', 'CLIENT'];
+}
+export function cloneCrowdyStudioProject(project) {
+    return {
+        ...project,
+        metadata: { ...project.metadata },
+        revision: { ...project.revision },
+        files: project.files.map((file) => ({ ...file })),
+    };
+}

package/dist/crowdy-studio/monaco-editor.d.ts

@@ -0,0 +1,16 @@
+import type { CrowdyStudioEditorAdapter, CrowdyStudioEditorCallbacks } from './editor.js';
+import { type PlatformIndex } from '../live-coding/platform-index.js';
+export interface MonacoCrowdyStudioEditorOptions {
+    editorWorkerFactory?: () => Worker;
+    languageWorkerFactory?: () => Worker;
+    platformIndex?: PlatformIndex | unknown;
+    languageRequestTimeoutMs?: number;
+}
+/**
+ * Create the Monaco adapter backed by the browser-local Rust LSP worker. Every
+ * loaded project/reference file is opened in the worker; project URIs include
+ * `/server/` or `/client/`, so duplicate Cargo and lib paths never collide.
+ */
+export declare function createMonacoCrowdyStudioEditor(host: HTMLElement, options: MonacoCrowdyStudioEditorOptions, callbacks: CrowdyStudioEditorCallbacks): Promise<CrowdyStudioEditorAdapter>;
+export declare function isCurrentDiagnosticVersion(version: unknown, currentVersion: number): boolean;
+//# sourceMappingURL=monaco-editor.d.ts.map

package/dist/crowdy-studio/monaco-editor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-editor.d.ts","sourceRoot":"","sources":["../../src/crowdy-studio/monaco-editor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,aAAa,CAAC;AAerB,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAW1C,MAAM,WAAW,+BAA+B;IAC9C,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAC;IACnC,qBAAqB,CAAC,EAAE,MAAM,MAAM,CAAC;IACrC,aAAa,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACxC,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAmBD;;;;GAIG;AACH,wBAAsB,8BAA8B,CAClD,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,+BAA+B,EACxC,SAAS,EAAE,2BAA2B,GACrC,OAAO,CAAC,yBAAyB,CAAC,CAoXpC;AA6GD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAKT"}