@ai-matrx/alchemy 0.2.2 → 0.3.0

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## 0.3.0 — 2026-09-14
+
+Exports the native table transfer extensions, live-reference and email integration ports, and compact toolbar presentation. The Portal arrow points downward. All email attachments are reviewed before sending, including spreadsheet-safe CSV adjustments.
+
+### Consumer action
+
+Update the package and wire the optional host ports for registered references and email delivery. Existing copy sources remain supported.
+
+## 0.2.3
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/alchemy/v0.2.2..npm/alchemy/v0.2.3 -- apps/shared/alchemy`).
+No source changes intended and no consumer action required.
+
 ## 0.2.2
 
 Refreshes icons to normal sidebar proportions: 18px, 24-unit viewBox, 1.75 stroke.

package/README.md

@@ -30,7 +30,7 @@ Preparation supports editable drafts, detail presets, structural reductions, omi
 
 ## Portal and Tap Target
 
-Portal is the default mark in every Matrx host. The trigger is the actual Tap Target primitive: 44px hit area, 28px visual pill and 14px glyph. Use `triggerVariant="glass"` in headers and `triggerVariant="transparent"` for content actions. `icon="copy-transform"` is an optional package variant; both marks ship as SVG assets. Future host marks extend this typed icon set rather than replacing the trigger or adding page CSS.
+Portal is the default mark in every Matrx host. Default glass/transparent controls use the actual Tap Target primitive with sidebar-parity 18px artwork, 1.75 stroke and shell icon colors in a 32px desktop target; coarse pointers retain 44px. Use `triggerVariant="glass"` in headers and `triggerVariant="transparent"` for content actions. `triggerVariant="outline"` uses the canonical outlined Button for dense toolbars (28px target and 14px artwork). `AlchemyMenu` sizes `xs` and `toolbar` also select compact geometry. `icon="copy-transform"` is an optional package variant; both marks ship as SVG assets. Future host marks extend this typed icon set rather than replacing the trigger or adding page CSS.
 
 ```tsx
 import { ContentTransferMenu } from "@ai-matrx/alchemy/react";
@@ -55,6 +55,14 @@ The Copy/Download selector uses one format palette. Additional formats use the s
 
 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.
 
+## Table exports and live references
+
+Register `tableDataFormat` for flat JSON keyed by display labels and `tableSchemaFormat` for source identity, projected schema and rows. Ordinary JSON retains machine keys; duplicate display labels are disambiguated without dropping values. Both adapters read the current projected draft, including filtering, sorting and visible columns. The readable format also opts Email JSON into that representation.
+
+Supply `table.availableScopes`, `table.initialScope` and optional `table.scopeLabels` with loaders that honestly capture each scope. The preparation workspace retains drafts per scope. Provide `references` with explicit registered entity identities and a provider `reference` port that validates and builds the canonical envelope. These are live saved references, independent of content filters and draft edits. `referenceActions` can open the existing advanced picker. Never infer an entity from a title.
+
+A provider `email` port enables CSV, JSON and Markdown email actions. The package shows the exact sealed file and adjustments before explicit Send; the host delivers the same filename, MIME and bytes to the authenticated account. Share/access controls stay separate. Standard table copy configuration also accepts `references`, `rowReferences` and `triggerVariant`.
+
 ## 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.

package/dist/alchemy.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M10 4H6a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h4M14 4h4a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-4M8 12h8m-3-3 3 3-3 3"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M10 4H6a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h4M14 4h4a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-4M12 8v8m-3-3 3 3 3-3"/></svg>

package/dist/portal.svg

@@ -1 +1 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M10 4H6a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h4M14 4h4a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-4M8 12h8m-3-3 3 3-3 3"/></svg>
+<svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.75" stroke-linecap="round" stroke-linejoin="round"><path d="M10 4H6a2 2 0 0 0-2 2v12a2 2 0 0 0 2 2h4M14 4h4a2 2 0 0 1 2 2v12a2 2 0 0 1-2 2h-4M12 8v8m-3-3 3 3 3-3"/></svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/alchemy",
-  "version": "0.2.2",
+  "version": "0.3.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",
@@ -132,8 +132,8 @@
     "*.css"
   ],
   "dependencies": {
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/agents": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/kit": "latest"
   },
   "scripts": {