conductor-figma 1.0.2 → 3.0.0

package/LICENSE

@@ -19,3 +19,23 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+ADDITIONAL DISCLAIMER:
+
+This software is experimental and provided for educational and research
+purposes only. The author(s) and contributor(s) make no representations or
+warranties regarding the accuracy, completeness, reliability, or suitability
+of this software for any purpose.
+
+The author(s) shall not be held liable for any damages whatsoever — including
+but not limited to direct, indirect, incidental, special, consequential, or
+punitive damages — arising from the use, misuse, or inability to use this
+software, including but not limited to loss of data, corruption of design
+files, business interruption, or any other commercial or personal damages.
+
+This software interacts with third-party services and APIs (including but not
+limited to Figma, Cursor, and Claude Code) and is not affiliated with,
+endorsed by, or sponsored by any of these services or their parent companies.
+
+Users assume all risk associated with the use of this software. Always back
+up your work before running automated operations. Do your own research (DYOR).

package/README.md

@@ -1,25 +1,29 @@
-# CONDUCTOR
+# conductor-figma
 
-> Experimental software. DYOR. Use at your own risk.
-
-Design-intelligent MCP server for Figma. 61 tools across 10 categories. It doesn't place shapes — it designs. 8px grid, type scale ratios, auto-layout, component reuse, WCAG accessibility, and a self-auditing design score. Every decision follows the rules a senior designer applies instinctively.
+Design-intelligent MCP server for Figma. 201 tools across 17 categories. Every tool has built-in design intelligence — 8px grid, type scales, semantic colors, accessibility checks, component defaults. Not a shape proxy. A design engine.
 
 ```
 npx conductor-figma
 ```
 
-## What it does
+## What makes this different
 
-Other MCP servers translate your words into shapes. CONDUCTOR translates them into design decisions.
 
-Say "create a pricing page." A typical MCP creates rectangles with absolute positioning, random font sizes, and arbitrary spacing. CONDUCTOR creates a page with auto-layout frames, a type scale following a major third ratio (1.25), spacing on an 8px grid, and proper visual hierarchy — headings are dominant, body text recedes, CTAs are prominent.
+**Conductor** has 201 tools with design intelligence. You say "create a button" and it knows: 44px height (touch target), 20px horizontal padding (8px grid), 10px radius, 15px Semi Bold text. Every value is intentional.
 
 ## Setup
 
-Install the CONDUCTOR plugin from the Figma Community. Then add to your editor:
+### 1. Figma Plugin
+
+```
+git clone https://github.com/dragoon0x/conductor.git
+```
+
+In Figma: **Plugins → Development → Import plugin from manifest** → select `conductor/figma-plugin/manifest.json`
+
+### 2. Add to Cursor / Claude Code
 
 ```json
-// ~/.cursor/mcp.json
 {
   "mcpServers": {
     "conductor": {
@@ -30,164 +34,66 @@ Install the CONDUCTOR plugin from the Figma Community. Then add to your editor:
 }
 ```
 
