truecanvas 0.1.0 → 0.3.0

package/dist/core/index.d.ts

@@ -85,6 +85,11 @@ interface ImportInfo {
     source: string;
     typeOnly: boolean;
     names: string[];
+    /** named value imports, `{ Search as SearchIcon }` → { imported: "Search", local: "SearchIcon" } */
+    bindings: {
+        imported: string;
+        local: string;
+    }[];
     defaultName: string | null;
     start: number;
     end: number;
@@ -92,6 +97,8 @@ interface ImportInfo {
     lastSpecifierEnd: number | null;
 }
 interface CanvasDoc {
+    /** increases every time a doc is computed: lets clients drop a stale one that arrives late */
+    rev?: number;
     name: string;
     file: string;
     frames: CanvasFrame[];
@@ -188,7 +195,11 @@ declare class CanvasEditor {
     contentStart(n: CanvasNode): number;
     contentEnd(n: CanvasNode): number;
     childIndent(parent: CanvasNode): string;
-    /** Re-indents lines 2..n of a snippet so it sits at `indent`. */
+    /**
+     * Re-indents lines 2..n of a snippet so it sits at `indent`. Lines that start
+     * inside a multi-line string or template literal are content, not code: they
+     * are kept exactly as written.
+     */
     shift(code: string, indent: string): string;
     private openToClose;
     private insertAt;
@@ -205,6 +216,14 @@ declare class CanvasEditor {
     replace(node: CanvasNode, jsx: string): void;
     private added;
     ensureImport(name: string, from: string): void;
+    /**
+     * Imports `name` from `from` and returns the local name to write in JSX. When
+     * the name is already taken by something else (another import, a local
+     * component), it is imported under `alias` instead: `{ Search as SearchIcon }`.
+     */
+    importAs(name: string, from: string, alias: string): string;
+    private importedAs;
+    private addImportLine;
     /** Adds a whole import statement unless every name it binds is already imported. */
     addImportStatement(statement: string): void;
     private importsPrepended;
@@ -233,16 +252,23 @@ interface DarkMode {
     /** Value written for light mode with the attribute strategy. */
     lightValue?: string;
 }
+type Framework = "next" | "vite";
 interface TruecanvasConfig {
     root: string;
-    /** Where your Next.js dev server runs. */
+    /** The app's framework: Next.js (App Router) or Vite + React. Detected from package.json. */
+    framework: Framework;
+    /** Where your app's dev server runs. */
     appUrl: string;
     /** Port of the Truecanvas editor + MCP server. */
     port: number;
     /** Folder holding *.canvas.tsx files. */
     canvasDir: string;
-    /** Next.js app directory ("app" or "src/app"). */
+    /** Next.js app directory ("app" or "src/app"); for Vite, the source folder. */
     appDir: string;
+    /** Generated, dev-only render route (project-relative, gitignored). */
+    routeDir: string;
+    /** Vite: stylesheets every frame loads (default: the ones your entry module imports). */
+    css?: string[];
     /** Globs of component files shown in the Components panel. */
     components: string[];
     darkMode: DarkMode;
@@ -332,7 +358,7 @@ declare class Comments {
 
 interface GitFile {
     path: string;
-    status: "modified" | "added" | "deleted" | "renamed" | "untracked";
+    status: "modified" | "added" | "deleted" | "renamed" | "untracked" | "conflicted";
     staged: boolean;
 }
 interface GitStatus {
@@ -410,6 +436,12 @@ declare class Git {
     publish(name: string, isPrivate: boolean): Promise<string>;
     /** git reports paths from the repo root; we show them from the project root. */
     private rel;
+    /**
+     * The project folder inside the repo ("apps/web/", or "" at the root), as git
+     * itself sees it. Asking git instead of comparing file system paths holds up
+     * through symlinks (macOS /var → /private/var), junctions and Windows short names.
+     */
+    private prefix;
     branches(): Promise<{
         current: string | null;
         local: string[];
@@ -463,6 +495,14 @@ type Command = {
     component: string;
     props?: Record<string, Literal>;
     text?: string;
+} | {
+    op: "insert_icon";
+    canvas: string;
+    parent: string;
+    index?: number;
+    library: string;
+    name: string;
+    className?: string;
 } | {
     op: "replace";
     canvas: string;
@@ -665,7 +705,8 @@ declare class Workspace {
     private sources;
     private undoStacks;
     private redoStacks;
-    readonly feed: HistoryEntry[];
+    /** Activity across canvases: labels only, never file copies. */
+    readonly feed: PublicEntry[];
     private seq;
     private queue;
     private listeners;
@@ -684,8 +725,16 @@ declare class Workspace {
     relFile(canvas: string): string;
     read(canvas: string): string;
     doc(canvas: string): CanvasDoc;
-    /** A canvas doc with linked frames resolved to their page's layers. */
+    /**
+     * A canvas doc with linked frames resolved to their page's layers. Resolving
+     * reads and parses every linked page and layout, so the result is reused
+     * until the canvas source or one of those files changes (checked with stat).
+     */
     docFrom(canvas: string, source: string): CanvasDoc;
+    /** a doc computed later reflects the files at least as recently: its rev is higher */
+    private revision;
+    private docCache;
+    private stamp;
     /** Where a node's code lives: the canvas, or a linked page/layout file. */
     nodeSource(canvas: string, id: string): {
         node: CanvasNode;
@@ -735,11 +784,19 @@ declare class Workspace {
     private routeLinked;
     /** The page/layout file the command's layers live in, or null for the canvas. */
     private targetOf;
+    /** Applies a command to the file being edited and returns its history label. */
     private apply;
+    /** Edits to layers: props, text, classes, inserting, moving, wrapping. */
+    private applyLayerEdit;
+    /** Frames: creating, updating, backgrounds, presets, variant grids, main component frames. */
+    private applyFrameEdit;
+    /** Linked pages: adding a page, exploring a copy, applying it back. */
+    private applyPageEdit;
+    /** Scroll reveals and text animations. */
+    private applyMotionEdit;
+    /** New components, from scratch or from selected layers. */
+    private applyComponentEdit;
     private autoImport;
-    private motion;
-    /** work resolved (async) in exec before the synchronous apply */
-    private pending;
     private cleanCache;
     isPrettierClean(source: string, file: string): Promise<boolean>;
     /** Pretty-prints an agent's JSX snippet so it lands in the file readable. */
@@ -747,6 +804,12 @@ declare class Workspace {
     private prettier;
     format(source: string, file: string): Promise<string>;
     private record;
+    /**
+     * Undo entries hold whole files (before and after). Keep their total under a
+     * budget by dropping the oldest entries across canvases, so long sessions on
+     * big pages don't grow without limit.
+     */
+    private trimHistory;
     /** Changes still in effect (not undone) on a canvas since a time, oldest first. */
     changesSince(canvas: string, since: number): PublicEntry[];
     historyState(canvas: string): {
@@ -809,7 +872,7 @@ declare const DEVICES: Device[];
 declare function findDevice(id: string | null | undefined): Device | undefined;
 
 /**
- * Writes an older version of a canvas next to the generated route so Next can
+ * Writes an older version of a canvas next to the generated route so the app can
  * render it like any canvas ("__compare__<name>"). Relative imports are
  * rewritten for the new location; alias imports (@/…) work unchanged.
  */
@@ -817,4 +880,109 @@ declare function writeCompare(config: TruecanvasConfig, canvas: string, source:
 /** Per frame: same, changed, added (only now) or removed (only before). */
 declare function frameChanges(before: string, after: string): Record<string, "changed" | "added" | "removed" | "same">;
 
-export { type Actor, type AttrRange, type CanvasDoc, CanvasEditor, type CanvasFrame, type CanvasNode, Catalog, type Command, Comments, type ComponentSpec, DEVICES, type DarkMode, type Device, EditError, type FrameLink, Git, type HistoryEntry, type ImportInfo, type NodeKind, type Preset, type PropSpec, type PropValue, type TruecanvasConfig, Workspace, type WorkspaceEvent, allNodes, attrCode, componentJsx, describeComponent, findDevice, findFrame, findNode, frameChanges, injectIds, loadConfig, outlineDoc, parseCanvas, readDesignTokens, textCode, writeCompare };
+interface IconLibrary {
+    id: string;
+    label: string;
+    /** npm package to install */
+    package: string;
+    /** module the icons are imported from */
+    from: string;
+    homepage: string;
+    /** keeps one name per icon: drops aliases and non-icon exports */
+    pick: (name: string, all: Set<string>) => boolean;
+}
+declare const ICON_LIBRARIES: IconLibrary[];
+declare function iconLibrary(id: string): IconLibrary | undefined;
+interface Icon {
+    name: string;
+    svg: string;
+}
+/** Every icon of an installed library, from the disk cache or rendered once. */
+declare function loadIcons(root: string, id: string): Promise<Icon[]>;
+/**
+ * Ranks icons for a query: exact name, prefix, a near-typo of the whole name,
+ * substring; letters-in-order matches only fill in when there are few direct
+ * matches, tightest first.
+ */
+declare function searchIcons(icons: Icon[], query: string, limit?: number): {
+    total: number;
+    icons: Icon[];
+};
+/** Which icon libraries are installed, for the picker and agents. */
+declare function iconLibraries(root: string): {
+    id: string;
+    label: string;
+    package: string;
+    from: string;
+    homepage: string;
+    version: string | null;
+}[];
+
+interface ShadcnStatus {
+    /** components.json exists */
+    initialized: boolean;
+    /** where components land, relative to the project */
+    uiDir: string | null;
+    /** components already in the project */
+    installed: string[];
+}
+declare function shadcnStatus(root: string): ShadcnStatus;
+/** Component names from the official registry, cached for an hour. */
+declare function shadcnRegistry(): Promise<{
+    names: string[];
+    offline: boolean;
+}>;
+/** `shadcn init` with the defaults (writes components.json, lib/utils, theme CSS). */
+declare function shadcnInit(root: string): Promise<{
+    ok: boolean;
+    out: string;
+}>;
+/** `shadcn add <names>`; initializes the project first when needed. */
+declare function shadcnAdd(root: string, names: string[]): Promise<{
+    ok: boolean;
+    out: string;
+    added: string[];
+}>;
+
+interface InitReport {
+    done: string[];
+    todo: string[];
+}
+/** Does the app's next.config / vite.config already enable Truecanvas? */
+declare function configStatus(root: string, framework?: Framework): {
+    file: string | null;
+    wrapped: boolean;
+    framework: Framework;
+};
+/**
+ * Sets up a Next.js or Vite project: enables the plugin in its config, adds a
+ * `canvas` script and ignores the generated route. Every step is idempotent
+ * and reported.
+ */
+declare function initProject(config: TruecanvasConfig): InitReport;
+/**
+ * Wraps a next.config's export in withTruecanvas(), touching only the exported
+ * expression: comments and code after it stay as they are. Null when the
+ * export can't be found (the user is told to wrap it by hand).
+ */
+declare function wrapConfigExport(src: string): string | null;
+/**
+ * Adds `truecanvas()` to a vite.config's plugins array, touching nothing
+ * else. Null when there's no plugins array to add it to.
+ */
+declare function addVitePlugin(src: string): string | null;
+
+/**
+ * Generates the dev-only render route `/truecanvas/[canvas]` (Next: an App
+ * Router page; Vite: an entry module the plugin serves) and a registry that
+ * lazily imports each canvas. Idempotent.
+ */
+declare function syncRoute(config: TruecanvasConfig): boolean;
+/**
+ * Stylesheets a Vite app loads globally: the ones its entry module (the
+ * script in index.html) imports. Root-relative ("/src/index.css"), or the
+ * package path for a package's stylesheet.
+ */
+declare function viteStylesheets(root: string): string[];
+
+export { type Actor, type AttrRange, type CanvasDoc, CanvasEditor, type CanvasFrame, type CanvasNode, Catalog, type Command, Comments, type ComponentSpec, DEVICES, type DarkMode, type Device, EditError, type FrameLink, Git, type HistoryEntry, ICON_LIBRARIES, type Icon, type IconLibrary, type ImportInfo, type NodeKind, type Preset, type PropSpec, type PropValue, type ShadcnStatus, type TruecanvasConfig, Workspace, type WorkspaceEvent, addVitePlugin, allNodes, attrCode, componentJsx, configStatus, describeComponent, findDevice, findFrame, findNode, frameChanges, iconLibraries, iconLibrary, initProject, injectIds, loadConfig, loadIcons, outlineDoc, parseCanvas, readDesignTokens, searchIcons, shadcnAdd, shadcnInit, shadcnRegistry, shadcnStatus, syncRoute, textCode, viteStylesheets, wrapConfigExport, writeCompare };

package/dist/core/index.js

@@ -5,46 +5,46 @@ import {
   EditError,
   Git,
   Workspace,
+  addVitePlugin,
   allNodes,
   attrCode,
   componentJsx,
+  configStatus,
   describeComponent,
   findDevice,
   findFrame,
   findNode,
   frameChanges,
-  idOf,
-  loadConfig,
+  initProject,
   outlineDoc,
   parseCanvas,
-  parseModule,
   readDesignTokens,
+  shadcnAdd,
+  shadcnInit,
+  shadcnRegistry,
+  shadcnStatus,
+  syncRoute,
   textCode,
-  walk,
+  viteStylesheets,
+  wrapConfigExport,
   writeCompare
-} from "../chunk-WB35FXGP.js";
+} from "../chunk-XWQ5MS24.js";
+import {
+  injectIds
+} from "../chunk-TSHD2S36.js";
+import {
+  loadConfig
+} from "../chunk-PBKX3SBC.js";
 import {
   Catalog
-} from "../chunk-753N4QRO.js";
-
-// src/core/inject.ts
-import MagicString from "magic-string";
-function injectIds(source, file) {
-  let ast;
-  try {
-    ast = parseModule(source);
-  } catch {
-    return source;
-  }
-  const s = new MagicString(source);
-  walk(ast, (node) => {
-    if (node.type !== "JSXOpeningElement") return;
-    if (node.attributes.some((a) => a.type === "JSXAttribute" && a.name.name === "data-tc")) return;
-    const id = file ? `${file}#${idOf(node)}` : idOf(node);
-    s.appendLeft((node.typeParameters ?? node.name).end, ` data-tc="${id}"`);
-  });
-  return s.toString();
-}
+} from "../chunk-WU7NBTJH.js";
+import {
+  ICON_LIBRARIES,
+  iconLibraries,
+  iconLibrary,
+  loadIcons,
+  searchIcons
+} from "../chunk-C4SATRZT.js";
 export {
   CanvasEditor,
   Catalog,
@@ -52,20 +52,35 @@ export {
   DEVICES,
   EditError,
   Git,
+  ICON_LIBRARIES,
   Workspace,
+  addVitePlugin,
   allNodes,
   attrCode,
   componentJsx,
+  configStatus,
   describeComponent,
   findDevice,
   findFrame,
   findNode,
   frameChanges,
+  iconLibraries,
+  iconLibrary,
+  initProject,
   injectIds,
   loadConfig,
+  loadIcons,
   outlineDoc,
   parseCanvas,
   readDesignTokens,
+  searchIcons,
+  shadcnAdd,
+  shadcnInit,
+  shadcnRegistry,
+  shadcnStatus,
+  syncRoute,
   textCode,
+  viteStylesheets,
+  wrapConfigExport,
   writeCompare
 };