@wangs-ui/skills 1.3.0-alpha.14 → 1.3.0-alpha.16

package/dist/bin.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { i as listSkills, n as updateSkills, r as addSkills, t as removeSkills } from "./src-ilzo-M7u.js";
+import { i as listSkills, n as updateSkills, r as addSkills, t as removeSkills } from "./src-t3vXV084.js";
 import path from "node:path";
 import { parseArgs } from "node:util";
 //#region bin.ts
-var VERSION = "1.3.0-alpha.13";
+var VERSION = "1.3.0-alpha.15";
 var HELP_TEXT = `
 \x1b[1m\x1b[36m🚀 Wangs UI Skills & Rules CLI\x1b[0m
 Install, update, and manage modular AI agent skills and rules for Wangs UI React applications.

package/dist/index.js

@@ -1,2 +1,2 @@
-import { _ as loadAllRules, a as getAgentRuleDirs, c as getInstalledSkills, d as isRuleInstalled, f as isSkillInstalled, g as getSkill, h as getRule, i as listSkills, l as installRule, m as removeSkill, n as updateSkills, o as getAgentSkillDirs, p as removeRule, r as addSkills, s as getInstalledRules, t as removeSkills, u as installSkill, v as loadAllSkills } from "./src-ilzo-M7u.js";
+import { _ as loadAllRules, a as getAgentRuleDirs, c as getInstalledSkills, d as isRuleInstalled, f as isSkillInstalled, g as getSkill, h as getRule, i as listSkills, l as installRule, m as removeSkill, n as updateSkills, o as getAgentSkillDirs, p as removeRule, r as addSkills, s as getInstalledRules, t as removeSkills, u as installSkill, v as loadAllSkills } from "./src-t3vXV084.js";
 export { addSkills, getAgentRuleDirs, getAgentSkillDirs, getInstalledRules, getInstalledSkills, getRule, getSkill, installRule, installSkill, isRuleInstalled, isSkillInstalled, listSkills, loadAllRules, loadAllSkills, removeRule, removeSkill, removeSkills, updateSkills };

package/dist/skills/wangs-ui/wangs-ui-components/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: wangs-ui-components
+description: MCP Discovery Protocol, modular subpath import map, and primitive substitution map for Wangs UI applications.
+metadata:
+  owner: wangs-ui
+---
+
+# Skill: Wangs UI Component Fundamentals & MCP Protocol
+
+Use this skill to navigate the Wangs UI ecosystem. **MCP is the single source of truth** for all component APIs, props, variants, slots, and examples. Do not hardcode or assume props — always query MCP dynamically.
+
+---
+
+## 1. The MCP Discovery Protocol (Single Source of Truth)
+
+Do **NOT** guess component props, Pass-Through (`pt`) slots, or event names. Always query the MCP server dynamically:
+
+```mermaid
+graph TD
+    A[Identify Component / Primitive Needed] --> B[list_catalog to confirm name/id]
+    B --> C[get_component_api for typed contract]
+    B --> D[get_documentation for curated guidance]
+    C --> E{Need live story / variant code?}
+    D --> E
+    E -->|Yes| F[get_component_examples]
+    E -->|No| G[Implement with Subpath Import Map]
+    F --> G
+```
+
+### Discovery Steps:
+
+1. **Discover Catalog Entries**:
+   ```json
+   list_catalog({ "query": "button" })
+   list_catalog({ "category": "component" })
+   ```
+2. **Inspect Typed Contracts & Props** (`component` parameter):
+   ```json
+   get_component_api({ "component": "button" })
+   get_component_api({ "component": "datatable" })
+   get_component_api({ "component": "field" })
+   ```
+3. **Read Curated Narrative Documentation** (`id` parameter):
+   ```json
+   get_documentation({ "id": "button" })
+   get_documentation({ "id": "foundation" })
+   get_documentation({ "id": "form" })
+   ```
+4. **Fetch Live Storybook TSX Examples**:
+   ```json
+   get_component_examples({ "component": "button", "variant": "Sizes" })
+   get_component_examples({ "component": "datatable", "variant": "Basic" })
+   ```
+5. **Explore Knowledge Graph Relationships**:
+   ```json
+   query_graph({ "query": "DataTable" })
+   query_graph({ "query": "useForm" })
+   ```
+
+---
+
+## 2. Modular Subpath Import Map
+
+Always import via specific subpath modules to guarantee tree-shaking and avoid bundling entire packages:
+
+| Ecosystem Layer | Subpath Pattern | Example Imports |
+| :--- | :--- | :--- |
+| **Core Primitives** | `@wangs-ui/react-core/primitive/<name>` | `Button`, `Input`, `Select`, `DataTable`, `Dialog`, `Modal`, `Field`, `Form`, `Card`, `Badge` |
+| **Layout Primitives** | `@wangs-ui/foundation/layout` | `Stack`, `HStack`, `VStack`, `Flex`, `Grid`, `Box`, `Container`, `Section`, `ScrollArea` |
+| **Typography Primitives** | `@wangs-ui/foundation/theme` | `Text`, `Code`, `Kbd`, `Link`, `Blockquote`, `List`, `Mark` |
+| **Blocks & Shells** | `@wangs-ui/react-core/blocks/<name>` | `AppLayout`, `Sidebar`, `TableToolbar` |
+| **Form Engine** | `@wangs-ui/form/core`, `@wangs-ui/form/react` | Headless form state, hooks, validation adapters |
+| **Universal Navigation** | `@wangs-ui/react-navigation/web`, `@wangs-ui/react-navigation/native` | `buildGraph`, `paramRoute`, platform router bridges |
+| **Theme & Providers** | `@wangs-ui/react-core/api`, `@wangs-ui/foundation/theme` | `WangsUiProvider`, `ThemeProvider`, `useTheme` |
+| **Vector Icons** | `@wangs-ui/react-icons` | `SearchLine`, `AddLine`, `DeleteBin6Line`, `CheckLine` |
+| **i18n & Localization** | `@wangs-ui/react-i18n` | `useI18n`, `t`, `WangsUiI18nProvider` |
+
+---
+
+## 3. Primitive Substitution Map
+
+Zero raw HTML elements. Never write raw HTML tags when a Wangs UI primitive exists:
+
+| Forbidden Raw HTML | Mandatory Wangs UI Primitive | Import Path | MCP Catalog / Doc ID |
+| :--- | :--- | :--- | :--- |
+| `<button>` | `Button` | `@wangs-ui/react-core/primitive/button` | `button` |
+| `<input type="text">` | `Input` | `@wangs-ui/react-core/primitive/input` | `input` |
+| `<input type="number">` | `NumberInput` | `@wangs-ui/react-core/primitive/numberinput` | `numberinput` |
+| `<input type="checkbox">` | `Checkbox` | `@wangs-ui/react-core/primitive/checkbox` | `checkbox` |
+| `<select>` | `Select` / `MultiSelect` | `@wangs-ui/react-core/primitive/select` | `select`, `multiselect` |
+| `<textarea>` | `Textarea` | `@wangs-ui/react-core/primitive/textarea` | `textarea` |
+| `<form>` | `Form` / `DialogForm` | `@wangs-ui/react-core/primitive/form` | `form`, `dialogform` |
+| `<dialog>` / alert modal | `Modal` / `Dialog` | `@wangs-ui/react-core/primitive/modal` | `modal`, `dialog` |
+| `<table>` | `DataTable` | `@wangs-ui/react-core/primitive/datatable` | `datatable` |
+| `<div>` (layout / flex / grid) | `Stack`, `HStack`, `Flex`, `Grid`, `Box` | `@wangs-ui/foundation/layout` | `universal-layout` |
+| `<div>` (surface card) | `Card` | `@wangs-ui/react-core/primitive/card` | `card` |
+| Pill / status chip | `Badge` | `@wangs-ui/react-core/primitive/badge` | `badge` |
+| `<h1>` - `<h6>` | `<Text variant="...">` | `@wangs-ui/foundation/theme` | `foundation` |
+| `<p>`, `<span>` (body text) | `<Text variant="...">` | `@wangs-ui/foundation/theme` | `foundation` |
+| `<a>` | `Link` | `@wangs-ui/foundation/theme` | `foundation` |
+| `<code>` | `Code` | `@wangs-ui/foundation/theme` | `foundation` |
+| `<kbd>` | `Kbd` | `@wangs-ui/foundation/theme` | `foundation` |
+| `<blockquote>` | `Blockquote` | `@wangs-ui/foundation/theme` | `foundation` |
+| `<ul>`, `<ol>` | `List` | `@wangs-ui/foundation/theme` | `foundation` |