truecanvas 0.1.0 → 0.2.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;
@@ -332,7 +351,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 +429,11 @@ 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 as git sees it: git reports real paths, so a folder
+     * reached through a symlink (macOS /var → /private/var) must be resolved too.
+     */
+    private realCwd;
     branches(): Promise<{
         current: string | null;
         local: string[];
@@ -463,6 +487,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 +697,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 +717,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 +776,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 +796,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): {
@@ -817,4 +872,84 @@ 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[];
+}
+/**
+ * Sets up a Next.js project: wraps next.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;
+
+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, allNodes, attrCode, componentJsx, describeComponent, findDevice, findFrame, findNode, frameChanges, iconLibraries, iconLibrary, initProject, injectIds, loadConfig, loadIcons, outlineDoc, parseCanvas, readDesignTokens, searchIcons, shadcnAdd, shadcnInit, shadcnRegistry, shadcnStatus, textCode, wrapConfigExport, writeCompare };

package/dist/core/index.js

@@ -14,18 +14,31 @@ import {
   findNode,
   frameChanges,
   idOf,
+  initProject,
   loadConfig,
   outlineDoc,
   parseCanvas,
   parseModule,
   readDesignTokens,
+  shadcnAdd,
+  shadcnInit,
+  shadcnRegistry,
+  shadcnStatus,
   textCode,
   walk,
+  wrapConfigExport,
   writeCompare
-} from "../chunk-WB35FXGP.js";
+} from "../chunk-ZPARY6OD.js";
 import {
   Catalog
-} from "../chunk-753N4QRO.js";
+} from "../chunk-T2TCBSTG.js";
+import {
+  ICON_LIBRARIES,
+  iconLibraries,
+  iconLibrary,
+  loadIcons,
+  searchIcons
+} from "../chunk-C4SATRZT.js";
 
 // src/core/inject.ts
 import MagicString from "magic-string";
@@ -52,6 +65,7 @@ export {
   DEVICES,
   EditError,
   Git,
+  ICON_LIBRARIES,
   Workspace,
   allNodes,
   attrCode,
@@ -61,11 +75,21 @@ export {
   findFrame,
   findNode,
   frameChanges,
+  iconLibraries,
+  iconLibrary,
+  initProject,
   injectIds,
   loadConfig,
+  loadIcons,
   outlineDoc,
   parseCanvas,
   readDesignTokens,
+  searchIcons,
+  shadcnAdd,
+  shadcnInit,
+  shadcnRegistry,
+  shadcnStatus,
   textCode,
+  wrapConfigExport,
   writeCompare
 };