@ai-matrx/alchemy 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.1.3 — 2026-09-12
+
+Refreshes the distribution with the compact Alchemy format palette, its
+distinct action glyphs, native popover activation, and the design-system
+0.18.10 table and narrow-viewport Select corrections.
+
+### Consumer action
+
+Update to 0.1.3. No host configuration changes are required.
+
+## 0.1.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/alchemy/v0.1.1..npm/alchemy/v0.1.2 -- apps/shared/alchemy`).
+No source changes intended and no consumer action required.
+
 ## 0.1.1 — 2026-09-12
 
 Proves the package's npm trusted-publisher path with the canonical GitHub Actions release workflow. Runtime behavior is unchanged from 0.1.0.

package/README.md

@@ -1,6 +1,6 @@
 # @ai-matrx/alchemy
 
-Alchemy is Matrx’s content-to-AI toolkit. **Alchemy Menu** is its small, reusable copy, preparation and export control. This distribution ships the canonical core, React controls, Matrx service adapter, CSS and SVG; it contains no parallel implementation.
+Alchemy is Matrx’s content-to-AI toolkit. **Alchemy Menu** is its small, reusable copy, preparation and export control. This distribution ships the shared core, React controls, Matrx service adapter, CSS and SVG; it contains no parallel implementation.
 
 ## One menu, ready to use
 
@@ -28,11 +28,23 @@ The transparent icon opens ordinary copy, Markdown, formatted HTML with plain-te
 
 Preparation supports editable drafts, detail presets, structural reductions, omissions and undo. Supplying table rows adds relevant spreadsheet formats; registered exporters and page actions retain the same captured-source boundary. An absent AI provider leaves manual preparation available without showing dead AI controls.
 
+## Extend the shared menu
+
+The Copy/Download selector uses one format palette. Additional formats use the same tiles; quick copy, preparation, alternate context, and page operations use shared groups. Supply capabilities and descriptors rather than rendering another menu.
+
+- Use `human`, `json`, and `agent` getters for different representations of the same content.
+- Use `export.sheetRows` and `export.sheetColumns` for a table; spreadsheet formats become available automatically.
+- Use `export.items[].build` for a custom file's bytes, MIME type, extension, and optional filename. It appears in Download. An `onSelect` callback takes precedence over `build` and remains a page action.
+- Use `aiVariants` for alternate sources, `aiCustom` for source settings, and `groomer` for per-section detail. They enter the same preparation workspace.
+- Use the lower-level `ContentTransferMenu` and its capability provider for format adapters and projected page actions. `sourceFormats={false}` suppresses source formats in a file/action-only control; an action's `placement: "download"` places a genuine download in the palette.
+
+Labels and hints wrap within the shared geometry. Preserve stable IDs, eligibility checks, capture boundaries, and honest outcomes. Do not add per-page Copy/Download lists, bypass the shared transport, or restyle the menu for a particular integration.
+
 ## Integrate Matrx services once
 
 `MatrxContentTransferProvider` from `@ai-matrx/alchemy/matrx/react` accepts the canonical transport, authenticated database read port, current organization getter and source application. It supplies the declared durable AI preparation job to descendant menus. The host supplies identity and its existing live-run renderer; the package owns preparation, cancellation, exact request recovery and provenance. Mount the provider at an identity boundary so changing user or organization cannot reuse another identity’s prepared run.
 
-For an exact mounted declared surface, use `createSurfaceTransferHandle` from `/core` and `ContentTransferSurfaceProvider` from `/react`. Bind its scope getter and mounted predicate to that instance. Never look up a same-named surface globally. Standard Matrx table row and toolbar adoption is being completed alongside initial publication. Custom tables can use the lower-level `ContentTransferMenu` source/table contract.
+For an exact mounted declared surface, use `createSurfaceTransferHandle` from `/core` and `ContentTransferSurfaceProvider` from `/react`. Bind its scope getter and mounted predicate to that instance. Never look up a same-named surface globally. Standard Matrx tables include shared row and toolbar controls by default; `copy={false}` opts out. Custom tables can use the lower-level `ContentTransferMenu` source/table contract.
 
 ## Framework-neutral use
 
@@ -55,4 +67,4 @@ const artifact = serialize(createDraft(snapshot), "plain");
 | `/styles.css` | Self-contained menu and workspace styling. |
 | `/alchemy.svg` | The standalone glyph asset. |
 
-Initial publication is pending. Its registry installation canary requires the sibling kit, design-system and agents releases first.
+The registry installation canary requires the sibling kit, design-system and agents releases first. Each distribution release copies the canonical design-system stylesheet and SVG at build time.

package/dist/styles.css

@@ -36,6 +36,43 @@
   min-width: 18rem;
   max-width: min(24rem, calc(100vw - 2rem));
 }
