@asteby/metacore-runtime-react 53.28.0 → 53.29.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (64) hide show
  1. package/CHANGELOG.md +24 -0
  2. package/dist/business/customer-picker.d.ts.map +1 -1
  3. package/dist/business/customer-picker.js +4 -0
  4. package/dist/dialogs/create-record-dialog.d.ts +1 -1
  5. package/dist/dialogs/create-record-dialog.d.ts.map +1 -1
  6. package/dist/dialogs/create-record-dialog.js +2 -2
  7. package/dist/dialogs/dynamic-record.d.ts +16 -1
  8. package/dist/dialogs/dynamic-record.d.ts.map +1 -1
  9. package/dist/dialogs/dynamic-record.js +49 -3
  10. package/dist/dialogs/types.d.ts +4 -0
  11. package/dist/dialogs/types.d.ts.map +1 -1
  12. package/dist/index.d.ts +1 -0
  13. package/dist/index.d.ts.map +1 -1
  14. package/dist/index.js +1 -0
  15. package/dist/loom/index.d.ts +9 -0
  16. package/dist/loom/index.d.ts.map +1 -0
  17. package/dist/loom/index.js +9 -0
  18. package/dist/loom/overlay.d.ts +74 -0
  19. package/dist/loom/overlay.d.ts.map +1 -0
  20. package/dist/loom/overlay.js +142 -0
  21. package/dist/loom/proposals.d.ts +26 -0
  22. package/dist/loom/proposals.d.ts.map +1 -0
  23. package/dist/loom/proposals.js +74 -0
  24. package/dist/loom/provider.d.ts +28 -0
  25. package/dist/loom/provider.d.ts.map +1 -0
  26. package/dist/loom/provider.js +31 -0
  27. package/dist/loom/resolve.d.ts +23 -0
  28. package/dist/loom/resolve.d.ts.map +1 -0
  29. package/dist/loom/resolve.js +138 -0
  30. package/dist/loom/seam.d.ts +28 -0
  31. package/dist/loom/seam.d.ts.map +1 -0
  32. package/dist/loom/seam.js +127 -0
  33. package/dist/loom/seams.d.ts +31 -0
  34. package/dist/loom/seams.d.ts.map +1 -0
  35. package/dist/loom/seams.js +21 -0
  36. package/dist/loom/store.d.ts +16 -0
  37. package/dist/loom/store.d.ts.map +1 -0
  38. package/dist/loom/store.js +72 -0
  39. package/dist/loom/types.d.ts +153 -0
  40. package/dist/loom/types.d.ts.map +1 -0
  41. package/dist/loom/types.js +1 -0
  42. package/dist/record-picker-dialog.d.ts +7 -1
  43. package/dist/record-picker-dialog.d.ts.map +1 -1
  44. package/dist/record-picker-dialog.js +18 -3
  45. package/package.json +6 -6
  46. package/src/__tests__/dynamic-record-seam.test.tsx +194 -0
  47. package/src/__tests__/loom-overlay.test.ts +94 -0
  48. package/src/__tests__/loom-page-graph.test.ts +75 -0
  49. package/src/__tests__/loom-resolve.test.ts +108 -0
  50. package/src/business/customer-picker.tsx +4 -0
  51. package/src/dialogs/create-record-dialog.tsx +4 -0
  52. package/src/dialogs/dynamic-record.tsx +83 -0
  53. package/src/dialogs/types.ts +4 -0
  54. package/src/index.ts +1 -0
  55. package/src/loom/index.ts +36 -0
  56. package/src/loom/overlay.ts +196 -0
  57. package/src/loom/proposals.tsx +156 -0
  58. package/src/loom/provider.tsx +69 -0
  59. package/src/loom/resolve.ts +136 -0
  60. package/src/loom/seam.tsx +235 -0
  61. package/src/loom/seams.ts +42 -0
  62. package/src/loom/store.ts +81 -0
  63. package/src/loom/types.ts +167 -0
  64. package/src/record-picker-dialog.tsx +37 -1
