@mhmo91/schmancy 0.10.3 → 0.10.5

package/README.md

@@ -11,31 +11,24 @@ registered. No bundler, no bare specifiers, no npm install.
 
 ```html
 <script type="module">
-  import { theme, state, area } from 'https://esm.sh/@mhmo91/schmancy/agent';
+  import 'https://esm.sh/@mhmo91/schmancy/agent';
 </script>
 <schmancy-theme root scheme="dark">
   <schmancy-surface type="solid" fill="all">
     <schmancy-button>Hi</schmancy-button>
-    <schmancy-skill></schmancy-skill>
   </schmancy-surface>
 </schmancy-theme>
 ```
 
-The `<schmancy-skill>` tag installs `window.schmancy` for runtime discovery:
+The same entry re-exports the full library surface for in-page script
+code (`theme`, `area`, `state`, `show`, `lazy`, every directive, every
+service, `SchmancyElement`). Import from the same URL.
 
-- `window.schmancy.help()` — full manifest (CEM v1 shape).
-- `window.schmancy.help('schmancy-button')` — one tag's attributes, events, slots, CSS parts.
-- `window.schmancy.tokens()` — build-time-extracted list of `--schmancy-*` theme tokens.
-- `window.schmancy.registeredTags()` — every `<schmancy-*>` tag the bundle registered, sorted.
-- `window.schmancy.manifestUrl` — Blob URL; `fetch()` it for the same data.
-- `window.schmancy.a11yAudit()` — walks the live DOM and reports ARIA / shadow-root / form-association status per instance.
-- `window.schmancy.platformPrimitive('schmancy-dialog')` — map to the native element a component wraps (present when the component's JSDoc has `@platform`).
-- `window.schmancy.capabilities()` — runtime feature probe (`popover`, `declarativeShadowDom`, `scopedRegistries`, `trustedTypes`, `cssRegisteredProperties`, `elementInternalsAria`, `formAssociated`, `adoptedStyleSheets`). Agents use this to adapt to the sandbox they're in rather than the one they expect.
-
-Every enum-typed attribute carries a `values` array — e.g. `schmancy-button`'s `variant` ships `["elevated", "filled", "filled tonal", "tonal", "outlined", "text"]` so agents never have to parse `"'filled' | 'tonal' | ..."` strings.
-
-The manifest is also emitted as a sibling file at `@mhmo91/schmancy/agent/manifest`
-for tooling that prefers reading JSON from disk.
+For introspection — every tag's attributes, events, slots, CSS parts,
+plus the enum `values` array on every typed attribute (so agents don't
+have to parse `"'filled' | 'tonal' | ..."` strings) — read the static
+manifest at `@mhmo91/schmancy/agent/manifest`. It's a JSON file, shape
+follows Custom Elements Manifest v1.
 
 ## Install
 
@@ -50,13 +43,21 @@ import { magnetic, cursorGlow, gravity } from '@mhmo91/schmancy/directives'
 
 ## Use with Claude Code
 
-Schmancy ships a Claude Code plugin. In any Claude Code session, run:
+Schmancy ships a Claude Code plugin (manifest at `.claude-plugin/plugin.json`,
+skill source under `skills/schmancy/`). The npm tarball includes both, so
+after `npm install @mhmo91/schmancy`, point Claude at the package directory
+when launching:
 
 ```
-/plugin install https://github.com/samwaai/schmancy
+claude --plugin-dir node_modules/@mhmo91/schmancy
 ```
 
-Claude now knows every Schmancy component, foundation pattern, and convention in your project. The skill activates automatically when you work on schmancy code — no CLAUDE.md edits, no symlinks.
+Set a shell alias / `.envrc` so every session in the project picks it up.
+After editing plugin files, run `/reload-plugins` inside the session.
+
+Claude now knows every Schmancy component, foundation pattern, and
+convention; the skill activates automatically when you work on schmancy
+code — no CLAUDE.md edits, no symlinks.
 
 ## Quick Start
 

package/custom-elements.json

@@ -1,19 +1,6 @@
 {
   "version": "experimental",
   "tags": [
-    {
-      "name": "schmancy-skill",
-      "path": "./src/agent/schmancy-skill.ts",
-      "description": "Self-describing runtime helper. Drop `<schmancy-skill></schmancy-skill>`\nonce on a page and `window.schmancy.help('schmancy-button')` returns the\nmachine-readable entry for any tag. Renders nothing.",
-      "properties": [
-        {
-          "name": "disconnectedSignal",
-          "description": "AbortSignal that fires when the element disconnects.",
-          "type": "AbortSignal",
-          "default": "\"signal\""
-        }
-      ]
-    },
     {
       "name": "schmancy-area",
       "path": "./src/area/area.component.ts",
@@ -2723,6 +2710,9 @@
       "events": [
         {
           "name": "ContentDrawerResize"
+        },
+        {
+          "name": "schmancy-content-drawer-overlay-dismiss"
         }
       ]
     },
@@ -3301,150 +3291,6 @@
         }
       ]
     },