-Open your Figma file, run the plugin, then chat:
-
-```
-"Create a SaaS landing page with hero, features, and pricing"
-"Audit this frame — is my spacing consistent?"
-"Generate a dark mode variant of this page"
-"Convert these absolute-positioned layers to auto-layout"
-```
-
-## 61 Tools · 10 Categories
-
-### Create (8)
-| Tool | Description |
-|------|-------------|
-| `create_frame` | Auto-layout frame with grid-aligned spacing |
-| `create_page` | Full page from intent: landing, pricing, dashboard |
-| `create_section` | Hero, features, testimonials, FAQ, CTA — pattern-aware |
-| `create_card` | Card with proper padding, radius, shadow, hierarchy |
-| `create_form` | Form with labels, inputs, validation, submit flow |
-| `create_table` | Data table with header, rows, sorting, pagination |
-| `create_modal` | Modal with overlay, sizing, and action buttons |
-| `create_nav` | Topbar, sidebar, breadcrumbs, tabs — with states |
-
-### Layout (7)
-| Tool | Description |
-|------|-------------|
-| `layout_auto` | Convert any frame to auto-layout |
-| `layout_grid` | Apply column grid: 12-col, 8-col, custom |
-| `layout_stack` | Stack children with consistent spacing |
-| `layout_wrap` | Wrap-layout for tags, pills, flexible grids |
-| `layout_constrain` | Set fill, hug, fixed, min/max constraints |
-| `layout_align` | Align and distribute frames on the grid |
-| `layout_nest` | Restructure flat layers into auto-layout tree |
-
-### Typography (6)
-| Tool | Description |
-|------|-------------|
-| `type_scale` | Generate or detect type scale ratios |
-| `type_hierarchy` | Set heading levels with proper ratios |
-| `type_pair` | Font pairing suggestions |
-| `type_measure` | Check line length and readability |
-| `type_apply` | Bulk-apply text styles |
-| `type_audit` | Find off-scale sizes and inconsistencies |
-
-### Color & Style (7)
-| Tool | Description |
-|------|-------------|
-| `color_palette` | Generate 50-950 shades from one color |
-| `color_semantic` | Create semantic tokens |
-| `color_darkmode` | Generate dark mode with preserved contrast |
-| `color_contrast` | WCAG AA/AAA contrast checking |
-| `color_apply` | Apply colors by semantic role |
-| `style_shadow` | Generate elevation system |
-| `style_radius` | Generate radius scale |
-
-### Components (6)
-| Tool | Description |
-|------|-------------|
-| `component_list` | List components in file or library |
-| `component_use` | Instantiate with variant props |
-| `component_create` | Create component from frame |
-| `component_swap` | Swap instances across a frame |
-| `component_detach` | Detach instances to editable frames |
-| `component_audit` | Find missing/unused/detached components |
-
-### Spacing & Grid (6)
-| Tool | Description |
-|------|-------------|
-| `spacing_scale` | Generate spacing scale from base unit |
-| `spacing_fix` | Snap off-grid values to nearest grid |
-| `spacing_audit` | Report all spacing values, flag issues |
-| `spacing_rhythm` | Check vertical rhythm consistency |
-| `grid_apply` | Apply layout grid to a frame |
-| `grid_check` | Verify children align to grid |
-
-### Audit & Critique (6)
-| Tool | Description |
-|------|-------------|
-| `audit_full` | Full design audit across all categories |
-| `audit_hierarchy` | Check visual hierarchy |
-| `audit_consistency` | Find elements with inconsistent styles |
-| `audit_alignment` | Flag misaligned elements |
-| `audit_density` | Check information density |
-| `audit_score` | 0-100 design health score |
-
-### Accessibility (5)
-| Tool | Description |
-|------|-------------|
-| `a11y_contrast` | WCAG AA/AAA contrast checking |
-| `a11y_touch` | 44x44px touch target verification |
-| `a11y_focus` | Generate focus ring styles |
-| `a11y_labels` | Check for missing labels |
-| `a11y_fix` | Auto-fix: contrast, targets, focus |
-
-### Responsive (4)
-| Tool | Description |
-|------|-------------|
-| `responsive_variant` | Generate mobile/tablet/desktop variants |
-| `responsive_reflow` | Reflow desktop to mobile |
-| `responsive_breakpoints` | Set up breakpoint frames |
-| `responsive_check` | Verify overflow and targets |
-
-### Export & Handoff (6)
-| Tool | Description |
-|------|-------------|
-| `export_tokens_css` | CSS custom properties |
-| `export_tokens_tailwind` | Tailwind config extension |
-| `export_tokens_json` | W3C Design Tokens format |
-| `export_tokens_scss` | SCSS variables |
-| `export_spec` | Design spec with measurements |
-| `export_changelog` | Diff two frames |
+### 3. Design
 
-## Design Intelligence
-
-Every tool is backed by real design logic, not arbitrary values.
-
-**8px Grid**: All spacing values snap to the nearest multiple of 8. Padding, margins, gaps — no 13px, no 27px, no arbitrary numbers.
-
-**Type Scale Ratios**: Font sizes follow mathematical ratios. Minor third (1.2), major third (1.25), perfect fourth (1.333), golden ratio (1.618). Headings, body, captions all relate to each other.
-
-**Auto-Layout**: Every frame uses Figma auto-layout with proper direction, gap, padding, and alignment. Zero absolute positioning.
+Open Figma → Run the Conductor plugin → Chat in Cursor:
 
-**WCAG Accessibility**: Contrast checking against AA (4.5:1) and AAA (7:1). Touch target verification (44x44px minimum). Focus state generation.
+> "Create a mobile login screen with email and password fields"
 
-**Design Score**: 0-100 health score weighted across spacing (25%), typography (20%), color (15%), components (15%), accessibility (15%), hierarchy (10%).
+> "Design a dashboard with sidebar, KPI cards, and chart area"
 
-## Programmatic API
+> "Audit the accessibility of my current selection"
 
