npm - @1agh/maude - Versions diffs - 0.19.1 → 0.21.0 - Mend

@1agh/maude 0.19.1 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (105) hide show

package/README.md +7 -0
package/cli/bin/maude.mjs +5 -1
package/cli/commands/design-link.test.mjs +207 -0
package/cli/commands/design.mjs +42 -12
package/cli/commands/doctor.mjs +350 -0
package/cli/commands/doctor.test.mjs +185 -0
package/cli/commands/help.mjs +24 -0
package/cli/commands/hub.mjs +231 -0
package/cli/commands/hub.test.mjs +87 -0
package/cli/lib/config-lint.mjs +141 -0
package/cli/lib/config-lint.test.mjs +117 -0
package/cli/lib/design-link.mjs +216 -0
package/cli/lib/hubs-config.mjs +123 -0
package/cli/lib/hubs-config.test.mjs +100 -0
package/cli/lib/preflight.mjs +232 -0
package/cli/lib/stack-detect.mjs +344 -0
package/cli/lib/stack-detect.test.mjs +121 -0
package/package.json +17 -9
package/plugins/design/dependencies.json +147 -0
package/plugins/design/dependencies.schema.json +107 -0
package/plugins/design/dev-server/ai-banner.tsx +188 -0
package/plugins/design/dev-server/annotations-context-toolbar.tsx +115 -41
package/plugins/design/dev-server/annotations-layer.tsx +256 -107
package/plugins/design/dev-server/api.ts +17 -1
package/plugins/design/dev-server/artboard-marquee.tsx +10 -6
package/plugins/design/dev-server/bin/asset-sweep.sh +180 -0
package/plugins/design/dev-server/bin/preflight.sh +32 -0
package/plugins/design/dev-server/bin/runtime-health.sh +169 -0
package/plugins/design/dev-server/bin/visual-sanity.sh +221 -0
package/plugins/design/dev-server/canvas-lib.tsx +534 -32
package/plugins/design/dev-server/canvas-shell.tsx +479 -29
package/plugins/design/dev-server/client/app.jsx +72 -0
package/plugins/design/dev-server/client/hmr.mjs +28 -0
package/plugins/design/dev-server/collab/ai-activity.ts +127 -0
package/plugins/design/dev-server/collab/git-lifecycle.ts +124 -0
package/plugins/design/dev-server/collab/index.ts +47 -0
package/plugins/design/dev-server/collab/persistence.ts +123 -0
package/plugins/design/dev-server/collab/protocol.ts +108 -0
package/plugins/design/dev-server/collab/registry.ts +110 -0
package/plugins/design/dev-server/collab/room.ts +215 -0
package/plugins/design/dev-server/commands/annotation-strokes-command.ts +127 -0
package/plugins/design/dev-server/commands/equal-spacing-command.ts +28 -0
package/plugins/design/dev-server/commands/move-artboards-command.ts +158 -0
package/plugins/design/dev-server/comments-overlay.tsx +41 -4
package/plugins/design/dev-server/contextual-toolbar.tsx +241 -0
package/plugins/design/dev-server/cursors-overlay.tsx +296 -0
package/plugins/design/dev-server/dist/client.bundle.js +75 -3
package/plugins/design/dev-server/dist/runtime/motion.js +165 -0
package/plugins/design/dev-server/dist/runtime/motion_react.js +409 -0
package/plugins/design/dev-server/dist/runtime/y-protocols_awareness.js +587 -0
package/plugins/design/dev-server/dist/runtime/y-protocols_sync.js +257 -0
package/plugins/design/dev-server/dist/runtime/yjs.js +7107 -0
package/plugins/design/dev-server/equal-spacing-detector.ts +98 -0
package/plugins/design/dev-server/equal-spacing-handles.tsx +289 -0
package/plugins/design/dev-server/export-dialog.tsx +1 -1
package/plugins/design/dev-server/handoff.ts +24 -0
package/plugins/design/dev-server/hmr-broadcast.ts +15 -2
package/plugins/design/dev-server/http.ts +91 -1
package/plugins/design/dev-server/input-router.tsx +52 -2
package/plugins/design/dev-server/marquee-overlay.tsx +282 -0
package/plugins/design/dev-server/participants-chrome.tsx +261 -0
package/plugins/design/dev-server/runtime-bundle.ts +15 -0
package/plugins/design/dev-server/server.ts +78 -11
package/plugins/design/dev-server/test/ai-activity.test.ts +113 -0
package/plugins/design/dev-server/test/annotation-strokes-command.test.ts +149 -0
package/plugins/design/dev-server/test/annotations-layer.test.ts +44 -0
package/plugins/design/dev-server/test/canvas-lib-motion.test.ts +131 -0
package/plugins/design/dev-server/test/collab-annotations-bridge.test.ts +55 -0
package/plugins/design/dev-server/test/collab-bridge.test.ts +81 -0
package/plugins/design/dev-server/test/collab-loopback.test.ts +63 -0
package/plugins/design/dev-server/test/collab-protocol.test.ts +146 -0
package/plugins/design/dev-server/test/collab-room.test.ts +182 -0
package/plugins/design/dev-server/test/collab-stress.test.ts +121 -0
package/plugins/design/dev-server/test/equal-spacing-detector.test.ts +93 -0
package/plugins/design/dev-server/test/git-lifecycle.test.ts +101 -0
package/plugins/design/dev-server/test/input-router.test.ts +87 -1
package/plugins/design/dev-server/test/marquee-overlay.test.ts +94 -0
package/plugins/design/dev-server/test/move-artboards-command.test.ts +108 -0
package/plugins/design/dev-server/test/participants-chrome.test.ts +30 -0
package/plugins/design/dev-server/test/undo-stack.test.ts +211 -0
package/plugins/design/dev-server/test/use-collab.test.ts +71 -0
package/plugins/design/dev-server/test/use-cursor-modifiers.test.ts +59 -0
package/plugins/design/dev-server/test/use-keyboard-discipline.test.ts +27 -0
package/plugins/design/dev-server/test/use-undo-stack.test.tsx +193 -0
package/plugins/design/dev-server/tool-palette.tsx +7 -7
package/plugins/design/dev-server/undo-hud.tsx +95 -0
package/plugins/design/dev-server/undo-stack.ts +240 -0
package/plugins/design/dev-server/use-annotation-resize.tsx +1 -1
package/plugins/design/dev-server/use-artboard-drag.tsx +6 -3
package/plugins/design/dev-server/use-collab.tsx +478 -0
package/plugins/design/dev-server/use-cursor-modifiers.tsx +122 -0
package/plugins/design/dev-server/use-keyboard-discipline.tsx +125 -0
package/plugins/design/dev-server/use-undo-stack.tsx +355 -0
package/plugins/design/dev-server/ws.ts +123 -7
package/plugins/design/templates/_shell.html +51 -6
package/plugins/design/templates/design-system-inspiration/SUB-AGENT-PROMPTS.md +245 -0
package/plugins/design/templates/design-system-inspiration/_MAPPING.md +2 -2
package/plugins/design/templates/design-system-inspiration/core/preview/_components.css.tpl +129 -0
package/plugins/design/templates/design-system-inspiration/core/preview/_motion-readme.md.tpl +63 -0
package/plugins/design/templates/design-system-inspiration/core/preview/motion.css.tpl +106 -0
package/plugins/design/templates/design-system-inspiration/core/preview/motion.tsx.tpl +208 -0
package/plugins/flow/.claude-plugin/config.schema.json +12 -0
package/plugins/flow/dependencies.json +143 -0
package/plugins/flow/dependencies.schema.json +107 -0
/package/plugins/design/templates/design-system-inspiration/core/preview/{motion.html → .archive/motion.html} +0 -0

