@ai-matrx/alchemy 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0 — Unreleased
+
+Initial `@ai-matrx/alchemy` distribution package. It exports the existing kit core, design-system React surface and assets, and agents Matrx adapter without duplicating their behavior.
+
+### Consumer action
+
+Wait for the initial npm publish and the required sibling package releases. Then install `@ai-matrx/alchemy` and replace multiple Alchemy package imports with the matching distribution subpath.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Matrix Engine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @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.
+
+## One menu, ready to use
+
+```tsx
+import { AlchemyMenu } from "@ai-matrx/alchemy/react";
+import "@ai-matrx/alchemy/styles.css";
+
+export function TaskActions({ task }: { task: { id: string; title: string; description: string } }) {
+  return <AlchemyMenu
+    sourceId={`task:${task.id}`}
+    label={task.title}
+    human={() => task.description}
+    json={() => task}
+    agent={() => ({
+      kind: "task",
+      location: "Task detail",
+      description: "Current task, including unsaved changes",
+      data: task,
+    })}
+  />;
+}
+```
+
+The transparent icon opens ordinary copy, Markdown, formatted HTML with plain-text fallback, JSON, direct AI context, preparation, and downloads. No chevron, icon library or Tailwind build is required. Semantic HSL tokens inherit the host’s Matrx theme; neutral defaults work without one. Set `sourceId` from the record identity when a mounted control can switch records. Lazy getters run when content is captured.
+
+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.
+
+## 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.
+
+## Framework-neutral use
+
+```ts
+import { capture, createDraft, serialize } from "@ai-matrx/alchemy/core";
+
+const { snapshot } = await capture(
+  { kind: "text", text: "Hello" },
+  new AbortController().signal,
+);
+const artifact = serialize(createDraft(snapshot), "plain");
+```
+
+| Entry | Exports |
+|---|---|
+| `/core` (also package root) | Capture, projection, preparation, serializers, artifacts and transport. |
+| `/react` | `AlchemyMenu`, lower-level `ContentTransferMenu`, surface/provider bindings and React glyph. |
+| `/matrx` | Durable Matrx AI preparation adapter. |
+| `/matrx/react` | React bindings for that adapter. |
+| `/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.

package/dist/alchemy.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round"><path d="M4.5 5.5h8v11h-8z"/><path d="M8.5 9.5h8v9h-8z"/><path d="m18.5 3 .65 1.85L21 5.5l-1.85.65L18.5 8l-.65-1.85L16 5.5l1.85-.65z"/></svg>

package/dist/core.cjs

@@ -0,0 +1,21 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/core.ts
+var core_exports = {};
+module.exports = __toCommonJS(core_exports);
+__reExport(core_exports, require("@ai-matrx/kit/content-transfer"), module.exports);
+//# sourceMappingURL=core.cjs.map

package/dist/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["export * from \"@ai-matrx/kit/content-transfer\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,yBAAc,2CAAd;","names":[]}

package/dist/core.d.cts

@@ -0,0 +1 @@
+export * from '@ai-matrx/kit/content-transfer';

package/dist/core.d.ts

@@ -0,0 +1 @@
+export * from '@ai-matrx/kit/content-transfer';

package/dist/core.js

@@ -0,0 +1,3 @@
+// src/core.ts
+export * from "@ai-matrx/kit/content-transfer";
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["export * from \"@ai-matrx/kit/content-transfer\";\n"],"mappings":";AAAA,cAAc;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,21 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+module.exports = __toCommonJS(src_exports);
+__reExport(src_exports, require("@ai-matrx/kit/content-transfer"), module.exports);
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"@ai-matrx/kit/content-transfer\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wBAAc,2CAAd;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1 @@
+export * from '@ai-matrx/kit/content-transfer';

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from '@ai-matrx/kit/content-transfer';

package/dist/index.js

@@ -0,0 +1,3 @@
+// src/index.ts
+export * from "@ai-matrx/kit/content-transfer";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"@ai-matrx/kit/content-transfer\";\n"],"mappings":";AAAA,cAAc;","names":[]}

package/dist/matrx-react.cjs

@@ -0,0 +1,23 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/matrx-react.ts
+var matrx_react_exports = {};
+module.exports = __toCommonJS(matrx_react_exports);
+__reExport(matrx_react_exports, require("@ai-matrx/agents/content-transfer/react"), module.exports);
+//# sourceMappingURL=matrx-react.cjs.map

package/dist/matrx-react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/matrx-react.ts"],"sourcesContent":["\"use client\";\n\nexport * from \"@ai-matrx/agents/content-transfer/react\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,gCAAc,oDAFd;","names":[]}

package/dist/matrx-react.d.cts

@@ -0,0 +1 @@
+export * from '@ai-matrx/agents/content-transfer/react';

package/dist/matrx-react.d.ts

@@ -0,0 +1 @@
+export * from '@ai-matrx/agents/content-transfer/react';

package/dist/matrx-react.js

@@ -0,0 +1,6 @@
+"use client";
+"use client";
+
+// src/matrx-react.ts
+export * from "@ai-matrx/agents/content-transfer/react";
+//# sourceMappingURL=matrx-react.js.map

package/dist/matrx-react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/matrx-react.ts"],"sourcesContent":["\"use client\";\n\nexport * from \"@ai-matrx/agents/content-transfer/react\";\n"],"mappings":";;;;AAEA,cAAc;","names":[]}

package/dist/matrx.cjs

@@ -0,0 +1,21 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/matrx.ts
+var matrx_exports = {};
+module.exports = __toCommonJS(matrx_exports);
+__reExport(matrx_exports, require("@ai-matrx/agents/content-transfer"), module.exports);
+//# sourceMappingURL=matrx.cjs.map

package/dist/matrx.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/matrx.ts"],"sourcesContent":["export * from \"@ai-matrx/agents/content-transfer\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,8CAAd;","names":[]}

package/dist/matrx.d.cts

@@ -0,0 +1 @@
+export * from '@ai-matrx/agents/content-transfer';

package/dist/matrx.d.ts

@@ -0,0 +1 @@
+export * from '@ai-matrx/agents/content-transfer';

package/dist/matrx.js

@@ -0,0 +1,3 @@
+// src/matrx.ts
+export * from "@ai-matrx/agents/content-transfer";
+//# sourceMappingURL=matrx.js.map

package/dist/matrx.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/matrx.ts"],"sourcesContent":["export * from \"@ai-matrx/agents/content-transfer\";\n"],"mappings":";AAAA,cAAc;","names":[]}

package/dist/react.cjs

@@ -0,0 +1,31 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react.ts
+var react_exports = {};
+__export(react_exports, {
+  AlchemyMenu: () => import_content_transfer.MatrxCopyMenu
+});
+module.exports = __toCommonJS(react_exports);
+__reExport(react_exports, require("@ai-matrx/design-system/content-transfer"), module.exports);
+var import_content_transfer = require("@ai-matrx/design-system/content-transfer");
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["\"use client\";\n\nexport * from \"@ai-matrx/design-system/content-transfer\";\n\n/** The Matrx-opinionated control, named for the Alchemy toolkit. */\nexport { MatrxCopyMenu as AlchemyMenu } from \"@ai-matrx/design-system/content-transfer\";\nexport type { MatrxCopyMenuProps as AlchemyMenuProps } from \"@ai-matrx/design-system/content-transfer\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,0BAAc,qDAFd;AAKA,8BAA6C;","names":[]}

package/dist/react.d.cts

@@ -0,0 +1,2 @@
+export * from '@ai-matrx/design-system/content-transfer';
+export { MatrxCopyMenu as AlchemyMenu, MatrxCopyMenuProps as AlchemyMenuProps } from '@ai-matrx/design-system/content-transfer';

package/dist/react.d.ts

@@ -0,0 +1,2 @@
+export * from '@ai-matrx/design-system/content-transfer';
+export { MatrxCopyMenu as AlchemyMenu, MatrxCopyMenuProps as AlchemyMenuProps } from '@ai-matrx/design-system/content-transfer';

package/dist/react.js

@@ -0,0 +1,10 @@
+"use client";
+"use client";
+
+// src/react.ts
+export * from "@ai-matrx/design-system/content-transfer";
+import { MatrxCopyMenu } from "@ai-matrx/design-system/content-transfer";
+export {
+  MatrxCopyMenu as AlchemyMenu
+};
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.ts"],"sourcesContent":["\"use client\";\n\nexport * from \"@ai-matrx/design-system/content-transfer\";\n\n/** The Matrx-opinionated control, named for the Alchemy toolkit. */\nexport { MatrxCopyMenu as AlchemyMenu } from \"@ai-matrx/design-system/content-transfer\";\nexport type { MatrxCopyMenuProps as AlchemyMenuProps } from \"@ai-matrx/design-system/content-transfer\";\n"],"mappings":";;;;AAEA,cAAc;AAGd,SAA0B,qBAAmB;","names":[]}

package/dist/styles.css

@@ -0,0 +1,382 @@
+/* Structural Alchemy rules. Hosts own token values; Tailwind is never required. */
+.matrx-alchemy {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.375rem;
+}
+.matrx-alchemy-trigger {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 2rem;
+  height: 2rem;
+  padding: 0.375rem;
+  border: 0;
+  border-radius: 0.375rem;
+  background: transparent;
+  color: hsl(var(--foreground, 240 10% 4%));
+  cursor: pointer;
+}
+.matrx-alchemy-trigger svg {
+  width: 1.125rem;
+  height: 1.125rem;
+}
+.matrx-alchemy-trigger:hover {
+  background: hsl(var(--accent, 240 5% 96%));
+}
+.matrx-alchemy-trigger:focus-visible {
+  outline: 2px solid hsl(var(--ring, 240 5% 65%));
+  outline-offset: 2px;
+}
+.matrx-alchemy-trigger:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+.matrx-alchemy-menu {
+  min-width: 18rem;
+  max-width: min(24rem, calc(100vw - 2rem));
+}
+.matrx-alchemy-notice,
+.matrx-alchemy-meta {
+  font-size: 0.75rem;
+  color: hsl(var(--muted-foreground, 240 4% 46%));
+}
+.matrx-alchemy-workspace {
+  max-height: min(90dvh, 56rem);
+  overflow: auto;
+}
+.matrx-alchemy-workspace-grid {
+  display: grid;
+  grid-template-columns: minmax(0, 2fr) minmax(14rem, 1fr);
+  gap: 1rem;
+  min-height: 0;
+}
+.matrx-alchemy-main {
+  display: grid;
+  gap: 0.75rem;
+  min-width: 0;
+}
+.matrx-alchemy-toolbar {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.5rem;
+  align-items: end;
+}
+.matrx-alchemy-toolbar label,
+.matrx-alchemy-preview-label,
+.matrx-alchemy-workspace aside label,
+.matrx-alchemy-options label {
+  display: grid;
+  gap: 0.25rem;
+  font-size: 0.8125rem;
+}
+.matrx-alchemy-toolbar input,
+.matrx-alchemy-toolbar select,
+.matrx-alchemy-preview-label select,
+.matrx-alchemy-workspace aside textarea,
+.matrx-alchemy-options input {
+  min-height: 2.25rem;
+  border: 1px solid hsl(var(--border, 240 6% 90%));
+  border-radius: 0.25rem;
+  background: hsl(var(--background, 0 0% 100%));
+  color: inherit;
+  padding: 0.35rem 0.5rem;
+}
+.matrx-alchemy-options {
+  display: grid;
+  gap: 0.5rem;
+  max-height: 13rem;
+  overflow: auto;
+  border: 1px solid hsl(var(--border, 240 6% 90%));
+  border-radius: 0.375rem;
+  padding: 0.625rem;
+}
+.matrx-alchemy-options legend {
+  padding: 0 0.25rem;
+  font-size: 0.8125rem;
+  font-weight: 600;
+}
+.matrx-alchemy-column {
+  display: grid;
+  grid-template-columns: minmax(8rem, 1fr) minmax(8rem, 1fr);
+  gap: 0.5rem;
+  align-items: end;
+}
+.matrx-alchemy-row-list {
+  display: grid;
+  gap: 0.375rem;
+  max-height: 9rem;
+  overflow: auto;
+  padding: 0.25rem;
+}
+.matrx-alchemy-row-list label {
+  display: block;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.matrx-alchemy-coverage {
+  display: grid;
+  gap: 0.25rem;
+  font-size: 0.75rem;
+  color: hsl(var(--muted-foreground, 240 4% 46%));
+}
+.matrx-alchemy-coverage details {
+  max-height: 8rem;
+  overflow: auto;
+}
+.matrx-alchemy-coverage ul {
+  margin: 0.35rem 0 0;
+  padding-left: 1.25rem;
+}
+.matrx-alchemy-preview {
+  display: block;
+  width: 100%;
+  min-height: 20rem;
+  padding: 0.75rem;
+  border: 1px solid hsl(var(--border, 240 6% 90%));
+  border-radius: 0.375rem;
+  background: hsl(var(--muted, 240 5% 96%));
+  color: inherit;
+  font:
+    12px/1.45 ui-monospace,
+    SFMono-Regular,
+    Menlo,
+    monospace;
+  resize: vertical;
+}
+.matrx-alchemy-preview[aria-invalid="true"] {
+  border-color: hsl(var(--destructive, 0 84% 60%));
+}
+.matrx-alchemy-workspace aside {
+  display: grid;
+  align-content: start;
+  gap: 0.75rem;
+}
+.matrx-alchemy-workspace aside textarea {
+  min-height: 8rem;
+  resize: vertical;
+}
+.matrx-alchemy-decision {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.75rem;
+  border: 1px solid hsl(var(--border, 240 6% 90%));
+  border-radius: 0.375rem;
+  background: hsl(var(--muted, 240 5% 96%));
+}
+.matrx-alchemy-decision p {
+  flex: 1 1 16rem;
+  margin: 0;
+}
+.matrx-alchemy-error {
+  font-size: 0.8125rem;
+  color: hsl(var(--destructive, 0 84% 60%));
+}
+@media (max-width: 640px) {
+  .matrx-alchemy-workspace-grid {
+    grid-template-columns: 1fr;
+  }
+  .matrx-alchemy-preview {
+    min-height: 14rem;
+  }
+  .matrx-alchemy-column {
+    grid-template-columns: 1fr;
+  }
+}
+
+.matrx-alchemy-xs .matrx-alchemy-trigger {
+  width: 1.75rem;
+  height: 1.75rem;
+  padding: 0.375rem;
+}
+.matrx-alchemy-xs .matrx-alchemy-trigger svg {
+  width: 1rem;
+  height: 1rem;
+}
+.matrx-alchemy-sm .matrx-alchemy-trigger {
+  width: 2.25rem;
+  height: 2.25rem;
+}
+@media (pointer: coarse) {
+  .matrx-alchemy .matrx-alchemy-trigger {
+    width: 2.75rem;
+    height: 2.75rem;
+    padding: 0.625rem;
+  }
+  .matrx-alchemy-workspace input,
+  .matrx-alchemy-workspace select,
+  .matrx-alchemy-workspace textarea {
+    font-size: max(1rem, 1em);
+  }
+}
+
+.matrx-alchemy-menu-icon {
+  width: 1rem;
+  height: 1rem;
+  flex-shrink: 0;
+}
+.matrx-alchemy-menu-hint {
+  display: block;
+  color: hsl(var(--muted-foreground, 240 4% 46%));
+  font-size: 0.75rem;
+}
+
+/* Primitive chrome is scoped here so a plain React consumer needs no Tailwind build. */
+.matrx-alchemy-menu,
+.matrx-alchemy-workspace {
+  box-sizing: border-box;
+  font-family: inherit;
+  color: hsl(var(--foreground, 240 10% 4%));
+  background: hsl(var(--background, 0 0% 100%));
+  border: 1px solid hsl(var(--border, 240 6% 90%));
+  border-radius: 0.5rem;
+  box-shadow: 0 8px 28px hsl(var(--foreground, 240 10% 4%) / 0.12);
+}
+.matrx-alchemy-menu {
+  z-index: 10001;
+  padding: 0.25rem;
+  max-height: var(--radix-dropdown-menu-content-available-height, 80dvh);
+  overflow: auto;
+  overscroll-behavior: contain;
+}
+.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%));
+}
+.matrx-alchemy-workspace {
+  position: fixed;
+  z-index: 10001;
+  top: 50%;
+  left: 50%;
+  right: auto;
+  bottom: auto;
+  margin: 0;
+  translate: -50% -50%;
+  width: min(64rem, calc(100vw - 2rem));
+  max-width: calc(100vw - 2rem);
+  padding: 1.5rem;
+  display: grid;
+  gap: 1rem;
+}
+[data-slot="dialog-overlay"]:has(+ .matrx-alchemy-workspace) {
+  position: fixed;
+  inset: 0;
+  z-index: 10000;
+  background: hsl(var(--foreground, 240 10% 4%) / 0.18);
+}
+.matrx-alchemy-workspace [data-slot="dialog-header"] {
+  display: grid;
+  gap: 0.375rem;
+  padding-right: 2.25rem;
+}
+.matrx-alchemy-workspace [data-slot="dialog-title"] {
+  margin: 0;
+  font-size: 1.125rem;
+  font-weight: 600;
+}
+.matrx-alchemy-workspace [data-slot="dialog-description"] {
+  margin: 0;
+  font-size: 0.875rem;
+  color: hsl(var(--muted-foreground, 240 4% 46%));
+}
+.matrx-alchemy-workspace [data-slot="dialog-footer"] {
+  display: flex;
+  flex-wrap: wrap;
+  justify-content: flex-end;
+  gap: 0.5rem;
+  align-items: center;
+}
+.matrx-alchemy-workspace button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.375rem;
+  min-height: 2rem;
+  padding: 0.375rem 0.75rem;
+  border: 1px solid hsl(var(--border, 240 6% 90%));
+  border-radius: 0.375rem;
+  background: hsl(var(--background, 0 0% 100%));
+  color: inherit;
+  font: inherit;
+  font-size: 0.8125rem;
+  cursor: pointer;
+}
+.matrx-alchemy-workspace button:hover {
+  background: hsl(var(--accent, 240 5% 96%));
+}
+.matrx-alchemy-workspace button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+.matrx-alchemy-workspace button:focus-visible,
+.matrx-alchemy-workspace :is(input, textarea, select):focus-visible {
+  outline: 2px solid hsl(var(--ring, 240 5% 65%));
+  outline-offset: 2px;
+}
+.matrx-alchemy-workspace [data-slot="dialog-close"] {
+  position: absolute;
+  top: 0.5rem;
+  right: 0.5rem;
+  width: 2.5rem;
+  height: 2.5rem;
+  padding: 0.5rem;
+  border: 0;
+  background: transparent;
+}
+.matrx-alchemy-workspace [data-slot="dialog-close"] svg {
+  width: 1rem;
+  height: 1rem;
+}
+.matrx-alchemy-workspace [data-slot="dialog-close"] .sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+}
+@media (max-width: 767px) {
+  .matrx-alchemy-workspace {
+    top: auto;
+    bottom: 0;
+    left: 0;
+    translate: none;
+    width: 100%;
+    max-width: 100%;
+    max-height: 92dvh;
+    padding: 1rem 1rem max(1rem, env(safe-area-inset-bottom));
+    border-radius: 0.75rem 0.75rem 0 0;
+  }
+}
+
+.matrx-alchemy-menu *, .matrx-alchemy-workspace * { box-sizing: border-box; }
+.matrx-alchemy-workspace-grid:not(:has(aside)) { grid-template-columns: minmax(0, 1fr); }

package/package.json

@@ -0,0 +1,139 @@
+{
+  "name": "@ai-matrx/alchemy",
+  "version": "0.1.0",
+  "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",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "license": "MIT",
+  "keywords": [
+    "alchemy",
+    "clipboard",
+    "copy",
+    "export",
+    "markdown",
+    "json",
+    "react",
+    "ai-matrx"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AI-Matrix-Engine/aidream.git",
+    "directory": "apps/shared/alchemy"
+  },
+  "homepage": "https://github.com/AI-Matrix-Engine/aidream/tree/main/apps/shared/alchemy#readme",
+  "bugs": {
+    "url": "https://github.com/AI-Matrix-Engine/aidream/issues"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./core": {
+      "import": {
+        "types": "./dist/core.d.ts",
+        "default": "./dist/core.js"
+      },
+      "require": {
+        "types": "./dist/core.d.cts",
+        "default": "./dist/core.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      },
+      "require": {
+        "types": "./dist/react.d.cts",
+        "default": "./dist/react.cjs"
+      }
+    },
+    "./matrx": {
+      "import": {
+        "types": "./dist/matrx.d.ts",
+        "default": "./dist/matrx.js"
+      },
+      "require": {
+        "types": "./dist/matrx.d.cts",
+        "default": "./dist/matrx.cjs"
+      }
+    },
+    "./matrx/react": {
+      "import": {
+        "types": "./dist/matrx-react.d.ts",
+        "default": "./dist/matrx-react.js"
+      },
+      "require": {
+        "types": "./dist/matrx-react.d.cts",
+        "default": "./dist/matrx-react.cjs"
+      }
+    },
+    "./styles.css": "./dist/styles.css",
+    "./alchemy.svg": "./dist/alchemy.svg",
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "react-dom": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@arethetypeswrong/cli": "^0.18.5",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^24.10.1",
+    "@types/react": "^19.1.0",
+    "@types/react-dom": "^19.1.0",
+    "jsdom": "^26.1.0",
+    "publint": "^0.3.24",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.6"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": [
+    "*.css"
+  ],
+  "dependencies": {
+    "@ai-matrx/design-system": "latest",
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/agents": "latest"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsup && node ./scripts/copy-assets.mjs && node ./scripts/assert-distribution-artifacts.mjs",
+    "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
+    "check:package": "pnpm build && publint && pnpm verify:tarball",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "verify:tarball": "node ./scripts/verify-tarball.mjs"
+  }
+}