kakidash 0.0.11 → 0.1.0

package/README.ja.md

@@ -36,7 +36,7 @@ Kakidashのミッションは、**アウトプット速度の最大化**です
 ## Installation
 
 ```bash
-npm install kakidash
+pnpm add kakidash
 ```
 
 ## Usage
@@ -77,7 +77,7 @@ npm install kakidash
 #### A. NPM プロジェクト (Vite / Webpack など)
 
 ```bash
-npm install kakidash
+pnpm add kakidash
 ```
 
 ```typescript
@@ -344,36 +344,55 @@ const kakidash = new Kakidash(container, {
 | `-` | フォントサイズ縮小 |
 | `1` - `7` | ノードの色を変更 (パレット順) |
 
+## アーキテクチャ
+
+ソフトウェアアーキテクチャの詳細や内部モジュールの依存関係については、以下を参照してください：
+- [ソフトウェアアーキテクチャ設計書](./docs/SOFTWARE_ARCHITECTURE_ja.md)
+
 ## Development
 
 ### Setup
 
 ```bash
-npm install
+pnpm install
 ```
 
 ### Dev Server
 
 ```bash
-npm run dev
+pnpm dev
+```
+
+### Type Check
+
+```bash
+pnpm typecheck
+# or with turbo
+pnpm turbo typecheck
 ```
 
 ### Build
 
 ```bash
-npm run build
+pnpm build
+# or with turbo
+pnpm turbo build
 ```
 
 ### Test
 
 ```bash
-npm test
+pnpm test
+# or with turbo
+pnpm turbo test
 ```
 
 ### Lint
 
 ```bash
-npm run lint
+pnpm lint
+# or with turbo
+pnpm turbo lint
 ```
 
 ### Documentation
@@ -381,7 +400,15 @@ npm run lint
 TypeDocを使用してAPIドキュメントを生成します:
 
 ```bash
-npm run docs
+pnpm docs
 ```
 
 `docs/` ディレクトリにドキュメントが生成されます。
+
+### すべてのチェックを実行
+
+型チェック、ビルド、テスト、Lint、ドキュメント生成を並列実行します:
+
+```bash
+pnpm turbo:ci
+```

package/README.md

@@ -34,7 +34,7 @@ Master the shortcuts and expand your mind map at the speed of thought.
 ## Installation
 
 ```bash
-npm install kakidash
+pnpm add kakidash
 ```
 
 ## Usage
@@ -74,7 +74,7 @@ Prepare a container element (e.g., `div`) to display `kakidash`.
 #### A. NPM Project (Vite / Webpack etc.)
 
 ```bash
-npm install kakidash
+pnpm add kakidash
 ```
 
 ```typescript
@@ -338,36 +338,55 @@ Here is the complete default configuration. You can partially override these key
 | `-` | Decrease font size |
 | `1` - `7` | Change node color (Palette order) |
 
+## Architecture
+
+For details on the software architecture and internal module dependencies, please refer to:
+- [Software Architecture Design](./docs/SOFTWARE_ARCHITECTURE.md)
+
 ## Development
 
 ### Setup
 
 ```bash
-npm install
+pnpm install
 ```
 
 ### Dev Server
 
 ```bash
-npm run dev
+pnpm dev
+```
+
+### Type Check
+
+```bash
+pnpm typecheck
+# or with turbo
+pnpm turbo typecheck
 ```
 
 ### Build
 
 ```bash
-npm run build
+pnpm build
+# or with turbo
+pnpm turbo build
 ```
 
 ### Test
 
 ```bash
-npm test
+pnpm test
+# or with turbo
+pnpm turbo test
 ```
 
 ### Lint
 
 ```bash
-npm run lint
+pnpm lint
+# or with turbo
+pnpm turbo lint
 ```
 
 ### Documentation
@@ -375,7 +394,15 @@ npm run lint
 Generate API documentation using TypeDoc:
 
 ```bash
-npm run docs
+pnpm docs
 ```
 
 The documentation will be generated in `docs/` directory.
+
+### Run All Checks
+
+Run type checking, build, tests, linting, and documentation generation in parallel:
+
+```bash
+pnpm turbo:ci
+```

package/dist/index.d.ts