package/plugins/design/templates/design-system-inspiration/core/preview/motion.tsx.tpl ADDED Viewed

@@ -0,0 +1,208 @@
+/**
+ * @canvas      motion — motion vocabulary (Phase 3.7 / DDR-049 playground).
+ *              8 role tiles looping on first paint, 4 token-derived playback
+ *              chips, 2 easing-curve SVGs derived from token cubic-bezier
+ *              control points. Reduced-motion toggle for in-browser
+ *              inspection without OS settings.
+ * @ds          {{ds_dirname}}
+ * @platform    desktop
+ * @opt_out     none
+ * @artboards   primary
+ * @brief       MDCC-DSN/01.motion / {{project_label}}
+ * @stack       React 19 · TSX · Bun.build · css_mode=inline
+ * @history     .design/_history/motion/
+ * @handoff     bunx shadcn add file://./motion.registry.json
+ *
+ * SPECIMEN: motion
+ * DEMONSTRATES: --dur-flip · --dur-panel · --dur-route · --dur-soft ·
+ *               --ease-out · --ease-in-out · prefers-reduced-motion guard ·
+ *               <MotionDemo role> 8-role vocabulary · TokenPlayback chips
+ * COMPOSITION: 8 role tiles looping always · 4 token chips · 2 curve SVGs ·
+ *              reduced-motion toggle · inline a11y note
+ * COPY VOICE: role-named ("Flip", "Panel slide", "Route enter", ...)
+ * WHEN SCAFFOLDED: always (Core, gated on motion ∈ activeFamilies which is
+ *                  default-on)
+ *
+ * BOUNDED GEOMETRY (ANIMATION SAFETY, SUB-AGENT-PROMPTS.md):
+ *   Every <MotionDemo> root has overflow: hidden inline (set in canvas-lib).
+ *   Sparkle / pulse / twinkle keyframes (scale 0→1→0) are demonstrated ONLY
+ *   on the 32×32 sparkle chip inside the "presence" tile — NEVER on the full
+ *   tile. The bounding box of a rotating element extends √2× at 45°; tile
+ *   chrome would overflow without the explicit clip.
+ *
+ * REDUCED-MOTION:
+ *   <ReducedMotionToggle/> on the chrome row flips data-reduced-motion="true"
+ *   on <html>. The motion specimen is the documented exception to the
+ *   OS-level prefers-reduced-motion contract — reviewers need both branches
+ *   visible side-by-side. <MotionDemo> programmatically short-circuits its
+ *   animate prop when useReducedMotion() returns true (the contract is
+ *   enforced in two places: CSS --dur-*: 1ms collapse + JS short-circuit).
+ */
+import "../colors_and_type.css";
+import "./_layout.css";
+import "./motion.css";
+import {
+  MotionDemo,
+  MotionTrack,
+  TokenPlayback,
+  ReducedMotionToggle,
+  useMotionTokens,
+} from "@maude/canvas-lib";
+export default function Motion() {
+  return (
+    <>
+      <header className="specimen-hd">
+        <span className="sku">MDCC-DSN/01.motion</span>
+        <span className="crumbs">{{project_label}} · motion vocabulary · 8 roles · 4 tokens</span>
+        <span className="theme-toggle-slot">
+          <ReducedMotionToggle />
+        </span>
+      </header>
+      <main className="specimen">
+        <section className="specimen-title">
+          <h1>Motion</h1>
+          <p className="lede">
+            Eight roles. Four durations × two eases. Every animation in the
+            system maps to one role; <code>&lt;MotionDemo role="…"&gt;</code>{" "}
+            from <code>@maude/canvas-lib</code> is the only legal authoring
+            surface (CSS-only escape hatch via <code>.motion-*</code> classes).
+            Roles loop on first paint — hover not required.
+          </p>
+        </section>
+        <section className="motion-roles">
+          <h2>Roles</h2>
+          <div className="motion-grid">
+            <RoleTile name="Flip" role="flip" token="--dur-flip" ease="--ease-out" note="Press-down, hover lift, single-card flip." />
+            <RoleTile name="Panel slide" role="panel" token="--dur-panel" ease="--ease-in-out" note="Drawer / sidebar / segmented." />
+            <RoleTile name="Route enter" role="route" token="--dur-route" ease="--ease-out" note="Page transition. Opacity + tiny scale." />
+            <RoleTile name="Soft fade" role="soft" token="--dur-soft" ease="--ease-out" note="Toast, tooltip, soft reveal." />
+            <RoleTile name="Spring snap" role="spring" token="--dur-panel" ease="spring" note="Use only when brief asks for tactile/playful." />
+            <RoleTile name="Scroll link" role="scroll" token="--dur-route" ease="--ease-in-out" note="Scroll-progress-bound entry." />
+            <RoleTile name="Drag spring" role="drag" token="--dur-flip" ease="--ease-out" note="Pick up + release rotational settle." />
+            <RoleTile name="Presence" role="presence" token="--dur-soft" ease="--ease-out" sparkle note="Sparkle demo — 32×32 chip ONLY." />
+          </div>
+        </section>
+        <section className="motion-tokens">
+          <h2>Token playback (click to replay)</h2>
+          <p className="lede">
+            Each chip fires its token verbatim once. The numeric ms value
+            is the live <code>getComputedStyle</code> read, so token edits to{" "}
+            <code>colors_and_type.css</code> reflect here without a rebuild.
+          </p>
+          <MotionTrack>
+            <TokenPlayback duration="--dur-flip" easing="--ease-out" label="--dur-flip" />
+            <TokenPlayback duration="--dur-soft" easing="--ease-out" label="--dur-soft" />
+            <TokenPlayback duration="--dur-panel" easing="--ease-in-out" label="--dur-panel" />
+            <TokenPlayback duration="--dur-route" easing="--ease-out" label="--dur-route" />
+          </MotionTrack>
+        </section>
+        <section className="motion-curves">
+          <h2>Easing curves</h2>
+          <p className="lede">
+            Both curves derived from the token's live{" "}
+            <code>cubic-bezier(x1, y1, x2, y2)</code> value — not hand-drawn.
+            Edit the token in <code>colors_and_type.css</code>; the curve
+            redraws.
+          </p>
+          <div className="motion-curves__row">
+            <EasingCurve label="--ease-out" cssVar="--ease-out" />
+            <EasingCurve label="--ease-in-out" cssVar="--ease-in-out" />
+          </div>
+        </section>
+        <section className="motion-a11y">
+          <h2>Reduced motion</h2>
+          <p className="lede">
+            OS-level <code>@media (prefers-reduced-motion: reduce)</code>{" "}
+            collapses every <code>--dur-*</code> to <code>1ms</code> at the CSS
+            layer. <code>&lt;MotionDemo&gt;</code> additionally short-circuits
+            its <code>animate</code> prop via{" "}
+            <code>useReducedMotion()</code> from <code>motion/react</code>{" "}
+            (belt + suspenders — the a11y invariant deserves both). The toggle
+            on the chrome row above flips{" "}
+            <code>data-reduced-motion="true"</code> on <code>&lt;html&gt;</code>{" "}
+            for in-browser inspection without OS settings; specimen chrome is
+            the documented exception to OS-level honor.
+          </p>
+        </section>
+      </main>
+    </>
+  );
+}
+interface RoleTileProps {
+  name: string;
+  role:
+    | "flip"
+    | "panel"
+    | "route"
+    | "soft"
+    | "spring"
+    | "scroll"
+    | "drag"
+    | "presence";
+  token: string;
+  ease: string;
+  note: string;
+  sparkle?: boolean;
+}
+function RoleTile({ name, role, token, ease, note, sparkle = false }: RoleTileProps) {
+  return (
+    <div className="motion-card">
+      <strong>{name}</strong>
+      <div className="motion-card__stage">
+        <MotionDemo role={role} loop="always" small={sparkle} label={`${role} demo`} />
+      </div>
+      <code className="motion-card__tokens">
+        {token} · {ease}
+      </code>
+      <span className="motion-card__note">{note}</span>
+    </div>
+  );
+}
+/**
+ * Derives a Bezier path from a CSS easing token's live cubic-bezier(x1, y1,
+ * x2, y2) value. Falls back to a sane default when the token isn't readable
+ * (SSR, detached). The path is fitted to a 100×100 viewBox; y-axis is
+ * flipped so progress goes bottom-left to top-right the way curves are read
+ * in editor previews.
+ */
+function EasingCurve({ label, cssVar }: { label: string; cssVar: string }) {
+  const tokens = useMotionTokens();
+  const live = tokens.easings[cssVar] ?? "";
+  const match = live.match(/cubic-bezier\(([^)]+)\)/);
+  const [x1, y1, x2, y2] = match
+    ? match[1].split(",").map((s) => parseFloat(s.trim()))
+    : cssVar === "--ease-in-out"
+      ? [0.4, 0, 0.2, 1]
+      : [0, 0, 0.2, 1];
+  const path = `M 0 100 C ${x1 * 100} ${100 - y1 * 100} ${x2 * 100} ${100 - y2 * 100} 100 0`;
+  return (
+    <figure className="motion-curve">
+      <svg viewBox="0 0 100 100" width="120" height="120" aria-hidden="true">
+        <rect x="0" y="0" width="100" height="100" fill="var(--bg-1)" />
+        <path
+          d="M 0 100 L 100 100 M 0 100 L 0 0"
+          stroke="var(--border-default, currentColor)"
+          strokeWidth="1"
+          fill="none"
+          opacity="0.4"
+        />
+        <path d={path} stroke="var(--accent)" strokeWidth="2" fill="none" />
+      </svg>
+      <figcaption>
+        <code>{label}</code>
+        <span className="motion-curve__values">
+          {x1.toFixed(2)}, {y1.toFixed(2)}, {x2.toFixed(2)}, {y2.toFixed(2)}
+        </span>
+      </figcaption>
+    </figure>
+  );
+}