-```js
-import { generateTypeScale, checkContrast, auditSpacing, snapToGrid } from 'conductor-figma'
+> "Export this frame as React + Tailwind code"
 
-const scale = generateTypeScale(16, 'major-third')
-// → { scale: 'Major Third', ratio: 1.25, sizes: [...] }
+## 201 Tools in 17 Categories
 
-const contrast = checkContrast('#333333', '#ffffff')
-// → { ratio: 12.63, aa: true, aaa: true }
+| Category | Count | Highlights |
+|----------|-------|-----------|
+| Create & Layout | 20 | Frames, text, shapes, smart components (18 types), sections, pages, forms, tables, nav bars, cards, sidebars |
+| Modify & Style | 25 | Fills (solid + gradients), strokes, effects, image fills, text ranges, constraints, transforms |
+| Vector & Shape | 8 | Paths, booleans, polygons, stars, 35 built-in icons, arrows, dividers |
+| Read & Inspect | 18 | Selection, page tree, node info, search, CSS export, fonts, annotations, measurements |
+| Variables & Tokens | 10 | Collections, modes, binding, W3C import/export, full token system from brand color |
+| Export & Code | 12 | React + Tailwind, HTML, Vue, Svelte, SVG, PNG, design specs, stylesheets, palettes |
+| Accessibility & Lint | 12 | WCAG audit, contrast, touch targets, font sizes, color blindness, design lint, compliance reports |
+| Batch Operations | 17 | Rename patterns, bulk style, find/replace text/color, clean hidden layers, round values, set fonts |
+| Design System | 10 | Scan, extract, normalize, lint, style guide, palette, type scale, import/export |
+| Responsive | 5 | Mobile/tablet/desktop variants, breakpoints, stacking, responsive conversion |
+| Typography | 10 | Type scale, audit, hierarchy, measure, normalize, font replace, pairing, styles |
+| Color | 10 | Palette generation, harmonies, dark/light mode, contrast check, semantic systems |
+| Prototype | 10 | Links, transitions, overlays, scroll, hover states, flows, fixed position |
+| Page Management | 8 | Create, switch, duplicate, delete, rename, sort, merge, overview |
+| Library | 8 | Search, swap, detach, audit, batch swap, publish |
+| Annotation & Handoff | 10 | Spacing redlines, color swatches, typography specs, spec sheets, changelogs |
+| Effects & Styles | 8 | Glassmorphism, neumorphism, noise, gradients, shadow systems, border gradients |
 
-const audit = auditSpacing([8, 13, 16, 22, 32], 8)
-// → { adherence: 0.6, fixes: [{ from: 13, to: 16 }, { from: 22, to: 24 }] }
-```
+## Design Intelligence
 
-## CLI
+Every tool queries the intelligence engine:
 
-```bash
-conductor-figma --list        # List all 61 tools
-conductor-figma --categories  # Show categories
-conductor-figma --help        # Help
-conductor-figma               # Start MCP server (stdio)
-```
+- **8px Grid**: All spacing values snapped to 8px grid
+- **Type Scale**: 7 mathematical ratios (Minor Second through Golden Ratio)
+- **Semantic Colors**: Full palette from one brand color (dark + light modes)
+- **Component Defaults**: 18 component types with size variants (button, input, card, avatar, badge, chip, switch, checkbox, radio, toast, tooltip, modal, dropdown, tabs, table, progress, skeleton, divider)
+- **Accessibility**: WCAG AA/AAA contrast, 44px touch targets, font minimums, color blindness
+- **Font Weights**: Auto-resolves "bold" → "Bold", "600" → "Semi Bold"
+- **Layout Intelligence**: 13 layout presets (row, column, center, spread, grid, sidebar, form)
 
-## Zero Dependencies
+## License
 