@@ -0,0 +1,167 @@
1
+ // Loom — contratos del sistema de contribuciones de UI (RFC 0005 del kernel).
2
+ //
3
+ // Seam punto de extensión tipado de un componente anfitrión (`record.dialog.header`).
4
+ // Part componente expuesto por un addon con contrato (`fiscal_mexico.csf-import`).
5
+ // Graft injerto: Part → Seam con orden, condiciones, lentes leídas y campos escritos.
6
+ // Lens proyección de solo lectura del contexto del seam, con clase de datos.
7
+ // Proposal lo que un injerto quiere cambiar: el anfitrión lo aplica, lo muestra como diff o lo descarta.
8
+ //
9
+ // El servidor es la fuente de verdad de QUÉ injertos ve el usuario (RBAC, ajustes, preset);
10
+ // el cliente vuelve a filtrar sólo para UX y explica por qué algo no se montó.
11
+ import type { ComponentType } from 'react'
12
+
13
+ /** Clase de datos de una lente. Decide la redacción en errores/telemetría. */
14
+ export type DataClass = 'public' | 'internal' | 'money' | 'pii' | 'pii.fiscal' | 'secret'
15
+
16
+ /** Contrato que el anfitrión publica para un seam. */
17
+ export interface SeamContract {
18
+ id: string
19
+ /** Semver del contrato (`1.0.0`). Un injerto declara `requires: '^1'`. */
20
+ version: string
21
+ /** Lentes que el seam ofrece y su clase de datos. */
22
+ lenses: Readonly<Record<string, DataClass>>
23
+ /**
24
+ * Campos que un injerto puede proponer cambiar en este seam. `undefined` = el seam no
25
+ * acepta propuestas. El anfitrión lo calcula (p. ej. los campos editables del formulario).
26
+ */
27
+ writable?: ReadonlySet<string>
28
+ /** Intenciones que el anfitrión atiende (`record.select`, `record.edit`). */
29
+ intents?: readonly string[]
30
+ }
31
+
32
+ export type GraftKind = 'view' | 'action' | 'transform' | 'source'
33
+
34
+ /** Condiciones de montaje. Todas las presentes deben cumplirse. */
35
+ export interface GraftWhen {
36
+ /** Todos estos permisos RBAC. */
37
+ permission?: string | string[]
38
+ /** Al menos uno de estos permisos. */
39
+ anyPermission?: string[]
40
+ /** Feature flag activo. */
41
+ flag?: string
42
+ /** Ajuste de la organización/addon: presente y verdadero, o igual a `equals`. */
43
+ setting?: { key: string; equals?: unknown }
44
+ /** Modelos del anfitrión (acepta `Customer` o `customers.Customer`). */
45
+ model?: string[]
46
+ /** Modos del anfitrión (`create`, `edit`, `view`). */
47
+ mode?: string[]
48
+ }
49
+
50
+ export interface GraftCapabilities {
51
+ /** Proponer un parche. Sólo pasan los campos de `writes` ∩ `contract.writable`. */
52
+ propose: (p: ProposalInput) => void
53
+ /** Pedir al anfitrión una intención declarada en el contrato. false = nadie la atendió. */
54
+ emit: (intent: string, payload?: unknown) => boolean
55
+ /** RBAC del usuario actual (mismo `useCan` del host). */
56
+ can: (permission: string) => boolean
57
+ }
58
+
59
+ export interface GraftProps<P = Record<string, unknown>> {
60
+ /** Sólo las lentes declaradas en `reads`, congeladas. */
61
+ lenses: Readonly<Record<string, unknown>>
62
+ /** Props estáticas del manifiesto/registro. */
63
+ props: P
64
+ caps: GraftCapabilities
65
+ graft: { id: string; addon: string; seam: string }
66
+ }
67
+
68
+ export type GraftComponent<P = Record<string, unknown>> = ComponentType<GraftProps<P>>
69
+
70
+ export type GraftModule = GraftComponent<any> | { default: GraftComponent<any> }
71
+
72
+ /** Componente expuesto por un addon (lo que el manifiesto llama `extension_points.parts[]`). */
73
+ export interface PartDef {
74
+ /** `<addon>.<nombre>`. */
75
+ id: string
76
+ addon?: string
77
+ version?: string
78
+ component?: GraftComponent<any>
79
+ /** Carga perezosa (chunk local o remoto federado). */
80
+ load?: () => Promise<GraftModule>
81
+ }
82
+
83
+ export interface GraftDef {
84
+ /** Id estable `<addon>.<nombre>`; registrar el mismo id reemplaza. */
85
+ id: string
86
+ addon?: string
87
+ seam: string
88
+ /** Rango semver del contrato del seam (`^1`). Sin él, cualquiera. */
89
+ requires?: string
90
+ kind?: GraftKind
91
+ /** Ascendente; empates por orden de registro. */
92
+ order?: number
93
+ when?: GraftWhen
94
+ /** Lentes que lee. Una lente no declarada no llega. */
95
+ reads?: string[]
96
+ /** Campos que puede proponer cambiar. Admite `prefijo.*`. */
97
+ writes?: string[]
98
+ /** Red que necesita (declarativo; lo hace cumplir el sandbox/CSP, ver RFC §Seguridad). */
99
+ network?: 'none' | 'org' | string[]
100
+ offline?: boolean
101
+ props?: Record<string, unknown>
102
+ /** Part que monta (registrado con `registerPart`) o el componente en línea. */
103
+ part?: string
104
+ component?: GraftComponent<any>
105
+ load?: () => Promise<GraftModule>
106
+ }
107
+
108
+ export interface ProposalInput {
109
+ patch: Record<string, unknown>
110
+ /** Por qué (se muestra al usuario): «Datos de la constancia fiscal». */
111
+ reason?: string
112
+ /** 0..1. */
113
+ confidence?: number
114
+ /** Etiquetas legibles por campo, si el injerto las conoce. */
115
+ labels?: Record<string, string>
116
+ /** `review` (por omisión) o `auto` si el preset lo permite. */
117
+ apply?: 'review' | 'auto'
118
+ }
119
+
120
+ export interface Proposal extends ProposalInput {
121
+ id: string
122
+ graft: string
123
+ addon: string
124
+ /** Valores antes del parche (para el diff y el deshacer). */
125
+ previous: Record<string, unknown>
126
+ /** Claves descartadas por no estar en `writes`/`writable`. */
127
+ dropped: string[]
128
+ }
129
+
130
+ export type SkipReason =
131
+ | 'not_granted'
132
+ | 'permission'
133
+ | 'flag'
134
+ | 'setting'
135
+ | 'model'
136
+ | 'mode'
137
+ | 'version'
138
+ | 'no_component'
139
+
140
+ export interface SkippedGraft {
141
+ graft: GraftDef
142
+ reason: SkipReason
143
+ detail?: string
144
+ }
145
+
146
+ export interface ResolvedSeam {
147
+ mounted: GraftDef[]
148
+ skipped: SkippedGraft[]
149
+ }
150
+
151
+ /** Lo que el anfitrión sabe del usuario/organización para evaluar `when`. */
152
+ export interface LoomEnv {
153
+ can: (permission: string) => boolean
154
+ flags?: ReadonlySet<string>
155
+ settings?: Readonly<Record<string, unknown>>
156
+ model?: string
157
+ mode?: string
158
+ /**
159
+ * Ids de injertos que el servidor autorizó para este usuario. Presente = el cliente no monta
160
+ * nada fuera de la lista (el servidor manda). Ausente = sólo código local de confianza.
161
+ */
162
+ granted?: ReadonlySet<string>
163
+ }
164
+
165
+ export type LoomEvent =
166
+ | { type: 'graft_failed'; seam: string; graft: string; addon: string; reason: 'load' | 'render'; message: string }
167
+ | { type: 'proposal_dropped_keys'; seam: string; graft: string; addon: string; keys: string[] }
@@ -27,6 +27,12 @@ export interface UseRecordPickerDialogOptions {
27
27
  lockedCreateFields?: string[]
28
28
  /** Fields merged into the modal schema (e.g. a `widget` field that fills siblings via `setValues`). */
29
29
  ensureFields?: FieldDef[]
30
+ /**
31
+ * Un injerto del modal (Loom `record.dialog.header`) detectó que el registro ya existe y pide
32
+ * usarlo (`record.select`): se cierra el modal y se entrega el registro. Sin él, la intención
33
+ * no se atiende y el injerto sigue su camino (p. ej. rellena el formulario).
34
+ */
35
+ onSelectExisting?: (record: Record<string, unknown>) => void
30
36
  /** The saved record (`{ id, ...fields }`). */
31
37
  onSaved: (record: Record<string, unknown>, kind: 'create' | 'edit') => void
32
38
  }