@@ -6,127 +6,27 @@ declare type Direction = 'Up' | 'Down' | 'Left' | 'Right';
  */
 export declare class Kakidash extends TypedEventEmitter<KakidashEventMap> {
     private mindMap;
-    private service;
-    private renderer;
-    private interactionHandler;
-    private styleEditor;
-    private layoutSwitcher;
-    private layoutMode;
-    private selectedNodeId;
-    /**
-     * Flag to track if we just created a node via UI interaction and are waiting for edit completion
-     * to emit the final model:change event.
-     */
-    private pendingNodeCreation;
-    private panX;
-    private panY;
-    private targetPanX;
-    private targetPanY;
-    private scale;
-    private isBatching;
-    private animationFrameId;
-    private maxWidth;
-    private savedCustomStyles;
-    /**
-     * Creates a new Kakidash instance.
-     *
-     * @param container - The HTML element to mount the mind map into. Must have defined width and height.
-     * @param options - Optional configuration options.
-     */
+    private controller;
     constructor(container: HTMLElement, options?: KakidashOptions);
-    /**
-     * Adds a new child node to the specified parent.
-     * This is a pure data operation and does not trigger UI actions like auto-focus or scroll.
-     *
-     * @param parentId - The ID of the parent node.
-     * @param topic - The content of the new node.
-     * @param layoutSide - For 'Both' layout mode, which side to place the node (root children only).
-     * @param options - Options for the operation.
-     * @returns The newly created Node object, or null if failed.
-     */
     addNode(parentId: string, topic?: string, layoutSide?: 'left' | 'right', options?: {
         emitChange?: boolean;
     }): Node_2 | null;
-    /**
-     * Adds a sibling node relative to the reference node.
-     * This is a pure data operation.
-     */
     addSibling(referenceId: string, position?: 'before' | 'after', topic?: string, options?: {
         emitChange?: boolean;
     }): Node_2 | null;
-    /**
-     * Inserts a parent node above the specified node.
-     * This is a pure data operation.
-     */
     insertParent(targetId: string, topic?: string, options?: {
         emitChange?: boolean;
     }): Node_2 | null;
-    /**
-     * Removes a node.
-     * This is a pure data operation.
-     * (Previously removeNode, keeping alias or usage consistent)
-     */
     deleteNode(nodeId: string): void;
-    /**
-     * Updates a node's topic or style.
-     * This is a pure data operation.
-     *
-     * @param nodeId - The ID of the node to update.
-     * @param updates - Object containing the fields to update.
-     *
-     * @example
-     * **Rename and style a node:**
-     * ```typescript
-     * kakidash.updateNode('node-1', {
-     *   topic: 'Important Idea',
-     *   style: { background: '#ffff00', color: 'black' }
-     * });
-     * ```
-     */
     updateNode(nodeId: string, updates: {
         topic?: string;
         style?: Partial<NodeStyle>;
     }): void;
-    /**
-     * Undo the last change.
-     */
     undo(): void;
-    /**
-     * Redo the last undone change.
-     */
     redo(): void;
-    /**
-     * Toggle fold state of a node.
-     */
     toggleFold(nodeId: string): void;
-    /**
-     * Get the ID of the currently selected node.
-     */
     getSelectedNodeId(): string | null;
-    /**
-     * Updates the style of a specific node.
-     * This applies styles directly to the node instance, overriding global themes.
-     *
-     * @param nodeId - The ID of the node to update.
-     * @param style - Partial style object. Properties set to `undefined` or empty strings might reset to default depending on implementation.
-     *
-     * @example
-     * **Highlight a node:**
-     * ```typescript
-     * kakidash.updateNodeStyle('node-id-123', {
-     *   color: 'red',
-     *   fontWeight: 'bold',
-     *   fontSize: '20px'
-     * });
-     * ```
-     */
     updateNodeStyle(nodeId: string, style: Partial<NodeStyle>): void;
-    /**
-     * Sets the theme of the mind map.
-     *
-     * @param theme - The theme name ('default' | 'simple' | 'colorful' | 'custom').
-     * If 'custom' is selected, previously saved custom styles (via updateGlobalStyles) are applied.
-     */
     setTheme(theme: Theme): void;
     getMindMap(): MindMap;
     getNode(nodeId: string): Node_2 | undefined;
@@ -134,65 +34,14 @@ export declare class Kakidash extends TypedEventEmitter<KakidashEventMap> {
     findNodes(predicate: (node: Node_2) => boolean): Node_2[];
     setMaxNodeWidth(width: number): void;
     getMaxNodeWidth(): number;
-    /**
-     * Updates global styles for the mind map using CSS variables.
-     * This allows batch updating of visual appearance without deep re-renders.
-     * Styles are persisted in `savedCustomStyles` and applied immediately if the current theme is 'custom'.
-     *
-     * @param styles - Object containing style definitions for various elements.
-     *
-     * @example
-     * **Apply a dark theme style:**
-     * ```typescript
-     * kakidash.updateGlobalStyles({
-     *   rootNode: {
-     *     border: '2px solid #555',
-     *     background: '#333',
-     *     color: '#fff'
-     *   },
-     *   childNode: {
-     *     border: '1px solid #444',
-     *     background: '#222',
-     *     color: '#eee'
-     *   },
-     *   connection: {
-     *     color: '#666'
-     *   },
-     *   canvas: {
-     *     background: '#1a1a1a'
-     *   }
-     * });
-     * ```
-     *
-     * @example
-     * **Reset specific local styles (by passing empty string):**
-     * ```typescript
-     * // Reverts root node border to default
-     * kakidash.updateGlobalStyles({
-     *   rootNode: { border: '' }
-     * });
-     * ```
-     */
     updateGlobalStyles(styles: MindMapStyles): void;
-    /**
-     * Helper to apply a set of styles to the DOM via CSS variables.
-     */
-    private applyCustomStylesToDOM;
     setReadOnly(readOnly: boolean): void;
     destroy(): void;
     batch(callback: () => void): void;
     addChildNode(parentId: string): void;
     addSiblingNode(nodeId: string, position?: 'before' | 'after'): void;
     insertParentNode(nodeId: string): void;
-    /**
-     * Wrapper for deleteNode that handles selection update (Interaction concern).
-     */
     removeNode(nodeId: string): void;
-    /**
-     * Helper to ensure sides are locked when modifying Root children in Both mode.
-     * (Kept as private helper for internal use)
-     */
-    private ensureExplicitLayoutSides;
     moveNode(nodeId: string, targetId: string, position: 'top' | 'bottom' | 'left' | 'right'): void;
     updateNodeTopic(nodeId: string, topic: string): void;
     selectNode(nodeId: string | null): void;
@@ -203,7 +52,6 @@ export declare class Kakidash extends TypedEventEmitter<KakidashEventMap> {
     pasteNode(parentId: string): void;
     pasteImage(parentId: string, imageData: string): void;
     cutNode(nodeId: string): void;
-    private render;
     updateLayout(mode: 'Standard' | 'Left' | 'Right'): void;
     setLayoutMode(mode: LayoutMode): void;
     getLayoutMode(): LayoutMode;
@@ -211,10 +59,6 @@ export declare class Kakidash extends TypedEventEmitter<KakidashEventMap> {
     getData(): MindMapData;
     loadData(data: MindMapData): void;
     getRootId(): string;
-    private getNodeDirection;
-    private startAnimationLoop;
-    private ensureNodeVisible;
-    private showShortcutModal;
 }
 
 export declare type KakidashEventMap = {
@@ -297,31 +141,24 @@ declare interface MindMapNodeData {
     layoutSide?: 'left' | 'right';
 }
 
-/**
- * Configuration for global mind map styles.
- * All properties accept standard CSS value strings (e.g., "blue", "1px solid red", "#ff0000").
- */
-export declare interface MindMapStyles {
-    /** Styles for the root node. */
+declare interface MindMapStyles {
     rootNode?: {
         border?: string;
         background?: string;
         color?: string;
     };
-    /** Styles for all child nodes (non-root). */
     childNode?: {
         border?: string;
         background?: string;
         color?: string;
     };
-    /** Styles for connection lines. */
     connection?: {
         color?: string;
     };
-    /** Styles for the canvas/background. */
     canvas?: {
         background?: string;
     };
+    [key: string]: any;
 }
 
 declare class Node_2 {
@@ -349,7 +186,7 @@ declare interface NodeStyle {
     fontStyle?: string;
 }
 
-declare type ShortcutAction = 'navUp' | 'navDown' | 'navLeft' | 'navRight' | 'addChild' | 'insertParent' | 'addSibling' | 'addSiblingBefore' | 'deleteNode' | 'beginEdit' | 'copy' | 'paste' | 'cut' | 'undo' | 'redo' | 'bold' | 'italic' | 'zoomIn' | 'zoomOut' | 'toggleFold' | 'centerMap' | 'selectColor1' | 'selectColor2' | 'selectColor3' | 'selectColor4' | 'selectColor5' | 'selectColor6' | 'selectColor7';
+declare type ShortcutAction = 'navUp' | 'navDown' | 'navLeft' | 'navRight' | 'addChild' | 'insertParent' | 'addSibling' | 'addSiblingBefore' | 'deleteNode' | 'beginEdit' | 'copy' | 'paste' | 'cut' | 'undo' | 'redo' | 'bold' | 'italic' | 'zoomIn' | 'zoomOut' | 'scaleUp' | 'scaleDown' | 'resetZoom' | 'toggleFold' | 'centerMap' | 'selectColor1' | 'selectColor2' | 'selectColor3' | 'selectColor4' | 'selectColor5' | 'selectColor6' | 'selectColor7';
 
 export declare type ShortcutConfig = Partial<Record<ShortcutAction, KeyBinding[]>>;