-    {
-      "name": "schmancy-dialog",
-      "path": "./src/dialog/dialog.component.ts",
-      "description": "Unified dialog component that handles both content-only and confirm modes.",
-      "attributes": [
-        {
-          "name": "uid",
-          "description": "Unique identifier for the dialog instance",
-          "type": "string"
-        },
-        {
-          "name": "title",
-          "description": "Dialog title (enables confirm mode when set)",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "subtitle",
-          "description": "Dialog subtitle",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "message",
-          "description": "Dialog message",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "confirm-text",
-          "description": "Text for confirm button (enables confirm mode when set with cancelText)",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "cancel-text",
-          "description": "Text for cancel button",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "variant",
-          "description": "Dialog variant (affects button colors in confirm mode)",
-          "type": "\"default\" | \"danger\"",
-          "default": "\"default\""
-        },
-        {
-          "name": "hide-actions",
-          "description": "Whether to hide action buttons (force content mode)",
-          "type": "boolean",
-          "default": "false"
-        }
-      ],
-      "properties": [
-        {
-          "name": "uid",
-          "attribute": "uid",
-          "description": "Unique identifier for the dialog instance",
-          "type": "string"
-        },
-        {
-          "name": "title",
-          "attribute": "title",
-          "description": "Dialog title (enables confirm mode when set)",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "subtitle",
-          "attribute": "subtitle",
-          "description": "Dialog subtitle",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "message",
-          "attribute": "message",
-          "description": "Dialog message",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "confirmText",
-          "attribute": "confirm-text",
-          "description": "Text for confirm button (enables confirm mode when set with cancelText)",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "cancelText",
-          "attribute": "cancel-text",
-          "description": "Text for cancel button",
-          "type": "string | undefined",
-          "default": "\"undefined\""
-        },
-        {
-          "name": "variant",
-          "attribute": "variant",
-          "description": "Dialog variant (affects button colors in confirm mode)",
-          "type": "\"default\" | \"danger\"",
-          "default": "\"default\""
-        },
-        {
-          "name": "hideActions",
-          "attribute": "hide-actions",
-          "description": "Whether to hide action buttons (force content mode)",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "position",
-          "type": "DialogPosition",
-          "default": "{\"x\":0,\"y\":0}"
-        },
-        {
-          "name": "isMobile",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "dragOffset",
-          "type": "number",
-          "default": "0"
-        }
-      ],
-      "events": [
-        {
-          "name": "yes-dialog-here"
-        },
-        {
-          "name": "confirm"
-        }
-      ],
-      "slots": [
-        {
-          "name": "default",
-          "description": "Content slot for dialog body (used in content mode)"
-        },
-        {
-          "name": "content",
-          "description": "Named slot for custom content in confirm mode"
-        }
-      ]
-    },
     {
       "name": "schmancy-divider",
       "path": "./src/divider/divider.ts",
@@ -5462,6 +5308,9 @@
       "events": [
         {
           "name": "editor-change"
+        },
+        {
+          "name": "close"
         }
       ]
     },
@@ -5635,7 +5484,7 @@
     {
       "name": "schmancy-email-template-picker",
       "path": "./src/mailbox/email-template-picker.ts",
-      "description": "Email template picker content component (for use inside sheets)\n\nFeatures:\n- Grid layout for template preview\n- Search/filter templates\n- Category filtering\n- Inline preview with direct selection\n- Single-click template selection",
+      "description": "Email template picker content component (designed to be opened via `show()`).\n\nFeatures:\n- Grid layout for template preview\n- Search/filter templates\n- Category filtering\n- Inline preview with direct selection\n- Single-click template selection",
       "attributes": [
         {
           "name": "templates",
@@ -5666,6 +5515,9 @@
       "events": [
         {
           "name": "template-selected"
+        },
+        {
+          "name": "close"
         }
       ]
     },
@@ -6077,12 +5929,17 @@
           "type": "CSSResult[]",
           "default": "[null]"
         }
+      ],
+      "events": [
+        {
+          "name": "close"
+        }
       ]
     },
     {
       "name": "schmancy-menu",
       "path": "./src/menu/menu.ts",
-      "description": "Menu Component\n\nCRITICAL: The dialog ONLY renders the raw menu items passed via the default slot.\nNO <ul> wrapper, NO classes, NO additional markup in the dialog call.\nThe dialog service handles positioning and display - we just pass the pure content.",
+      "description": "Menu Component\n\nThe overlay renders ONLY the raw menu items passed via the default slot.\nNO <ul> wrapper, NO classes, NO additional markup. The overlay system\nhandles positioning (anchored at the trigger click) and dismissal.",
       "properties": [
         {
           "name": "styles",
@@ -6101,7 +5958,7 @@
         },
         {
           "name": "default",
-          "description": "Menu items or any custom component to display in dialog"
+          "description": "Menu items or any custom component to display in the overlay"
         }
       ]
     },
@@ -8029,79 +7886,6 @@
         }
       ]
     },
-    {
-      "name": "schmancy-sheet",
-      "path": "./src/sheet/sheet.ts",
-      "attributes": [
-        {
-          "name": "open",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "position",
-          "type": "SchmancySheetPosition",
-          "default": "\"side\""
-        },
-        {
-          "name": "persist",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "lock",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "handleHistory",
-          "type": "boolean",
-          "default": "true"
-        }
-      ],
-      "properties": [
-        {
-          "name": "styles",
-          "type": "CSSResult[]",
-          "default": "[null]"
-        },
-        {
-          "name": "open",
-          "attribute": "open",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "position",
-          "attribute": "position",
-          "type": "SchmancySheetPosition",
-          "default": "\"side\""
-        },
-        {
-          "name": "persist",
-          "attribute": "persist",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "lock",
-          "attribute": "lock",
-          "type": "boolean",
-          "default": "false"
-        },
-        {
-          "name": "handleHistory",
-          "attribute": "handleHistory",
-          "type": "boolean",
-          "default": "true"
-        }
-      ],
-      "events": [
-        {
-          "name": "close"
-        }
-      ]
-    },
     {
       "name": "schmancy-skeleton",
       "path": "./src/skeleton/skeleton.ts",