-CONDUCTOR has no runtime dependencies. Pure JavaScript. The design intelligence engine runs locally — no API calls, no external services.
+MIT. Built by [0xDragoon](https://github.com/dragoon0x).
 
 ## Disclaimer
 
-Experimental, open-source software. Provided as-is with no warranties. DYOR. Use at your own risk. The author assumes zero liability.
+**This software is provided strictly for educational and experimental purposes only.** Do your own research (DYOR) before using in any production environment.
 
-## License
+- This is experimental, open-source software provided "as-is" with **absolutely no warranties, representations, or guarantees of any kind** — express, implied, or statutory — including but not limited to warranties of merchantability, fitness for a particular purpose, accuracy, reliability, or non-infringement.
+- The author(s), contributor(s), and maintainer(s) of this project — including the individual known as 0xDragoon — **shall not be held liable** for any direct, indirect, incidental, special, consequential, or punitive damages, losses, costs, or expenses arising from or related to the use, misuse, inability to use, or reliance upon this software, including but not limited to loss of data, loss of revenue, business interruption, or damages to Figma files, design assets, or any other digital property.
+- This software interacts with third-party services (Figma, Cursor, Claude Code) over which the author has no control. The author assumes **no responsibility** for any changes, outages, API modifications, or policy updates by these third parties that may affect the functionality of this software.
+- No data collection, telemetry, or analytics are performed by this software. All operations run locally between your machine and the Figma desktop application. However, the author makes **no guarantees** regarding data security, privacy, or confidentiality.
+- This software is **not affiliated with, endorsed by, or sponsored by** Figma, Inc., Anthropic, PBC, Anysphere (Cursor), or any other company or organization.
+- Users are solely responsible for ensuring their use of this software complies with all applicable laws, regulations, terms of service, and licensing agreements — including Figma's Terms of Service and API usage policies.
+- **Use at your own risk.** Always back up your Figma files before running any automated operations. The author is not responsible for any unintended modifications, deletions, or corruption of design files.
 
-MIT. Built by 0xDragoon.
+MIT License · Copyright © 2025 0xDragoon

package/bin/conductor.js

@@ -1,76 +1,2 @@
 #!/usr/bin/env node
-
-import { startServer } from '../src/server.js';
-import { TOOLS, CATEGORIES } from '../src/tools/registry.js';
-
-var args = process.argv.slice(2);
-
-if (args.includes('--help') || args.includes('-h')) {
-  console.log(`
-  ⊞ CONDUCTOR — Design-intelligent MCP server for Figma
-
-  Usage:
-    conductor-figma                Start MCP server + orchestrator
-    conductor-figma --port 9800    Set WebSocket port (default: 9800)
-    conductor-figma --list         List all ${TOOLS.length} tools
-    conductor-figma --categories   Show tool categories
-    conductor-figma --help         Show this help
-
-  How it works:
-    1. You say "create a pricing page" in Cursor
-    2. CONDUCTOR generates a blueprint (30-50 commands)
-    3. Each command executes sequentially on your Figma canvas
-    4. Frames, text, cards, buttons appear in real-time
-    5. All auto-layout. All grid-aligned. All design-intelligent.
-
-  Setup:
-    ~/.cursor/mcp.json:
-    {
-      "mcpServers": {
-        "conductor": {
-          "command": "npx",
-          "args": ["-y", "conductor-figma"]
-        }
-      }
-    }
-
-  Then open the CONDUCTOR plugin in Figma and click Connect.
-
-  ${TOOLS.length} tools · ${Object.keys(CATEGORIES).length} categories
-  Built by 0xDragoon · MIT License
-`);
-  process.exit(0);
-}
-
-if (args.includes('--list')) {
-  for (var entries = Object.entries(CATEGORIES), i = 0; i < entries.length; i++) {
-    var catKey = entries[i][0], cat = entries[i][1];
-    var tools = TOOLS.filter(function(t) { return t.category === catKey; });
-    console.log('\n  ' + cat.icon + ' ' + cat.label + ' (' + tools.length + ')');
-    for (var j = 0; j < tools.length; j++) {
-      console.log('    ' + tools[j].name.padEnd(28) + ' ' + tools[j].description.slice(0, 70));
-    }
-  }
-  console.log('\n  ' + TOOLS.length + ' tools total\n');
-  process.exit(0);
-}
-
-if (args.includes('--categories')) {
-  for (var entries2 = Object.entries(CATEGORIES), k = 0; k < entries2.length; k++) {
-    var key = entries2[k][0], cat2 = entries2[k][1];
-    var count = TOOLS.filter(function(t) { return t.category === key; }).length;
-    console.log('  ' + cat2.icon + ' ' + cat2.label.padEnd(18) + ' ' + count + ' tools');
-  }
-  console.log('\n  ' + TOOLS.length + ' tools total');
-  process.exit(0);
-}
-
-// Parse port
-var port = 9800;
-var portIdx = args.indexOf('--port');
-if (portIdx !== -1 && args[portIdx + 1]) {
-  port = parseInt(args[portIdx + 1]) || 9800;
-}
-
-// Start MCP server with relay
-startServer({ port: port });
+import '../src/server.js'