@loom-forge/address 0.1.0

package/README.md

@@ -0,0 +1,31 @@
+# @loom-forge/address
+
+**loom** · o `AddressPort` sobre [`json-myers`](https://github.com/andersondrosa/json-myers):
+diff/patch **identity-aware** da definição. É o formato de fio da MUDANÇA — undo serializável,
+colaboração, persistência, server-sync.
+
+```bash
+pnpm add @loom-forge/address json-myers
+```
+
+```ts
+import { createMyersAddress } from "@loom-forge/address";
+
+const addr = createMyersAddress(); // { identity?: string, strict?: boolean }
+const patch = addr.diff(defA, defB); // reorder/move → {move, key}; edit → update por id
+addr.patch(defA, patch); // round-trip: == defB
+```
+
+Como os nós têm `id`, o json-myers usa **smart-key**: reorder vira `{ move, key }` (não
+remove+add) e sobrevive à reordenação; editar uma prop vira update aninhado por id; o `:index`
+cobre grids posicionais. Um diff por POSIÇÃO (RFC 6902) quebra no instante em que algo se move —
+ver [docs/DECISIONS](./docs/DECISIONS.md) ADR-202.
+
+**O que se difere é a definição AUTORADA** — o documento, como o autor o escreveu. Tudo o que o
+motor escreve por cima dele em runtime fica fora do patch: a marca `local` de uma intenção e o
+escopo que o `bind` guarda num binding resolvido (ADR-018 do root) moram no nó resolvido, nunca no
+documento. Uma cadeia `then`/`catch` é objeto aninhado como outro qualquer, e é diferida por chave.
+
+O consumidor natural é o [`@loom-forge/editor`](../editor/README.md), que emite o patch a cada
+commit. O invariante que prende os dois está na suíte de conformance:
+`address.patch(antes, patch) === editor.getDefinition()`.

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { AddressPort } from '@loom-forge/core';
+
+interface MyersAddressOptions {
+    /** campo de identidade dos arrays de coleção. Default `"id"` (= os nós). */
+    identity?: string;
+    /** aplicar patch em modo strict (assume patch gerado por diff real contra a base). */
+    strict?: boolean;
+}
+declare function createMyersAddress(opts?: MyersAddressOptions): AddressPort;
+
+export { type MyersAddressOptions, createMyersAddress };

package/dist/index.js

@@ -0,0 +1,18 @@
+import { patchJson, diffJson } from 'json-myers';
+
+// src/myers.ts
+function createMyersAddress(opts = {}) {
+  const diffOpts = opts.identity ? { identity: opts.identity } : void 0;
+  const patchOpts = {
+    ...opts.identity ? { identity: opts.identity } : {},
+    ...opts.strict ? { strict: true } : {}
+  };
+  return {
+    diff: (a, b) => diffJson(a, b, diffOpts),
+    patch: (base, d) => patchJson(base, d, patchOpts)
+  };
+}
+
+export { createMyersAddress };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/myers.ts"],"names":[],"mappings":";;;AAmBO,SAAS,kBAAA,CACd,IAAA,GAA4B,EAAC,EAChB;AACb,EAAA,MAAM,WAAW,IAAA,CAAK,QAAA,GAAW,EAAE,QAAA,EAAU,IAAA,CAAK,UAAS,GAAI,MAAA;AAC/D,EAAA,MAAM,SAAA,GAAY;AAAA,IAChB,GAAI,KAAK,QAAA,GAAW,EAAE,UAAU,IAAA,CAAK,QAAA,KAAa,EAAC;AAAA,IACnD,GAAI,IAAA,CAAK,MAAA,GAAS,EAAE,MAAA,EAAQ,IAAA,KAAS;AAAC,GACxC;AACA,EAAA,OAAO;AAAA,IACL,MAAM,CAAC,CAAA,EAAG,MAAM,QAAA,CAAS,CAAA,EAAG,GAAG,QAAQ,CAAA;AAAA,IACvC,OAAO,CAAC,IAAA,EAAM,MAAM,SAAA,CAAU,IAAA,EAAM,GAAG,SAAS;AAAA,GAClD;AACF","file":"index.js","sourcesContent":["import { diffJson, patchJson } from \"json-myers\";\nimport type { AddressPort } from \"@loom-forge/core\";\n\n/* ──────────────────────────────────────────────────────────────────────────────\n   Adapter do AddressPort sobre json-myers — diff/patch IDENTITY-aware da definição.\n   Os nós têm `id` → smart-key: reorder/move viram `{move, key}` (não remove+add),\n   sobrevivendo à reordenação; editar prop vira update aninhado por id. É o formato\n   de fio da MUDANÇA (undo/redo serializável, colaboração, persistência, server-sync).\n\n   DI/opcional: json-myers é peer opcional; este adapter (subpath ./address) o embrulha.\n   ────────────────────────────────────────────────────────────────────────────── */\n\nexport interface MyersAddressOptions {\n  /** campo de identidade dos arrays de coleção. Default `\"id\"` (= os nós). */\n  identity?: string;\n  /** aplicar patch em modo strict (assume patch gerado por diff real contra a base). */\n  strict?: boolean;\n}\n\nexport function createMyersAddress(\n  opts: MyersAddressOptions = {},\n): AddressPort {\n  const diffOpts = opts.identity ? { identity: opts.identity } : undefined;\n  const patchOpts = {\n    ...(opts.identity ? { identity: opts.identity } : {}),\n    ...(opts.strict ? { strict: true } : {}),\n  };\n  return {\n    diff: (a, b) => diffJson(a, b, diffOpts),\n    patch: (base, d) => patchJson(base, d, patchOpts),\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@loom-forge/address",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "loom · o AddressPort sobre json-myers: diff/patch identity-aware da definição — reorder vira {move, key}. O formato de fio da mudança (undo serializável, colaboração, persistência).",
+  "keywords": [
+    "json",
+    "diff",
+    "patch",
+    "address",
+    "identity"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Anderson D. Rosa",
+    "url": "https://github.com/andersondrosa"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andersondrosa/loom-forge.git",
+    "directory": "packages/address"
+  },
+  "homepage": "https://github.com/andersondrosa/loom-forge/tree/main/packages/address#readme",
+  "bugs": {
+    "url": "https://github.com/andersondrosa/loom-forge/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@loom-forge/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "json-myers": "^3.2.0"
+  },
+  "devDependencies": {
+    "json-myers": "^3.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}