@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.
- package/CHANGELOG.md +24 -0
- package/dist/business/customer-picker.d.ts.map +1 -1
- package/dist/business/customer-picker.js +4 -0
- package/dist/dialogs/create-record-dialog.d.ts +1 -1
- package/dist/dialogs/create-record-dialog.d.ts.map +1 -1
- package/dist/dialogs/create-record-dialog.js +2 -2
- package/dist/dialogs/dynamic-record.d.ts +16 -1
- package/dist/dialogs/dynamic-record.d.ts.map +1 -1
- package/dist/dialogs/dynamic-record.js +49 -3
- package/dist/dialogs/types.d.ts +4 -0
- package/dist/dialogs/types.d.ts.map +1 -1
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -0
- package/dist/loom/index.d.ts +9 -0
- package/dist/loom/index.d.ts.map +1 -0
- package/dist/loom/index.js +9 -0
- package/dist/loom/overlay.d.ts +74 -0
- package/dist/loom/overlay.d.ts.map +1 -0
- package/dist/loom/overlay.js +142 -0
- package/dist/loom/proposals.d.ts +26 -0
- package/dist/loom/proposals.d.ts.map +1 -0
- package/dist/loom/proposals.js +74 -0
- package/dist/loom/provider.d.ts +28 -0
- package/dist/loom/provider.d.ts.map +1 -0
- package/dist/loom/provider.js +31 -0
- package/dist/loom/resolve.d.ts +23 -0
- package/dist/loom/resolve.d.ts.map +1 -0
- package/dist/loom/resolve.js +138 -0
- package/dist/loom/seam.d.ts +28 -0
- package/dist/loom/seam.d.ts.map +1 -0
- package/dist/loom/seam.js +127 -0
- package/dist/loom/seams.d.ts +31 -0
- package/dist/loom/seams.d.ts.map +1 -0
- package/dist/loom/seams.js +21 -0
- package/dist/loom/store.d.ts +16 -0
- package/dist/loom/store.d.ts.map +1 -0
- package/dist/loom/store.js +72 -0
- package/dist/loom/types.d.ts +153 -0
- package/dist/loom/types.d.ts.map +1 -0
- package/dist/loom/types.js +1 -0
- package/dist/record-picker-dialog.d.ts +7 -1
- package/dist/record-picker-dialog.d.ts.map +1 -1
- package/dist/record-picker-dialog.js +18 -3
- package/package.json +6 -6
- package/src/__tests__/dynamic-record-seam.test.tsx +194 -0
- package/src/__tests__/loom-overlay.test.ts +94 -0
- package/src/__tests__/loom-page-graph.test.ts +75 -0
- package/src/__tests__/loom-resolve.test.ts +108 -0
- package/src/business/customer-picker.tsx +4 -0
- package/src/dialogs/create-record-dialog.tsx +4 -0
- package/src/dialogs/dynamic-record.tsx +83 -0
- package/src/dialogs/types.ts +4 -0
- package/src/index.ts +1 -0
- package/src/loom/index.ts +36 -0
- package/src/loom/overlay.ts +196 -0
- package/src/loom/proposals.tsx +156 -0
- package/src/loom/provider.tsx +69 -0
- package/src/loom/resolve.ts +136 -0
- package/src/loom/seam.tsx +235 -0
- package/src/loom/seams.ts +42 -0
- package/src/loom/store.ts +81 -0
- package/src/loom/types.ts +167 -0
- 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<{
|
|
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')
|