@crowdedkingdoms/crowdyjs 8.22.0 → 10.0.0

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

@@ -0,0 +1,149 @@
+/** Compile targets supported by player-authored projects. */
+export type ModStudioTarget = 'SERVER' | 'CLIENT';
+/** The target layout selected when a project is created. */
+export type ModStudioProjectKind = '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 ModStudioPairingPreference = 'NONE' | 'OPTIONAL' | 'REQUIRED';
+/** A source file in one project target. Paths are relative to that target. */
+export interface ModStudioProjectFile {
+    target: ModStudioTarget;
+    path: string;
+    content: string;
+}
+/** A read-only source file made available to the browser language worker. */
+export interface ModStudioReferenceFile {
+    id: string;
+    source: 'PERSONAL_LIBRARY' | 'COMMON';
+    title: string;
+    /** Optional target fence. Omitted files are useful from either target. */
+    target?: ModStudioTarget;
+    path: string;
+    content: string;
+    tags?: string[];
+    updatedAt?: string;
+}
+export interface ModStudioProjectMetadata {
+    name: string;
+    description?: string;
+    serverModuleName?: string;
+    clientModuleName?: string;
+    pairingPreference: ModStudioPairingPreference;
+}
+/** Immutable revision identity returned by the cloud project service. */
+export interface ModStudioProjectRevision {
+    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 ModStudioProject {
+    projectId: string;
+    appId: string;
+    gridId: string;
+    kind: ModStudioProjectKind;
+    metadata: ModStudioProjectMetadata;
+    files: ModStudioProjectFile[];
+    sdkVersion: string;
+    abiVersion: number;
+    revision: ModStudioProjectRevision;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ModStudioProjectSummary {
+    projectId: string;
+    name: string;
+    kind: ModStudioProjectKind;
+    revisionId: string;
+    serverModuleName?: string;
+    clientModuleName?: string;
+    updatedAt: string;
+}
+/** Explicit persistence state rendered by Mod Studio. */
+export type ModStudioSaveState = 'SAVING' | 'SAVED' | 'CONFLICT' | 'OFFLINE';
+export interface ModStudioFileRef {
+    source: 'PROJECT' | 'PERSONAL_LIBRARY' | 'COMMON';
+    target?: ModStudioTarget;
+    path: string;
+    referenceId?: string;
+}
+export interface CreateModStudioProjectInput {
+    appId: string;
+    gridId: string;
+    kind: ModStudioProjectKind;
+    metadata: ModStudioProjectMetadata;
+    files: ModStudioProjectFile[];
+}
+export interface SaveModStudioProjectInput {
+    appId: string;
+    gridId: string;
+    projectId: string;
+    /** Optimistic-concurrency precondition for the atomic project write. */
+    expectedRevisionId: string;
+    metadata: ModStudioProjectMetadata;
+    files: ModStudioProjectFile[];
+}
+export interface ModStudioProjectScope {
+    appId: string;
+    gridId: string;
+}
+export interface ImportModStudioReferenceFileInput extends ModStudioProjectScope {
+    projectId: string;
+    expectedRevisionId: string;
+    source: 'PERSONAL_LIBRARY' | 'COMMON';
+    referenceId: string;
+    destinationPath?: string;
+}
+export interface SaveModStudioLibraryFileInput extends ModStudioProjectScope {
+    title: string;
+    target: ModStudioTarget;
+    path: string;
+    content: string;
+    tags?: string[];
+}
+/**
+ * Storage contract consumed by Mod Studio. It deliberately has no generated
+ * GraphQL types, JSON source maps, or transport-specific errors.
+ */
+export interface ModStudioProjectProvider {
+    listProjects(scope: ModStudioProjectScope): Promise<ModStudioProjectSummary[]>;
+    getProject(scope: ModStudioProjectScope & {
+        projectId: string;
+    }): Promise<ModStudioProject>;
+    createProject(input: CreateModStudioProjectInput): Promise<ModStudioProject>;
+    saveProject(input: SaveModStudioProjectInput): Promise<ModStudioProject>;
+    listPersonalLibraryFiles(scope: ModStudioProjectScope): Promise<ModStudioReferenceFile[]>;
+    listCommonFiles(scope: ModStudioProjectScope): Promise<ModStudioReferenceFile[]>;
+    importReferenceFile(input: ImportModStudioReferenceFileInput): Promise<ModStudioProject>;
+    savePersonalLibraryFile(input: SaveModStudioLibraryFileInput): Promise<ModStudioReferenceFile>;
+}
+/** Provider error indicating that the expected revision lost a save race. */
+export declare class ModStudioRevisionConflictError extends Error {
+    readonly remoteProject?: ModStudioProject | undefined;
+    readonly code = "PROJECT_REVISION_CONFLICT";
+    constructor(message?: string, remoteProject?: ModStudioProject | undefined);
+}
+/** Provider error indicating that the write should be retried when online. */
+export declare class ModStudioOfflineError 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 normalizeModStudioPath(path: string): string;
+/** Stable key for maps, tabs, diagnostics, and tests. */
+export declare function modStudioFileKey(target: ModStudioTarget, 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 modStudioFileUri(workspaceUri: string, target: ModStudioTarget, path: string): string;
+export declare function projectTargets(kind: ModStudioProjectKind): ModStudioTarget[];
+export declare function cloneModStudioProject(project: ModStudioProject): ModStudioProject;
+//# sourceMappingURL=models.d.ts.map

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

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

package/dist/mod-studio/models.js

@@ -0,0 +1,62 @@
+/** Provider error indicating that the expected revision lost a save race. */
+export class ModStudioRevisionConflictError extends Error {
+    constructor(message = 'The project changed in another session', remoteProject) {
+        super(message);
+        this.remoteProject = remoteProject;
+        this.code = 'PROJECT_REVISION_CONFLICT';
+        this.name = 'ModStudioRevisionConflictError';
+    }
+}
+/** Provider error indicating that the write should be retried when online. */
+export class ModStudioOfflineError extends Error {
+    constructor(message = 'The project service is offline', cause) {
+        super(message);
+        this.code = 'PROJECT_OFFLINE';
+        this.name = 'ModStudioOfflineError';
+        this.cause = cause;
+    }
+}
+/** Validate and normalize a target-relative project path. */
+export function normalizeModStudioPath(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 modStudioFileKey(target, path) {
+    return `${target}:${normalizeModStudioPath(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 modStudioFileUri(workspaceUri, target, path) {
+    const root = workspaceUri.replace(/\/+$/u, '');
+    const encodedPath = normalizeModStudioPath(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 cloneModStudioProject(project) {
+    return {
+        ...project,
+        metadata: { ...project.metadata },
+        revision: { ...project.revision },
+        files: project.files.map((file) => ({ ...file })),
+    };
+}

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

@@ -0,0 +1,16 @@
+import type { ModStudioEditorAdapter, ModStudioEditorCallbacks } from './editor.js';
+import { type PlatformIndex } from '../live-coding/platform-index.js';
+export interface MonacoModStudioEditorOptions {
+    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 createMonacoModStudioEditor(host: HTMLElement, options: MonacoModStudioEditorOptions, callbacks: ModStudioEditorCallbacks): Promise<ModStudioEditorAdapter>;
+export declare function isCurrentDiagnosticVersion(version: unknown, currentVersion: number): boolean;
+//# sourceMappingURL=monaco-editor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"monaco-editor.d.ts","sourceRoot":"","sources":["../../src/mod-studio/monaco-editor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAerB,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAW1C,MAAM,WAAW,4BAA4B;IAC3C,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,2BAA2B,CAC/C,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE,4BAA4B,EACrC,SAAS,EAAE,wBAAwB,GAClC,OAAO,CAAC,sBAAsB,CAAC,CAoXjC;AA6GD,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAKT"}