+.matrx-alchemy-palette {
+  width: min(18rem, calc(100vw - 2rem));
+  min-width: 0;
+  padding: 0.4375rem;
+  max-height: var(--radix-popover-content-available-height, 80dvh);
+}
+.matrx-alchemy-mode {
+  display: flex;
+  gap: 0.1875rem;
+  margin-bottom: 0.375rem;
+  padding: 0.1875rem;
+  border-radius: 0.5rem;
+  background: hsl(var(--muted, 240 5% 96%));
+}
+.matrx-alchemy-mode button {
+  flex: 1;
+  min-height: 2rem;
+  border: 0;
+  border-radius: 0.3125rem;
+  background: transparent;
+  color: inherit;
+  font: inherit;
+  font-size: 0.8125rem;
+  cursor: pointer;
+}
+.matrx-alchemy-mode button[aria-pressed="true"] { background: hsl(var(--background, 0 0% 100%)); box-shadow: 0 1px 2px hsl(var(--foreground, 240 10% 4%) / 0.12); }
+.matrx-alchemy-palette-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 0.1875rem; }
+.matrx-alchemy-palette-tile { display: grid; place-items: center; gap: 0.375rem; min-width: 0; min-height: 4.25rem; padding: 0.5rem 0.25rem; border: 0; border-radius: 0.375rem; background: transparent; color: inherit; font: inherit; font-size: 0.75rem; line-height: 1.2; text-align: center; overflow-wrap: anywhere; cursor: pointer; }
+.matrx-alchemy-palette-glyph { width: 1.125rem; height: 1.125rem; color: hsl(var(--muted-foreground, 240 4% 46%)); flex: 0 0 auto; }
+.matrx-alchemy-palette-section { display: grid; gap: 0.125rem; margin-top: 0.375rem; padding-top: 0.375rem; border-top: 1px solid hsl(var(--border, 240 6% 90%)); }
+.matrx-alchemy-palette-section h3 { margin: 0.125rem 0.375rem; color: hsl(var(--muted-foreground, 240 4% 46%)); font-size: 0.6875rem; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; }
+.matrx-alchemy-palette-row { display: flex; align-items: center; gap: 0.5rem; width: 100%; min-height: 2rem; padding: 0.375rem 0.5rem; border: 0; border-radius: 0.3125rem; background: transparent; color: inherit; font: inherit; font-size: 0.8125rem; line-height: 1.25; text-align: left; overflow-wrap: anywhere; cursor: pointer; }
+.matrx-alchemy-palette-row > span { min-width: 0; }
+.matrx-alchemy-palette-row-ai { color: hsl(var(--primary, 262 43% 51%)); }
+.matrx-alchemy-palette :is(button:hover, button:focus-visible) { background: hsl(var(--accent, 240 5% 96%)); outline: none; }
+.matrx-alchemy-palette :is(button:focus-visible) { box-shadow: 0 0 0 2px hsl(var(--ring, 240 5% 65%)); }
+.matrx-alchemy-palette-status { margin: 0.25rem 0.375rem; color: hsl(var(--muted-foreground, 240 4% 46%)); font-size: 0.75rem; }
 .matrx-alchemy-notice,
 .matrx-alchemy-meta {
   font-size: 0.75rem;
@@ -237,39 +274,15 @@
 }
 .matrx-alchemy-menu {
   z-index: 10001;
-  padding: 0.25rem;
-  max-height: var(--radix-dropdown-menu-content-available-height, 80dvh);
+  padding: 0.4375rem;
+  max-height: var(--radix-popover-content-available-height, 80dvh);
   overflow: auto;
   overscroll-behavior: contain;
+  border-radius: 0.75rem;
 }
-.matrx-alchemy-menu [role="menuitem"] {
-  display: flex;
-  align-items: center;
-  gap: 0.5rem;
-  min-height: 2rem;
-  padding: 0.375rem 0.5rem;
-  border-radius: 0.25rem;
-  font-size: 0.875rem;
-  cursor: default;
-  outline: none;
-  user-select: none;
-}
-.matrx-alchemy-menu [role="menuitem"][data-highlighted] {
-  background: hsl(var(--accent, 240 5% 96%));
-}
-.matrx-alchemy-menu [data-disabled] {
-  opacity: 0.5;
-  pointer-events: none;
-}
-.matrx-alchemy-menu [data-slot="dropdown-menu-label"] {
-  padding: 0.375rem 0.5rem;
-  font-size: 0.75rem;
-  font-weight: 600;
-}
-.matrx-alchemy-menu [role="separator"] {
-  height: 1px;
-  margin: 0.25rem 0;
-  background: hsl(var(--border, 240 6% 90%));
+@media (pointer: coarse) {
+  .matrx-alchemy-palette :is(.matrx-alchemy-mode button, .matrx-alchemy-palette-row) { min-height: 2.75rem; }
+  .matrx-alchemy-palette-tile { min-height: 4.5rem; }
 }
 .matrx-alchemy-workspace {
   position: fixed;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/alchemy",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Matrx Alchemy: the complete Matrx copy, prepare-for-AI, and export experience, with framework-neutral core, React menu, glyph, styles and Matrx integration.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -124,8 +124,8 @@
     "*.css"
   ],
   "dependencies": {
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/kit": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/agents": "latest"
   },
   "scripts": {