@@ -47,14 +53,42 @@ export function useRecordPickerDialog({
47
53
  createDefaults,
48
54
  lockedCreateFields,
49
55
  ensureFields,
56
+ onSelectExisting,
50
57
  onSaved,
51
58
  }: UseRecordPickerDialogOptions): UseRecordPickerDialogResult {
52
59
  const api = useApi()
53
60
  const base = endpoint ?? `/data/${model}/me`
54
- const [state, setState] = useState<{ recordId?: string; defaults?: Record<string, unknown> } | null>(null)
61
+ const [state, setState] = useState<{
62
+ recordId?: string
63
+ defaults?: Record<string, unknown>
64
+ proposal?: { patch: Record<string, unknown>; reason?: string; apply?: 'review' | 'auto' }
65
+ } | null>(null)
66
+
67
+ // Intenciones Loom: `record.select` entrega el existente; `record.edit` reabre en edición con
68
+ // el parche como propuesta revisable (nada se guarda sin confirmar).
69
+ const onIntent = (intent: string, payload: unknown): boolean => {
70
+ const p = (payload ?? {}) as {
71
+ record?: Record<string, unknown>
72
+ id?: unknown
73
+ patch?: Record<string, unknown>
74
+ reason?: string
75
+ apply?: 'review' | 'auto'
76
+ }
77
+ if (intent === 'record.select' && onSelectExisting && p.record) {
78
+ setState(null)
79
+ onSelectExisting(p.record)
80
+ return true
81
+ }
82
+ if (intent === 'record.edit' && p.id != null) {
83
+ setState({ recordId: String(p.id), proposal: p.patch ? { patch: p.patch, reason: p.reason, apply: p.apply } : undefined })
84
+ return true
85
+ }
86
+ return false
87
+ }
55
88
 
56
89
  const dialog = state ? (
57
90
  <CreateRecordDialog
91
+ key={state.recordId ?? 'new'}
58
92
  modelKey={model}
59
93
  open
60
94
  onOpenChange={(o) => {
@@ -65,6 +99,8 @@ export function useRecordPickerDialog({
65
99
  defaults={state.recordId ? undefined : state.defaults}
66
100
  lockedFields={state.recordId ? undefined : lockedCreateFields}
67
101
  ensureFields={ensureFields}
102
+ onIntent={onIntent}
103
+ initialProposal={state.proposal}
68
104
  onCreate={async (data) => {
69
105
  const rec = unwrapRecord(await api.post(base, data))
70
106
  onSaved(rec, 'create')