@openfairygui/functions 0.2.0-alpha.13 → 0.2.0-alpha.14

package/README.md

@@ -50,9 +50,9 @@ Publish plugins are documented in the repository guide:
 
 - https://github.com/OpenFairyGUI/OpenFairyGUI/blob/main/docs/publish-plugins.md
 
-## Phase A UAM authoring seam
+## UAM authoring seam
 
-`@openfairygui/functions` also exposes a thin stateless wrapper over the Phase A UAM
+`@openfairygui/functions` also exposes a thin stateless wrapper over the UAM
 transaction contract from `@openfairygui/core`.
 
 This seam:
@@ -63,6 +63,14 @@ This seam:
 - does not define a second selector / operation grammar
 - does not wrap `publish` or `restore`
 
+The transaction surface includes resource rename/move, byte-backed binary resource
+add/replace/remove, and add/update/remove for `display`, `display2`, `look`, `xy`,
+`size`, `color`, `animation`, `text`, `icon`, and `fontSize` gears. Resource
+rename/move/replace/remove requires `sourceBytes`; opt in with
+`ProjectReader.read(path, { hydrateResourceBytes: true })` before lifting a project to
+UAM. Source bytes are written back with the project, and stale source files are removed
+only after all replacement content succeeds.
+
 ```ts
 import {
 	type UamProject,
@@ -70,7 +78,7 @@ import {
 } from '@openfairygui/core';
 import { applyUamTransactionApp } from '@openfairygui/functions';
 
-const project: UamProject = /* ... */;
+const project: UamProject = /* project read and lifted with hydrateResourceBytes */;
 const operations: UamTransactionOperation[] = [
 	{
 		kind: 'renameResource',

package/dist/node.cjs

@@ -89,8 +89,8 @@ async function resolveNodeAssetsPath(document, assetsPath) {
 }
 async function loadSharpBackend() {
 	try {
-		const sharp = await importNative("sharp");
-		return sharp.default ?? sharp;
+		const loaded = await importNative("sharp");
+		return loaded.default ?? loaded;
 	} catch {
 		return;
 	}

package/dist/node.js

@@ -88,8 +88,8 @@ async function resolveNodeAssetsPath(document, assetsPath) {
 }
 async function loadSharpBackend() {
 	try {
-		const sharp = await importNative("sharp");
-		return sharp.default ?? sharp;
+		const loaded = await importNative("sharp");
+		return loaded.default ?? loaded;
 	} catch {
 		return;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfairygui/functions",
-  "version": "0.2.0-alpha.13",
+  "version": "0.2.0-alpha.14",
   "description": "FairyGUI Headless Authoring SDK — composable transform functions.",
   "author": "OpenFairyGUI Contributors",
   "license": "MIT",
@@ -74,7 +74,7 @@
   ],
   "dependencies": {
     "jiti": "^2.6.1",
-    "@openfairygui/core": "0.2.0-alpha.13"
+    "@openfairygui/core": "0.2.0-alpha.14"
   },
   "devDependencies": {
     "ava": "^7.0.0",

package/src/adapters/node/publish.ts

@@ -68,8 +68,9 @@ async function resolveNodeAssetsPath(document: Document, assetsPath: string | un
 
 async function loadSharpBackend(): Promise<AtlasRasterBackend | undefined> {
 	try {
-		const sharp = await importNative<typeof import('sharp')>('sharp');
-		return (sharp.default ?? sharp) as unknown as AtlasRasterBackend;
+		const loaded = await importNative<typeof import('sharp')>('sharp');
+		const sharp = loaded as unknown as { default?: AtlasRasterBackend };
+		return sharp.default ?? (loaded as unknown as AtlasRasterBackend);
 	} catch {
 		return undefined;
 	}

package/src/adapters/web/publish.ts

@@ -63,6 +63,7 @@ type BrowserCanvas = OffscreenCanvas | HTMLCanvasElement;
 interface BrowserContext {
 	clearRect(x: number, y: number, width: number, height: number): void;
 	drawImage(image: CanvasImageSource, dx: number, dy: number): void;
+	drawImage(image: CanvasImageSource, dx: number, dy: number, dw: number, dh: number): void;
 	drawImage(
 		image: CanvasImageSource,
 		sx: number,