{"_id":"@atomic-state-canvas/asc-viewer-cli","_rev":"8-5a8f68d0ee01157f6029e503aaef9c50","name":"@atomic-state-canvas/asc-viewer-cli","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.0.0","_id":"@atomic-state-canvas/asc-viewer-cli@1.0.0","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"dist/apps/asc-viewer-cli/src/index.js"},"dist":{"shasum":"7e028b3bb23fb31d78892dc1731903fa041a01cb","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.0.0.tgz","fileCount":51,"integrity":"sha512-oNKqNhyUmQvR9iUiMfYgLK0MIxAURvoPLFS1eb8LQowCV/gqPAA7n4sg+ZTPoS+QRP+4QwWLAEYLqa+h2ebvLw==","signatures":[{"sig":"MEUCIQCDlJa67a6HG4rz7mdCQr2wyq//+LUXcLUr9TtqHrHcvQIgI+qnnlY97tFSkqrvBW3Q6/0EXrmD7ekYQ0IvGXXpMU4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62133},"main":"./index.js","type":"commonjs","gitHead":"ab0ec10dbaa16f4268c589550842b11e50a999d1","_npmUser":{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"10.9.2","directories":{},"_nodeVersion":"22.14.0","dependencies":{"acorn":"8.14.1","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.62.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.0.0_1745635822276_0.3505627665543032","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.0.1","_id":"@atomic-state-canvas/asc-viewer-cli@1.0.1","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"index.js"},"dist":{"shasum":"d0c76adebc512cec09df9ceaaf9ca611b13f1880","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.0.1.tgz","fileCount":51,"integrity":"sha512-MpIG5feqayNxr9ICcxtjkgc3Kz0afdQ1qbap1jkFHYhnbqb8aEdF1amAxbtK9nXBfjRs5pltmJoit4ANThH/Gg==","signatures":[{"sig":"MEUCIQDa0gSQAwNwgBgZoN7fnl4dczjpBK7UjjNYAxfRr9kZyAIgfoGCGQQTt2fEXQ0rxiEWu9H7eoeYu4w4aH6mH7qy+IM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":62104},"main":"./index.js","type":"commonjs","gitHead":"62306f973be0bddfd6c87621a1524b10bf9bbc6b","_npmUser":{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"10.9.2","directories":{},"_nodeVersion":"22.14.0","dependencies":{"acorn":"8.14.1","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.62.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.0.1_1745636475794_0.8047929237296532","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.0.2","_id":"@atomic-state-canvas/asc-viewer-cli@1.0.2","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"index.js"},"dist":{"shasum":"a1b7dfdd8fec9003b98f4909d0645d3977b1340d","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.0.2.tgz","fileCount":55,"integrity":"sha512-T1xfp0Q5vMHffw25tc95wi7xLs9EW3VON+6CKsykMPPxhIfsm1rdjT+eop7AgaMeujJA6MMxxrXNe3ahQJKMOg==","signatures":[{"sig":"MEYCIQCoelCYyDFSaEpj1N65X903kQgj2qYpq/zWNrcurGmcCwIhAJYOCL13yZBTa22dDlAlcmjQvUpRtmkL6tDnLSg5o4Uv","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1635435},"main":"./index.js","type":"commonjs","gitHead":"a791979bebab08ca70c5190f4d1f224a78d45213","_npmUser":{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"10.9.2","directories":{},"_nodeVersion":"22.14.0","dependencies":{"acorn":"8.14.1","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.62.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.0.2_1745689569199_0.17731516002261238","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.0.3","keywords":["cli","flowchart","atomic state","visualization","atomic state visualization","recoil graph"],"license":"MIT","_id":"@atomic-state-canvas/asc-viewer-cli@1.0.3","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"index.js"},"dist":{"shasum":"60d847e5283403073bacf12f38e8fa5cc2d018cc","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.0.3.tgz","fileCount":55,"integrity":"sha512-/EhcfOi4NIFzKNB6QBtuKBY5nPUydBvqp92RQBvdquQiO98deudabI0PPnTsehMJ4iM2keOCZxMsP9uQ8t6o/g==","signatures":[{"sig":"MEQCIBKYqDA31EkCA8Xfc8MC9Tf4TJDlqKz7IQwNF0HhqkQcAiBIC7EArcR+4vvxd5vSf+/fDpjAl0eSUPq98fLdl8+a0w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1635846},"main":"./index.js","type":"commonjs","gitHead":"07c07e5478b5c6e474b7aa28ceba073a58a37f70","_npmUser":{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"10.9.2","description":"An interactive web application for analyzing and visualizing atomic state relationships.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"acorn":"8.14.1","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.62.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.0.3_1745691035365_0.9278937232460325","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.1.0","keywords":["cli","flowchart","atomic state","visualization","atomic state visualization","recoil graph"],"license":"MIT","_id":"@atomic-state-canvas/asc-viewer-cli@1.1.0","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"index.js"},"dist":{"shasum":"ca5eff3b6afca5f1bf868a380f3ca317dffc5ff6","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.1.0.tgz","fileCount":55,"integrity":"sha512-VN1FEk57El9gJBFlgZqD9RMRmhsCNSdBbFlKN/jgrh4Dvc0StzNCmaKDMaqws1J2bsuMMASWhqrYDzJ93sNa5A==","signatures":[{"sig":"MEUCIQC4fqGC7i/u7D3Gg5GFszcJPxNTTDf4946SmF0IfqJdTwIgDBnclIiGdYu3PoOhA3fWv7bYNcNqQJ3LcQzwvUEJxvI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1743468},"main":"./index.js","type":"commonjs","gitHead":"5bdac6d74ae9e083e0aeb0c3ed102bee2161fa18","_npmUser":{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"10.9.2","description":"An interactive web application for analyzing and visualizing atomic state relationships.","directories":{},"_nodeVersion":"22.14.0","dependencies":{"acorn":"8.14.1","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.62.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.1.0_1745746394107_0.7361932363289474","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.2.0","keywords":["cli","flowchart","atomic state","visualization","atomic state visualization","recoil graph"],"license":"MIT","_id":"@atomic-state-canvas/asc-viewer-cli@1.2.0","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"index.js"},"dist":{"shasum":"a2db1fbb365b0fcf7d7738ed92304ea9b3c58fa6","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.2.0.tgz","fileCount":55,"integrity":"sha512-QvCSz0r6VgCkkm18xyWVQ1sBO3n/i5gTH17kT4vTrIqR41o3cXYnstFDqpc9PnI4wlx7OuVdmfXogoOxQ7vSSw==","signatures":[{"sig":"MEQCIFld12G1Vc3ocOyOMgwaAwhaqKZLvZuL1FQGsRjQlxB/AiAd6CluoiS11+MUXtNSTdPfncDfOtyGsZp4G8o3EvIDTA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1744393},"main":"./index.js","type":"commonjs","gitHead":"88dd0af1848e2407d4178950c65a1a3aaa32482e","_npmUser":{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"10.9.2","description":"An interactive web application for analyzing and visualizing atomic state relationships.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"acorn":"8.15.0","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.86.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.2.0_1757561858214_0.7994069180475281","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.2.1","keywords":["cli","flowchart","atomic state","visualization","atomic state visualization","recoil graph"],"license":"MIT","_id":"@atomic-state-canvas/asc-viewer-cli@1.2.1","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"bin":{"asc-viewer":"index.js"},"dist":{"shasum":"8a2b96a8fc6911e1485909a3cc4de581d74d4e70","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.2.1.tgz","fileCount":56,"integrity":"sha512-fhgQYsQ0f0dkNHue6E3E3bhLzAq0KCpbWOM+ltDgz9vNf1TmLb046870n4a8+4vRrXCRbkrg32quo0B81N/0Uw==","signatures":[{"sig":"MEQCIDn3LfoYA1xMnmk98hF2ufO73YX8JiiNW2YykDTSTPfzAiB0Kk0reK3LTKF2iXP8B0N+JdqWWSSLOS0ILtRa7k7zyA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atomic-state-canvas%2fasc-viewer-cli@1.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1754025},"main":"./index.js","type":"commonjs","gitHead":"1c913c1db940c5c00c411dc65c41db61543ac82f","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7adc0223-cead-4d88-a09f-13eff747995e"}},"repository":{"url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","type":"git","directory":"apps/asc-viewer-cli"},"_npmVersion":"11.7.0","description":"An interactive web application for analyzing and visualizing atomic state relationships.","directories":{},"_nodeVersion":"24.11.1","dependencies":{"acorn":"8.15.0","chokidar":"4.0.3","d3-force":"3.0.0","acorn-walk":"8.3.4","oxc-parser":"0.86.0","cosmiconfig":"8.3.6"},"publishConfig":{"access":"public","provenance":true},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/asc-viewer-cli_1.2.1_1765524444670_0.2826578863547775","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@atomic-state-canvas/asc-viewer-cli","version":"1.3.0","main":"./index.js","license":"MIT","bin":{"asc-viewer":"index.js"},"keywords":["cli","flowchart","atomic state","visualization","atomic state visualization","recoil graph"],"description":"An interactive web application for analyzing and visualizing atomic state relationships.","repository":{"type":"git","url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","directory":"apps/asc-viewer-cli"},"publishConfig":{"access":"public","provenance":true},"dependencies":{"@modelcontextprotocol/sdk":"1.24.3","acorn":"8.15.0","acorn-walk":"8.3.4","chokidar":"4.0.3","commander":"13.1.0","cosmiconfig":"8.3.6","d3-force":"3.0.0","oxc-parser":"0.86.0","zod":"4.2.0"},"type":"commonjs","gitHead":"8571b5bd5f23f17a54e6912a2c262093992167ad","_id":"@atomic-state-canvas/asc-viewer-cli@1.3.0","bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","_nodeVersion":"24.11.1","_npmVersion":"11.7.0","dist":{"integrity":"sha512-Zpnnf/Hzrib9IJRv2x25HuOjwDNjcomr4ni9nP8nJKNe8kElERS6bJgkIWuhNkJadn10YtCqbsHteMjrH+WlWA==","shasum":"e6a83e604f4b84e6ca7868fd32918c617b6baae1","tarball":"https://registry.npmjs.org/@atomic-state-canvas/asc-viewer-cli/-/asc-viewer-cli-1.3.0.tgz","fileCount":62,"unpackedSize":1769903,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@atomic-state-canvas%2fasc-viewer-cli@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHjvsXCM8UGRLqhn6IFnMU8Rzk3lDa0R/RJ0wi2bZNwmAiEA1aKEj17fX6aU6q1jlPrhowUFqX4tiFuByTnNhv5Ools="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:7adc0223-cead-4d88-a09f-13eff747995e"}},"directories":{},"maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/asc-viewer-cli_1.3.0_1765808189534_0.2905098114045268"},"_hasShrinkwrap":false}},"time":{"created":"2025-04-26T02:50:22.195Z","modified":"2025-12-15T14:16:30.126Z","1.0.0":"2025-04-26T02:50:22.447Z","1.0.1":"2025-04-26T03:01:15.996Z","1.0.2":"2025-04-26T17:46:09.381Z","1.0.3":"2025-04-26T18:10:35.640Z","1.1.0":"2025-04-27T09:33:14.331Z","1.2.0":"2025-09-11T03:37:38.448Z","1.2.1":"2025-12-12T07:27:24.926Z","1.3.0":"2025-12-15T14:16:29.727Z"},"bugs":{"url":"https://github.com/JaysonGCS/atomic-state-canvas/issues"},"license":"MIT","homepage":"https://github.com/JaysonGCS/atomic-state-canvas#readme","keywords":["cli","flowchart","atomic state","visualization","atomic state visualization","recoil graph"],"repository":{"type":"git","url":"git+https://github.com/JaysonGCS/atomic-state-canvas.git","directory":"apps/asc-viewer-cli"},"description":"An interactive web application for analyzing and visualizing atomic state relationships.","maintainers":[{"name":"jaysongcs","email":"goh.chung.sern@gmail.com"}],"readme":"# Atomic State Canvas Viewer CLI\n\nAn interactive web application for analyzing and visualizing atomic state relationships. By launching the development tool, it looks for \".asc.\" files in the directory and automatically populates the atomic graphs in a \"Storybook\"-like experience.\n\n## Installation\n```bash\nnpm install @atomic-state-canvas/asc-viewer-cli -D\n```\n\n## Configuration\n\nThe CLI uses [cosmiconfig](https://github.com/cosmiconfig/cosmiconfig) for configuration. Create one of the following files in your project root:\n\n- `.ascrc.json`\n- `.ascrc.js`\n- `.ascrc.yaml`\n- `asc.config.js`\n- `asc.config.ts`\n\n### Configuration Options\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `watchDir` | `string` | `\"src\"` | Directory to watch for `.asc.` files |\n| `port` | `number` | `1296` | Port to run the viewer server on |\n| `extensions` | `string[]` | `[\".asc.js\", \".asc.ts\"]` | File extensions to watch |\n| `excludePatternInGlob` | `string` | `undefined` | Glob pattern to exclude files |\n\n### Example Configuration\n\n`.ascrc.json`:\n```json\n{\n  \"watchDir\": \"./src\",\n  \"port\": 3000,\n  \"extensions\": [\".asc.ts\"],\n  \"excludePatternInGlob\": \"*.test.ts\"\n}\n```\n\n`asc.config.js`:\n```js\nmodule.exports = {\n  watchDir: './src/stores',\n  port: 1296,\n  extensions: ['.asc.ts', '.asc.js'],\n  excludePatternInGlob: '**/*.test.*'\n};\n```\n\n## Usage\n\n### Start the Viewer\n```bash\n# Start the viewer (default command)\nnpx asc-viewer\n\n# With options\nnpx asc-viewer serve --port 3000 --watch-dir ./src\n```\n\n### MCP Server (AI Assistant Integration)\n\nStart the MCP server for AI assistant integration:\n```bash\nnpx asc-viewer mcp\n```\n\nAdd to your Claude Code config (`.mcp.json`):\n```json\n{\n  \"mcpServers\": {\n    \"atomic-state-canvas\": {\n      \"command\": \"npx\",\n      \"args\": [\"@atomic-state-canvas/asc-viewer-cli\", \"mcp\"]\n    }\n  }\n}\n```\n\n#### Available MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `analyze_state` | Generate dependency graph from entry file/variable |\n| `find_cycles` | Detect cyclic dependencies and self-references |\n| `list_atoms` | List all atoms/selectors in a file with dependencies |\n| `launch_viewer` | Get command instructions to start the visualization server |\n\n#### MCP Inspector\n\nStart the MCP inspector for debugging and visualization:\n```bash\nnpx @modelcontextprotocol/inspector node dist/asc-viewer-cli/index.js mcp\n```\n","readmeFilename":"README.md"}