@kznlabs/labsui 0.1.3 → 0.1.5

package/dist/index.js

@@ -17284,7 +17284,7 @@ async function fetchAllItems(source) {
 // jsr.json
 var jsr_default = {
   name: "@kznlabs/labsui",
-  version: "0.1.3",
+  version: "0.1.5",
   license: "MIT",
   exports: "./src/index.ts",
   publish: {
@@ -18170,33 +18170,60 @@ labsUI components live in this project as source: edit them like your own code.
 - Pointer targets are at least 24×24 px. Prefer native validation
   (\`required\`, \`type\`, \`pattern\`).`;
 
-// src/mcp.ts
-var PROTOCOLS = ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
+// src/tools.ts
 var names = {
   type: "array",
   items: { type: "string", pattern: "^[a-z0-9][a-z0-9-]*$" },
   minItems: 1,
-  maxItems: 20
+  maxItems: 20,
+  description: "Item names as search lists them, e.g. button or date-picker."
+};
+var installed = {
+  ...names,
+  minItems: 0,
+  description: "Installed item names, e.g. button. Empty: all installed items."
+};
+var dryRun = {
+  type: "boolean",
+  default: false,
+  description: "Report what would change, write nothing."
+};
+var readOnly = { readOnlyHint: true, openWorldHint: false };
+var writes = {
+  readOnlyHint: false,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: true
 };
 var TOOLS = [
   {
     name: "search",
     title: "Search labsUI",
-    description: "Find components, blocks, hooks and helpers by name, export (useModal) or intent (date range, toast promise). All words must match; best first. No query lists everything.",
+    description: "Find labsUI components, blocks, hooks and helpers by name, export (useModal) or intent (date range, toast promise). All words must match, best match first; no query lists everything. Returns one line per hit: name, kind and summary. Start here when you don't know an item's name, then call view on the hits.",
     inputSchema: {
       type: "object",
       properties: {
         query: { type: "string", description: "Words to match. Empty lists everything." },
-        kind: { type: "string", enum: ["component", "block", "hook", "helper", "setup"] },
-        limit: { type: "integer", minimum: 1, maximum: 200, default: 12 }
+        kind: {
+          type: "string",
+          enum: ["component", "block", "hook", "helper", "setup"],
+          description: "Only this kind: component (primitive), block (composed section), hook, helper or setup."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 200,
+          default: 12,
+          description: "Most results to return."
+        }
       }
     },
-    annotations: { readOnlyHint: true, openWorldHint: false }
+    annotations: readOnly
   },
   {
     name: "view",
     title: "View labsUI items",
-    description: "Exact props and types, a usage line, full examples, what it brings along and which npm packages it installs. Call before writing code with a component.",
+    description: "Read the docs of labsUI items by name: exact props and types, a usage line, full examples, and the items and npm packages each brings along. Call it before writing code with a component instead of guessing props; find names with search, install with add.",
     inputSchema: {
       type: "object",
       properties: {
@@ -18205,78 +18232,60 @@ var TOOLS = [
       },
       required: ["names"]
     },
-    annotations: { readOnlyHint: true, openWorldHint: false }
+    annotations: readOnly
   },
   {
     name: "add",
     title: "Add labsUI items",
-    description: "Copy items and everything they import into the project and install their npm packages. Keeps files that already exist. Reports what to mount in the root layout.",
+    description: "Install labsUI items into the project: copies each item and everything it imports, then installs their npm packages. Existing files are kept, never overwritten. Returns the files written, the packages installed and anything to mount once in the root layout. Needs init first; dryRun previews. To bring installed items to a newer version, use update instead.",
     inputSchema: {
       type: "object",
-      properties: {
-        names,
-        dryRun: { type: "boolean", default: false, description: "Report, write nothing." }
-      },
+      properties: { names, dryRun },
       required: ["names"]
     },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true
-    }
+    annotations: writes
   },
   {
     name: "init",
     title: "Set up labsUI",
-    description: "One-time setup: styles, theme, utils and motion provider; imports labsui.css into the Tailwind stylesheet and writes labsui.json. Returns the root layout code to add.",
+    description: "Set up labsUI in a project, once, before add: writes the styles, theme, utils and motion provider, imports labsui.css into the Tailwind stylesheet and records settings in labsui.json. Returns warnings, the files written and the root layout code to add. Needs React 19 and Tailwind v4; run doctor first if unsure. Safe to repeat: existing files are kept. dryRun previews.",
     inputSchema: {
       type: "object",
-      properties: { dryRun: { type: "boolean", default: false } }
+      properties: { dryRun }
     },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: false,
-      idempotentHint: true,
-      openWorldHint: true
-    }
+    annotations: writes
   },
   {
     name: "diff",
     title: "Diff installed labsUI items",
-    description: "How installed items differ from this labsui version, as unified patches from the registry file to the project's. No names: every item that differs.",
+    description: "Compare installed labsUI items with this labsUI version. Returns a unified patch per changed file, from the registry file to the project file (+ lines exist only in the project); matching items are left out, and when nothing differs it says so. Use it to see local edits before update. Needs init.",
     inputSchema: {
       type: "object",
-      properties: { names: { ...names, minItems: 0 } }
+      properties: { names: installed }
     },
-    annotations: { readOnlyHint: true, openWorldHint: false }
+    annotations: readOnly
   },
   {
     name: "update",
     title: "Update labsUI items",
-    description: "Bring installed items to this labsui version. Unedited files are replaced; edited ones are merged three ways from the version that installed them, with conflict markers where both sides changed the same lines. No names: everything installed.",
+    description: "Bring installed labsUI items to this labsUI version. Unedited files are replaced; edited ones are merged three ways from the version that installed them, with conflict markers where both sides changed the same lines. Returns each changed item as replaced, merged, conflicts (with the files to resolve) or kept with the reason. Run diff first to see local edits; dryRun previews. Only for installed items: new ones go through add.",
     inputSchema: {
       type: "object",
-      properties: {
-        names: { ...names, minItems: 0 },
-        dryRun: { type: "boolean", default: false, description: "Report, write nothing." }
-      }
+      properties: { names: installed, dryRun }
     },
-    annotations: {
-      readOnlyHint: false,
-      destructiveHint: true,
-      idempotentHint: true,
-      openWorldHint: true
-    }
+    annotations: { ...writes, destructiveHint: true }
   },
   {
     name: "doctor",
     title: "Check the labsUI setup",
-    description: "Checks React 19, Tailwind v4, the path alias, the stylesheet import, MotionProvider and themeScript wiring, mounted Toaster/Confirmer, missing npm packages or files, and local edits. Each problem comes with its fix.",
+    description: "Check the labsUI setup: React 19, Tailwind v4, the path alias, the stylesheet import, MotionProvider and themeScript wiring, mounted Toaster/Confirmer, missing npm packages or files, and local edits. Returns pass, warn or fail per check, each problem with its fix. Run it after init or add, or when components look unstyled; for line-level changes use diff.",
     inputSchema: { type: "object", properties: {} },
-    annotations: { readOnlyHint: true, openWorldHint: false }
+    annotations: readOnly
   }
 ];
+
+// src/mcp.ts
+var PROTOCOLS = ["2025-11-25", "2025-06-18", "2025-03-26", "2024-11-05"];
 var text = (text, structured) => ({
   content: [{ type: "text", text }],
   ...structured !== undefined && { structuredContent: structured }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kznlabs/labsui",
-	"version": "0.1.3",
+	"version": "0.1.5",
 	"description": "Add labsUI components to your React + Tailwind v4 project: clean primitives you own, with smooth spring motion.",
 	"type": "module",
 	"mcpName": "io.github.kznlabs/labsui",