@calca/shared 0.0.0-stage → 0.7.5

package/README.md

@@ -1,3 +1,7 @@
-# Temporary Holding Version
+# @calca/shared
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Shared TypeScript types for the Calca stack — canvas (`Point`, `ToolMode`), comments, design documents (`DesignIteration`, `GenerationGroup`, `CanvasImage`), and generation-pipeline status (`PipelineStage`, `PipelineStatus`). Types only; consumed by `@calca/canvas-*`, `@calca/mcp-*`, and the Calca app.
+
+## License
+
+Apache-2.0

package/package.json

@@ -1,6 +1,35 @@
 {
   "name": "@calca/shared",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.7.5",
+  "private": false,
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "src"
+  ],
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "echo 'build: not yet implemented'",
+    "typecheck": "bunx tsc --noEmit",
+    "lint": "oxlint --fix .",
+    "format": "oxfmt --write .",
+    "test": "vitest run --passWithNoTests",
+    "clean": "rm -rf dist",
+    "validate": "bun ../../scripts/validate.ts --cwd $INIT_CWD"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/espetro/calca",
+    "directory": "packages/calca-shared"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./types/canvas";
+export * from "./types/comment";
+export * from "./types/design";
+export * from "./types/pipeline";

package/src/types/canvas.ts

@@ -0,0 +1,6 @@
+export interface Point {
+  x: number;
+  y: number;
+}
+
+export type ToolMode = "select" | "draw-area" | "edit-component" | "comment";

package/src/types/comment.ts

@@ -0,0 +1,22 @@
+import type { Point } from "./canvas";
+
+export type CommentStatus = "waiting" | "working" | "done";
+
+export interface CommentMessage {
+  id: string;
+  role: "user" | "calca";
+  text: string;
+  createdAt: number;
+}
+
+export interface Comment {
+  id: string;
+  position: Point; // Relative to the iteration
+  text: string;
+  number: number;
+  resolved?: boolean;
+  createdAt: number;
+  status?: CommentStatus;
+  aiResponse?: string;
+  thread?: CommentMessage[];
+}

package/src/types/design.ts

@@ -0,0 +1,39 @@
+import type { Point } from "./canvas";
+import type { Comment } from "./comment";
+
+export interface DesignIteration {
+  id: string;
+  html: string;
+  label: string;
+  position: Point;
+  width: number;
+  height: number;
+  prompt: string;
+  comments: Comment[];
+  isLoading?: boolean;
+  isRegenerating?: boolean;
+}
+
+export interface SummaryData {
+  title: string;
+  rationale: string;
+}
+
+export interface GenerationGroup {
+  id: string;
+  prompt: string;
+  iterations: DesignIteration[];
+  position: Point;
+  createdAt: number;
+  summary?: SummaryData;
+}
+
+export interface CanvasImage {
+  id: string;
+  dataUrl: string; // Base64 data URI
+  name: string;
+  width: number;
+  height: number;
+  position: Point;
+  thumbnail: string; // Smaller version for UI
+}

package/src/types/pipeline.ts

@@ -0,0 +1,32 @@
+/** Pipeline stages for multi-model generation */
+
+export type PipelineStage =
+  | "queued"
+  | "layout"
+  | "images"
+  | "compositing"
+  | "review"
+  | "refining"
+  | "done"
+  | "error";
+
+export interface PipelineStatus {
+  stage: PipelineStage;
+  progress: number; // 0-1
+  skipped?: boolean;
+  reason?: string;
+}
+
+export const STAGE_CONFIG: Record<
+  PipelineStage,
+  { label: string; progress: number; icon: string }
+> = {
+  compositing: { label: "Compositing…", progress: 0.65, icon: "🔧" },
+  done: { label: "Complete", progress: 1, icon: "✅" },
+  error: { label: "Error", progress: 0, icon: "❌" },
+  images: { label: "Adding images…", progress: 0.45, icon: "🎨" },
+  layout: { label: "Generating layout…", progress: 0.2, icon: "🏗️" },
+  queued: { label: "Queued", progress: 0, icon: "⏳" },
+  refining: { label: "Preparing next variation…", progress: 0.9, icon: "✨" },
+  review: { label: "Reviewing design…", progress: 0.8, icon: "👁️" },
+};