package/plugins/flow/.claude-plugin/config.schema.json CHANGED Viewed

@@ -6,6 +6,10 @@
   "additionalProperties": false,
   "required": ["name"],
   "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Pointer to this schema (editor support). Stripped at consumption time."
+    },
     "name": {
       "type": "string",
       "description": "Short project / product name. Resolves the `<project>` placeholder in commands and file paths (e.g. `.ai/<project>-prd.md` → `.ai/<name>-prd.md`)."
@@ -304,6 +308,14 @@
         }
       }
     },
+    "quality": {
+      "type": "object",
+      "description": "Map of gate name → shell command string. Gate names are free-form (conventional names: `lint`, `format`, `typecheck`, `tests`, `build`). Each command is executed as-is via `eval` by the slash command that consumes the gate. Missing gate → slash command emits a one-line warning and skips (never fabricates a command). v1 deliberately keeps this a flat string map — no per-gate object shape, no `order`, no `scope`. Populate via `maude doctor --fix`, which detects from `package.json` scripts + tool presence. Existing user values are never overwritten — additions only.",
+      "additionalProperties": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
     "integrations": {
       "type": "object",
       "additionalProperties": false,

package/plugins/flow/dependencies.json ADDED Viewed

@@ -0,0 +1,143 @@
+{
+  "$schema": "./dependencies.schema.json",
+  "version": "1",
+  "plugin": "flow",
+  "dependencies": [
+    {
+      "id": "node",
+      "type": "cli",
+      "hardness": "hard",
+      "check": {
+        "command": "node --version",
+        "expectExit": 0,
+        "minVersion": "20.0.0"
+      },
+      "install": {
+        "preferred": "https://nodejs.org/en/download",
+        "darwin": "brew install node@22"
+      },
+      "autoInstall": false,
+      "usedBy": ["commands/init.md"],
+      "docsUrl": "https://nodejs.org"
+    },
+    {
+      "id": "git",
+      "type": "cli",
+      "hardness": "hard",
+      "check": {
+        "command": "git --version",
+        "expectExit": 0
+      },
+      "install": {
+        "darwin": "brew install git",
+        "linux": "apt-get install -y git || dnf install -y git"
+      },
+      "autoInstall": false,
+      "usedBy": ["commands/init.md", "commands/done.md", "commands/quick.md"],
+      "docsUrl": "https://git-scm.com"
+    },
+    {
+      "id": "maude",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "maude --version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "npm i -g @1agh/maude"
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "/flow:init and /flow:done work without maude CLI but cannot read/write workflows.config.json via `maude config`.",
+      "usedBy": ["commands/init.md"],
+      "docsUrl": "https://github.com/1aGh/maude"
+    },
+    {
+      "id": "agent-browser",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "agent-browser --version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "npm i -g @anthropic-ai/agent-browser"
+      },
+      "autoInstall": true,
+      "fallbackBehavior": "/flow:scenario and a11y-auditor degrade to screenshot-less reports. Web scenarios cannot run.",
+      "usedBy": [
+        "commands/scenario.md",
+        "commands/validate.md",
+        "commands/utils-verify.md",
+        "agents/scenario-runner.md",
+        "agents/a11y-auditor.md",
+        "skills/agent-browser/SKILL.md"
+      ],
+      "docsUrl": "https://github.com/anthropics/agent-browser"
+    },
+    {
+      "id": "agent-device",
+      "type": "cli",
+      "hardness": "soft",
+      "check": {
+        "command": "agent-device --version",
+        "expectExit": 0
+      },
+      "install": {
+        "preferred": "Requires Xcode + Android SDK. See agent-device docs."
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "/flow:scenario skips native (iOS/Android) variants. Web variants still run via agent-browser.",
+      "usedBy": [
+        "commands/scenario.md",
+        "agents/scenario-runner.md",
+        "skills/agent-device/SKILL.md"
+      ],
+      "docsUrl": "https://github.com/anthropics/agent-device"
+    },
+    {
+      "id": "jq",
+      "type": "system-tool",
+      "hardness": "soft",
+      "check": {
+        "command": "jq --version",
+        "expectExit": 0
+      },
+      "install": {
+        "darwin": "brew install jq",
+        "linux": "apt-get install -y jq || dnf install -y jq",
+        "win32": "winget install jqlang.jq"
+      },
+      "autoInstall": false,
+      "fallbackBehavior": "Slash commands' bash blocks that read .ai/workflows.config.json via jq cannot run. /flow:validate and /flow:utils-verify quality gates need this.",
+      "usedBy": [
+        "commands/validate.md",
+        "commands/utils-verify.md",
+        "commands/quick.md",
+        "commands/done.md"
+      ]
+    },
+    {
+      "id": "askuserquestion-mcp",
+      "type": "mcp",
+      "hardness": "soft",
+      "check": {
+        "mcp": "AskUserQuestion",
+        "tool": "ask"
+      },
+      "fallbackBehavior": "Question prompts fall back to numbered-prose chat. No multi-select UI.",
+      "usedBy": ["skills/question-protocol/SKILL.md"]
+    },
+    {
+      "id": "terminal-skills-mcp",
+      "type": "mcp",
+      "hardness": "soft",
+      "check": {
+        "mcp": "terminal-skills",
+        "tool": "search_skills"
+      },
+      "fallbackBehavior": "skill-loader falls back to built-in plugin skills → matching agents → WebFetch on library docs.",
+      "usedBy": ["skills/skill-loader/SKILL.md"]
+    }
+  ]
+}

package/plugins/flow/dependencies.schema.json ADDED Viewed

@@ -0,0 +1,107 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "maude plugin — runtime dependency manifest",
+  "description": "Declares CLI binaries, MCP servers, and runtime packages the plugin's commands / agents / skills shell out to. Consumed by maude doctor (cli/commands/doctor.mjs) and preflight.sh / preflight.mjs. Schema is shared between plugins — each plugin ships its own dependencies.json + (symlink to) this schema.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["version", "plugin", "dependencies"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "const": "1",
+      "description": "Manifest schema version. Bumped when the dependency entry shape changes incompatibly."
+    },
+    "plugin": {
+      "type": "string",
+      "minLength": 1,
+      "description": "Plugin name (matches plugins/<plugin>/.claude-plugin/plugin.json `name`)."
+    },
+    "dependencies": {
+      "type": "array",
+      "minItems": 0,
+      "items": { "$ref": "#/$defs/Dependency" }
+    }
+  },
+  "$defs": {
+    "Dependency": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "type", "hardness", "check"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9._-]*$",
+          "description": "Unique identifier within the manifest. Lowercase, hyphenated."
+        },
+        "type": {
+          "type": "string",
+          "enum": ["cli", "mcp", "node-package", "bun-package", "system-tool"],
+          "description": "What kind of dependency. `cli` = on PATH; `mcp` = MCP server / tool; `node-package` / `bun-package` = installed via npm/bun; `system-tool` = OS-provided (curl, jq)."
+        },
+        "hardness": {
+          "type": "string",
+          "enum": ["hard", "soft"],
+          "description": "`hard` = missing blocks plugin use; `soft` = graceful degradation possible (fallback path, warning only)."
+        },
+        "check": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "How to detect presence. For CLI/system-tool/package: shell command + expected exit. For MCP: tool name to probe.",
+          "properties": {
+            "command": {
+              "type": "string",
+              "description": "Shell command executed via `bash -c`. Pipes allowed. Defaults to `<id> --version`."
+            },
+            "expectExit": {
+              "type": "integer",
+              "default": 0,
+              "description": "Expected exit code. Anything else = missing/broken."
+            },
+            "minVersion": {
+              "type": "string",
+              "description": "Minimum semver. Comparator extracts `vX.Y.Z` from check.command stdout."
+            },
+            "mcp": {
+              "type": "string",
+              "description": "MCP server name. For type=mcp only."
+            },
+            "tool": {
+              "type": "string",
+              "description": "Specific tool name on the MCP server. For type=mcp only."
+            }
+          }
+        },
+        "install": {
+          "type": "object",
+          "additionalProperties": false,
+          "description": "Install commands per platform. `preferred` is OS-agnostic / fallback; per-platform keys override.",
+          "properties": {
+            "preferred": { "type": "string" },
+            "darwin": { "type": "string" },
+            "linux": { "type": "string" },
+            "win32": { "type": "string" }
+          }
+        },
+        "autoInstall": {
+          "type": "boolean",
+          "default": false,
+          "description": "If true, `maude doctor --fix` may run install.preferred after per-dep confirmation prompt."
+        },
+        "fallbackBehavior": {
+          "type": "string",
+          "description": "What the plugin does when this soft dep is missing. Human-readable; surfaces in maude doctor's report."
+        },
+        "usedBy": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Repo-relative paths (or path globs) of plugin files that reference this dependency. Aids debugging — doctor surfaces this when explaining a miss."
+        },
+        "docsUrl": {
+          "type": "string",
+          "format": "uri",
+          "description": "Where to read more."
+        }
+      }
+    }
+  }
+}

/package/plugins/design/templates/design-system-inspiration/core/preview/{motion.html → .archive/motion.html} RENAMED Viewed

File without changes