@softize/opus 12.8.0 → 12.8.1

package/CHANGELOG.md

@@ -7,6 +7,16 @@ Depois de qualquer bump, rode os gates (`typecheck` · `test` · `opus check` ·
 `opus copy --check` · `base copy check` · `manifest:check`) — eles apontam o que a
 mudança cobra do seu código.
 
+## 12.8.1 — 2026-09-02
+
+Num monorepo pnpm em que o workspace do contrato e o da SPA resolvem cópias distintas do Opus
+(peers diferentes), as colunas de dicionário zero-config do `ActionList` e o fallback de opções
+do `ActionForm` não encontravam o dicionário: a meta que `t.dict` grava no schema vivia num
+`WeakMap` por instância, invisível para a outra cópia. A meta anexada por `attachLogicalType`
+agora viaja também como propriedade não enumerável do próprio schema, chaveada por
+`Symbol.for('@softize/opus/logical-type')`, e `getLogicalType` a lê quando o `WeakMap` local não
+conhece o objeto. Sem mudança de API.
+
 ## 12.8.0 — 2026-09-02
 
 A apresentação de um dicionário passa a ser declarada no próprio `t.dict`, e não inferida por

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@softize/opus",
-  "version": "12.8.0",
+  "version": "12.8.1",
   "description": "End-to-end action protocol for TypeScript. Single package with subpath exports (core + adapters).",
   "license": "MIT",
   "type": "module",

package/src/core/logical-type.ts

@@ -5,12 +5,21 @@
  * labels de dict lendo a meta que viaja no schema do contrato, e a fronteira SPA
  * (gate de arquitetura) só deixa a UI tocar ui/lib/core. O `@softize/opus/schema`
  * re-exporta — a API pública não muda; as factories `t.*` seguem no driver.
+ *
+ * A meta é guardada de duas formas: num `WeakMap` desta instância e numa propriedade
+ * não enumerável do próprio schema, chaveada por `Symbol.for`. A segunda é o que
+ * atravessa instâncias do pacote: num monorepo pnpm, o workspace do contrato e o da
+ * SPA podem resolver cópias distintas do Opus (peers diferentes), e um `WeakMap` de
+ * uma cópia é invisível para a outra — o schema, não; ele é o mesmo objeto.
  */
 
 import type { LogicalTypeMeta } from './types.ts'
 
 const META = new WeakMap<object, LogicalTypeMeta>()
 
+/** Chave global da propriedade que carrega a meta no próprio schema. */
+export const LOGICAL_TYPE_PROPERTY = Symbol.for('@softize/opus/logical-type')
+
 /**
  * Anexa metadata logical type a qualquer schema (objeto). Drivers usam
  * internamente; consumers usam pra registrar tipos lógicos customizados.
@@ -20,12 +29,27 @@ export function attachLogicalType<S extends object>(
   meta: LogicalTypeMeta,
 ): S {
   META.set(schema, meta)
+  // Objeto congelado ou selado fica só no WeakMap — a assinatura aceita "qualquer objeto".
+  if (Object.isExtensible(schema)) {
+    Object.defineProperty(schema, LOGICAL_TYPE_PROPERTY, {
+      value: meta,
+      enumerable: false,
+      configurable: true,
+      writable: true,
+    })
+  }
   return schema
 }
 
 /**
- * Lê a metadata logical type anexada. Retorna `undefined` se ausente.
+ * Lê a metadata logical type anexada, por esta instância ou por outra cópia do
+ * pacote que tenha anexado no mesmo objeto. Retorna `undefined` se ausente.
  */
 export function getLogicalType(schema: object): LogicalTypeMeta | undefined {
-  return META.get(schema)
+  const own = META.get(schema)
+  if (own !== undefined) return own
+  const carried = (schema as { [LOGICAL_TYPE_PROPERTY]?: unknown })[LOGICAL_TYPE_PROPERTY]
+  return carried !== null && typeof carried === 'object' && 'logicalType' in carried
+    ? (carried as LogicalTypeMeta)
+    : undefined
 }