@deviltea/widget-core 0.0.5 → 0.0.6
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/README.md +9 -1
- package/dist/{dep-Cvv2QPKi.d.mts → dep-DKbvAjPb.d.mts} +16 -0
- package/dist/index.d.mts +1 -1
- package/dist/index.mjs +270 -147
- package/dist/inspection/index.d.mts +1 -1
- package/dist/integration/index.d.mts +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -197,7 +197,9 @@ runtime.dispose()
|
|
|
197
197
|
### Blueprint diagnostics
|
|
198
198
|
|
|
199
199
|
`createBlueprint` accepts `unknown`; malformed input never throws — it always
|
|
200
|
-
produces an inspectable Blueprint.
|
|
200
|
+
produces an inspectable Blueprint. `createBlueprintFromJson(text)` is the
|
|
201
|
+
equivalent of `createBlueprint(JSON.parse(text))` that skips the JSON-domain
|
|
202
|
+
inspection, because Core parsed the value itself. Every diagnostic has top-level `code`,
|
|
201
203
|
`location`, and `message` fields. Variant-specific facts are direct fields;
|
|
202
204
|
structured `path` and `related` fields are not hidden behind a `source` object.
|
|
203
205
|
Codes are stable lowercase kebab-case values such as
|
|
@@ -371,6 +373,12 @@ later occurrence is de-identified with its available subtree preserved.
|
|
|
371
373
|
active diagnostic collector. Computing a fallback value after the failure
|
|
372
374
|
does not make the operation succeed: the result is still `ok: false`. See
|
|
373
375
|
[Dependency failures fail the consumer](https://deviltea.github.io/widget/packages/widget-core#dependency-failures-fail-the-consumer).
|
|
376
|
+
- `runtime.resetState()` restores every State member to its initialization
|
|
377
|
+
outcome (value and diagnostic snapshot) in one batch without re-running
|
|
378
|
+
`validate`, so one Runtime can evaluate many independent inputs. See
|
|
379
|
+
[Reusing a Runtime](https://deviltea.github.io/widget/packages/widget-core#reusing-a-runtime-resetstate).
|
|
380
|
+
- A callback's `addDiagnostic` / `hasAnyDiagnostic` throw a `TypeError` when
|
|
381
|
+
called after that callback returned.
|
|
374
382
|
- Every state write, property evaluation, and method invocation keeps the
|
|
375
383
|
**latest completed** diagnostic snapshot only (`getDiagnostics()` /
|
|
376
384
|
`subscribeDiagnostics()`), never a history.
|
|
@@ -487,6 +487,14 @@ interface WidgetSystem<Plugins extends AnyWidgetPluginTuple = AnyWidgetPluginTup
|
|
|
487
487
|
* editing your own object.
|
|
488
488
|
*/
|
|
489
489
|
createBlueprint: (definition: unknown) => WidgetSystemBlueprint<Plugins>;
|
|
490
|
+
/**
|
|
491
|
+
* Parses `text` with `JSON.parse` and compiles the result. Observably equivalent to
|
|
492
|
+
* `createBlueprint(JSON.parse(text))`, but cheaper: a value produced by `JSON.parse` (without a
|
|
493
|
+
* reviver) is in the authored JSON domain by construction, so Core skips the whole-source JSON-domain
|
|
494
|
+
* inspection and `sourceJsonCompatible` is `true`. Invalid JSON text throws the `SyntaxError` from
|
|
495
|
+
* `JSON.parse`, unchanged. The parsed source is referenced by nothing but the Blueprint.
|
|
496
|
+
*/
|
|
497
|
+
createBlueprintFromJson: (text: string) => WidgetSystemBlueprint<Plugins>;
|
|
490
498
|
}
|
|
491
499
|
type WidgetSystemConfigurationErrorCode = 'foreign-plugin' | 'duplicate-plugin-type';
|
|
492
500
|
/**
|
|
@@ -791,6 +799,14 @@ interface WidgetSystemRuntime<Plugins extends AnyWidgetPluginTuple = AnyWidgetPl
|
|
|
791
799
|
readonly blueprint: ValidWidgetSystemBlueprint<Plugins>;
|
|
792
800
|
readonly isDisposed: boolean;
|
|
793
801
|
getWidget: (id: WidgetId) => RuntimeWidget<Plugins> | null;
|
|
802
|
+
/**
|
|
803
|
+
* Restores every State member of every widget to its initialization outcome (override > default >
|
|
804
|
+
* `null`, as validated when this Runtime was created): the same value and the same diagnostic snapshot,
|
|
805
|
+
* without running `validate` again. All writes form one batch, so dependents recompute and subscribers
|
|
806
|
+
* are notified once. Property and Method diagnostic snapshots are not reset; Properties re-evaluate
|
|
807
|
+
* through ordinary invalidation.
|
|
808
|
+
*/
|
|
809
|
+
resetState: () => void;
|
|
794
810
|
/**
|
|
795
811
|
* Runtime-level diagnostics plus the current state/property/method diagnostic snapshots, in deterministic
|
|
796
812
|
* order. Never history, and never activates property evaluation.
|
package/dist/index.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as RuntimeDependencyValueRejectedDiagnostic, $n as createWidgetValueContract, $t as WidgetCatalogEntry, A as BlueprintNodeDiagnostic, An as WidgetPluginInterfacesPhase, Ar as JsonPrimitive, At as RuntimeEventSurface, B as Diagnostic, Bn as WidgetPropertyComputeContext, Bt as SelfBlueprintWidgetNodeView, C as BlueprintDependencyDiagnosticLocation, Cn as WidgetPlugin, Cr as WidgetResolvedConfigOf, Ct as CreateWidgetSystemRuntimeOptions, D as BlueprintDiagnostic, Dn as WidgetPluginDescriptionPhase, Dr as WidgetStateValueOf, Dt as ResolvedBlueprintWidgetNodeView, E as BlueprintDependencyTarget, En as WidgetPluginConfigPhase, Er as WidgetStateOf, Et as ResolvedBlueprintWidgetNodeFor, F as BlueprintSourceDiagnostic, Fn as WidgetPluginStatePhase, Ft as RuntimeState, G as JsonCompatibilityDiagnostic, Gn as WidgetSlotDefinitions, Gt as WidgetLocationView, H as DiagnosticCollector, Hn as WidgetRegisterDepsContext, Ht as ValidBlueprintView, I as BlueprintSourceDiagnosticLocation, In as WidgetPluginTypeOf, It as RuntimeStateSurface, J as RelativeSlotStructureDiagnosticInput, Jn as WidgetStateMemberDefinition, Jt as WidgetSystemBlueprint, K as JsonCompatibilityReason, Kn as WidgetSlotValidateStructureContext, Kt as WidgetSource, L as BlueprintStructureDiagnostic, Ln as WidgetPluginValidateStructure, Lt as RuntimeWidget, M as BlueprintPropertyDiagnosticLocation, Mn as WidgetPluginPhaseOrderViolation, Mt as RuntimeMethodSurface, N as BlueprintSlotChildDiagnosticLocation, Nn as WidgetPluginPropertiesPhase, Nt as RuntimeProperty, O as BlueprintDiagnosticLocation, On as WidgetPluginDonePhase, Or as JsonArray, Ot as ResolvedBlueprintWidgetNodeViewFor, P as BlueprintSlotDiagnosticLocation, Pn as WidgetPluginSlotsPhase, Pt as RuntimePropertySurface, Q as RuntimeDependencyTargetFailedDiagnostic, Qn as createWidgetPlugin, Qt as WidgetCatalog, R as BlueprintStructureDiagnosticLocation, Rn as WidgetPluginValidateStructureContext, Rt as RuntimeWidgetFor, S as BlueprintDependencyDiagnostic, Sn as WidgetMethodsSection, Sr as WidgetRawConfigOf, St as BlueprintWidgetNodeView, T as BlueprintDependencyReference, Tn as WidgetPluginConfigMetadata, Tr as WidgetStateKeyOf, Tt as ResolvedBlueprintWidgetNode, U as DiagnosticPath, Un as WidgetResolvedConfigContext, Ut as ValidWidgetSystemBlueprint, V as DiagnosticBase, Vn as WidgetPropertyDefinition, Vt as UnresolvedBlueprintWidgetNode, W as EMPTY_DIAGNOSTICS, Wn as WidgetSlotDefinition, Wt as WidgetLocation, X as RelativeSystemStructureDiagnosticInput, Xn as WidgetStateValidateContext, Xt as WidgetSystemRuntime, Y as RelativeStructureDiagnosticLocation, Yn as WidgetStateSection, Yt as WidgetSystemBlueprintStatus, Z as RelativeValueDiagnosticInput, Zn as WidgetValueContract, Zt as CreateWidgetSystemOptions, _ as ToExecutedDeps, _n as WidgetInterfacesOf, _r as WidgetMethodReturnOf, _t as BlueprintNodeConfigFields, a as MaybeOptional, an as WidgetSystemValidateStructureContext, ar as WidgetEventArgsOf, at as RuntimeMethodDependencyDiagnostic, b as BlueprintConfigDiagnostic, bn as WidgetMethodExecuteContext, br as WidgetPropertyKeyOf, bt as BlueprintWidgetNode, c as PropertyGetDepExpression, cn as AnyWidgetPluginTuple, cr as WidgetId, ct as RuntimePropertyDependencyDiagnostic, d as SelfMethodDependencyOperations, dn as WidgetConfigJsonSchema, dr as WidgetMemberKey, dt as RuntimeStateDiagnostic, en as WidgetPluginOf, er as ExecutionFailure, et as RuntimeDiagnostic, f as SelfPropertyDependencyOperations, fn as WidgetConfigValidateContext, fr as WidgetMemberKeysOf, ft as RuntimeWidgetDiagnostic, g as ToExecutedDep, gn as WidgetEventsSection, gr as WidgetMethodOf, gt as BlueprintCompileView, h as StateSetDepExpression, hn as WidgetEventEmitterContext, hr as WidgetMethodKeyOf, ht as WidgetSystemRuntimeDisposedError, i as EmptyRegisteredDeps, in as WidgetSystemValidateStructure, ir as WidgetCapabilityOf, it as RuntimeMethodArgsDiagnostic, j as BlueprintNodeDiagnosticLocation, jn as WidgetPluginMethodsPhase, jr as JsonValue, jt as RuntimeMethod, k as BlueprintMethodDiagnosticLocation, kn as WidgetPluginEventsPhase, kr as JsonObject, kt as RuntimeEvent, l as RegisteredDeps, ln as WIDGET_CONFIG_JSON_SCHEMA_DIALECT, lr as WidgetInterfaces, lt as RuntimePropertyDiagnostic, m as StateGetDepExpression, mn as WidgetEventEmitter, mr as WidgetMethodArgsOf, mt as WidgetSystemRuntimeDiagnostic, n as DependencyBuilder, nn as WidgetSystemConfigurationError, nr as HasWidgetCapability, nt as RuntimeLevelDiagnostic, o as MethodInvokeDepExpression, on as createWidgetSystem, or as WidgetEventKeyOf, ot as RuntimeMethodDiagnostic, p as SelfStateDependencyOperations, pn as WidgetEventDefinition, pr as WidgetMemberValueOf, pt as SourceAccessDiagnostic, q as RelativePluginStructureDiagnosticInput, qn as WidgetStateDefaultContext, qt as WidgetSourceFor, r as DependencyConsumer, rn as WidgetSystemConfigurationErrorCode, rr as NonEmptyReadonlyArray, rt as RuntimeLevelDiagnosticLocation, s as OptionalizableDependencyTarget, sn as AnyWidgetPlugin, sr as WidgetEventsOf, st as RuntimeMethodResultDiagnostic, t as AnyDepExpression, tn as WidgetSystem, tr as ExecutionResult, tt as RuntimeDiagnosticLocation, u as SelfDependencyTarget, un as WidgetConfigDefinition, ur as WidgetInterfacesViolationOf, ut as RuntimePropertyResultDiagnostic, v as UnknownTargetDependencyOperations, vn as WidgetInterfacesViolation, vr as WidgetMethodsOf, vt as BlueprintSemanticSlots, w as BlueprintDependencyOperation, wn as WidgetPluginCapabilities, wr as WidgetSlotNameOf, wt as InvalidWidgetSystemBlueprint, x as BlueprintDefinitionDiagnostic, xn as WidgetMethodValidateArgsContext, xr as WidgetPropertyValueOf, xt as BlueprintWidgetNodeBase, y as UnknownTargetStateDependencyOperations, yn as WidgetMethodDefinition, yr as WidgetPropertiesOf, yt as BlueprintSemanticSlotsView, z as BlueprintWidgetDiagnosticLocation, zn as WidgetPropertiesSection, zt as SelfBlueprintWidgetNode } from "./dep-
|
|
1
|
+
import { $ as RuntimeDependencyValueRejectedDiagnostic, $n as createWidgetValueContract, $t as WidgetCatalogEntry, A as BlueprintNodeDiagnostic, An as WidgetPluginInterfacesPhase, Ar as JsonPrimitive, At as RuntimeEventSurface, B as Diagnostic, Bn as WidgetPropertyComputeContext, Bt as SelfBlueprintWidgetNodeView, C as BlueprintDependencyDiagnosticLocation, Cn as WidgetPlugin, Cr as WidgetResolvedConfigOf, Ct as CreateWidgetSystemRuntimeOptions, D as BlueprintDiagnostic, Dn as WidgetPluginDescriptionPhase, Dr as WidgetStateValueOf, Dt as ResolvedBlueprintWidgetNodeView, E as BlueprintDependencyTarget, En as WidgetPluginConfigPhase, Er as WidgetStateOf, Et as ResolvedBlueprintWidgetNodeFor, F as BlueprintSourceDiagnostic, Fn as WidgetPluginStatePhase, Ft as RuntimeState, G as JsonCompatibilityDiagnostic, Gn as WidgetSlotDefinitions, Gt as WidgetLocationView, H as DiagnosticCollector, Hn as WidgetRegisterDepsContext, Ht as ValidBlueprintView, I as BlueprintSourceDiagnosticLocation, In as WidgetPluginTypeOf, It as RuntimeStateSurface, J as RelativeSlotStructureDiagnosticInput, Jn as WidgetStateMemberDefinition, Jt as WidgetSystemBlueprint, K as JsonCompatibilityReason, Kn as WidgetSlotValidateStructureContext, Kt as WidgetSource, L as BlueprintStructureDiagnostic, Ln as WidgetPluginValidateStructure, Lt as RuntimeWidget, M as BlueprintPropertyDiagnosticLocation, Mn as WidgetPluginPhaseOrderViolation, Mt as RuntimeMethodSurface, N as BlueprintSlotChildDiagnosticLocation, Nn as WidgetPluginPropertiesPhase, Nt as RuntimeProperty, O as BlueprintDiagnosticLocation, On as WidgetPluginDonePhase, Or as JsonArray, Ot as ResolvedBlueprintWidgetNodeViewFor, P as BlueprintSlotDiagnosticLocation, Pn as WidgetPluginSlotsPhase, Pt as RuntimePropertySurface, Q as RuntimeDependencyTargetFailedDiagnostic, Qn as createWidgetPlugin, Qt as WidgetCatalog, R as BlueprintStructureDiagnosticLocation, Rn as WidgetPluginValidateStructureContext, Rt as RuntimeWidgetFor, S as BlueprintDependencyDiagnostic, Sn as WidgetMethodsSection, Sr as WidgetRawConfigOf, St as BlueprintWidgetNodeView, T as BlueprintDependencyReference, Tn as WidgetPluginConfigMetadata, Tr as WidgetStateKeyOf, Tt as ResolvedBlueprintWidgetNode, U as DiagnosticPath, Un as WidgetResolvedConfigContext, Ut as ValidWidgetSystemBlueprint, V as DiagnosticBase, Vn as WidgetPropertyDefinition, Vt as UnresolvedBlueprintWidgetNode, W as EMPTY_DIAGNOSTICS, Wn as WidgetSlotDefinition, Wt as WidgetLocation, X as RelativeSystemStructureDiagnosticInput, Xn as WidgetStateValidateContext, Xt as WidgetSystemRuntime, Y as RelativeStructureDiagnosticLocation, Yn as WidgetStateSection, Yt as WidgetSystemBlueprintStatus, Z as RelativeValueDiagnosticInput, Zn as WidgetValueContract, Zt as CreateWidgetSystemOptions, _ as ToExecutedDeps, _n as WidgetInterfacesOf, _r as WidgetMethodReturnOf, _t as BlueprintNodeConfigFields, a as MaybeOptional, an as WidgetSystemValidateStructureContext, ar as WidgetEventArgsOf, at as RuntimeMethodDependencyDiagnostic, b as BlueprintConfigDiagnostic, bn as WidgetMethodExecuteContext, br as WidgetPropertyKeyOf, bt as BlueprintWidgetNode, c as PropertyGetDepExpression, cn as AnyWidgetPluginTuple, cr as WidgetId, ct as RuntimePropertyDependencyDiagnostic, d as SelfMethodDependencyOperations, dn as WidgetConfigJsonSchema, dr as WidgetMemberKey, dt as RuntimeStateDiagnostic, en as WidgetPluginOf, er as ExecutionFailure, et as RuntimeDiagnostic, f as SelfPropertyDependencyOperations, fn as WidgetConfigValidateContext, fr as WidgetMemberKeysOf, ft as RuntimeWidgetDiagnostic, g as ToExecutedDep, gn as WidgetEventsSection, gr as WidgetMethodOf, gt as BlueprintCompileView, h as StateSetDepExpression, hn as WidgetEventEmitterContext, hr as WidgetMethodKeyOf, ht as WidgetSystemRuntimeDisposedError, i as EmptyRegisteredDeps, in as WidgetSystemValidateStructure, ir as WidgetCapabilityOf, it as RuntimeMethodArgsDiagnostic, j as BlueprintNodeDiagnosticLocation, jn as WidgetPluginMethodsPhase, jr as JsonValue, jt as RuntimeMethod, k as BlueprintMethodDiagnosticLocation, kn as WidgetPluginEventsPhase, kr as JsonObject, kt as RuntimeEvent, l as RegisteredDeps, ln as WIDGET_CONFIG_JSON_SCHEMA_DIALECT, lr as WidgetInterfaces, lt as RuntimePropertyDiagnostic, m as StateGetDepExpression, mn as WidgetEventEmitter, mr as WidgetMethodArgsOf, mt as WidgetSystemRuntimeDiagnostic, n as DependencyBuilder, nn as WidgetSystemConfigurationError, nr as HasWidgetCapability, nt as RuntimeLevelDiagnostic, o as MethodInvokeDepExpression, on as createWidgetSystem, or as WidgetEventKeyOf, ot as RuntimeMethodDiagnostic, p as SelfStateDependencyOperations, pn as WidgetEventDefinition, pr as WidgetMemberValueOf, pt as SourceAccessDiagnostic, q as RelativePluginStructureDiagnosticInput, qn as WidgetStateDefaultContext, qt as WidgetSourceFor, r as DependencyConsumer, rn as WidgetSystemConfigurationErrorCode, rr as NonEmptyReadonlyArray, rt as RuntimeLevelDiagnosticLocation, s as OptionalizableDependencyTarget, sn as AnyWidgetPlugin, sr as WidgetEventsOf, st as RuntimeMethodResultDiagnostic, t as AnyDepExpression, tn as WidgetSystem, tr as ExecutionResult, tt as RuntimeDiagnosticLocation, u as SelfDependencyTarget, un as WidgetConfigDefinition, ur as WidgetInterfacesViolationOf, ut as RuntimePropertyResultDiagnostic, v as UnknownTargetDependencyOperations, vn as WidgetInterfacesViolation, vr as WidgetMethodsOf, vt as BlueprintSemanticSlots, w as BlueprintDependencyOperation, wn as WidgetPluginCapabilities, wr as WidgetSlotNameOf, wt as InvalidWidgetSystemBlueprint, x as BlueprintDefinitionDiagnostic, xn as WidgetMethodValidateArgsContext, xr as WidgetPropertyValueOf, xt as BlueprintWidgetNodeBase, y as UnknownTargetStateDependencyOperations, yn as WidgetMethodDefinition, yr as WidgetPropertiesOf, yt as BlueprintSemanticSlotsView, z as BlueprintWidgetDiagnosticLocation, zn as WidgetPropertiesSection, zt as SelfBlueprintWidgetNode } from "./dep-DKbvAjPb.mjs";
|
|
2
2
|
//#region src/source-patch.d.ts
|
|
3
3
|
type SourcePath = readonly (string | number)[] | string;
|
|
4
4
|
type SourcePatchOperation = {
|
package/dist/index.mjs
CHANGED
|
@@ -30,6 +30,9 @@ function accessDiagnostic(path) {
|
|
|
30
30
|
message: "Authored source could not be safely inspected."
|
|
31
31
|
};
|
|
32
32
|
}
|
|
33
|
+
/**
|
|
34
|
+
* `path` is one shared stack, pushed before and popped after each child visit; diagnostics copy it.
|
|
35
|
+
*/
|
|
33
36
|
function inspectJsonValueAt(value, path, active, diagnostics) {
|
|
34
37
|
if (value === null || typeof value === "string" || typeof value === "boolean") return;
|
|
35
38
|
if (typeof value === "number") {
|
|
@@ -122,7 +125,9 @@ function inspectJsonValueAt(value, path, active, diagnostics) {
|
|
|
122
125
|
diagnostics.push(jsonDiagnostic([...path, index], "accessor-property"));
|
|
123
126
|
continue;
|
|
124
127
|
}
|
|
125
|
-
|
|
128
|
+
path.push(index);
|
|
129
|
+
inspectJsonValueAt(descriptor.value, path, active, diagnostics);
|
|
130
|
+
path.pop();
|
|
126
131
|
}
|
|
127
132
|
return;
|
|
128
133
|
}
|
|
@@ -146,7 +151,9 @@ function inspectJsonValueAt(value, path, active, diagnostics) {
|
|
|
146
151
|
diagnostics.push(jsonDiagnostic([...path, key], "accessor-property"));
|
|
147
152
|
continue;
|
|
148
153
|
}
|
|
149
|
-
|
|
154
|
+
path.push(key);
|
|
155
|
+
inspectJsonValueAt(descriptor.value, path, active, diagnostics);
|
|
156
|
+
path.pop();
|
|
150
157
|
}
|
|
151
158
|
} finally {
|
|
152
159
|
active.delete(value);
|
|
@@ -1508,6 +1515,14 @@ function createRuntimeContext() {
|
|
|
1508
1515
|
function assertSyncValue(value, description) {
|
|
1509
1516
|
if ((typeof value === "object" && value !== null || typeof value === "function") && "then" in value && typeof value.then === "function") throw new TypeError(`${description} returned a thenable. The widget-core semantic boundary is synchronous only.`);
|
|
1510
1517
|
}
|
|
1518
|
+
/**
|
|
1519
|
+
* Callback-context lifetime guard: a callback's `addDiagnostic` / `hasAnyDiagnostic` belong to the
|
|
1520
|
+
* synchronous call that received them. Calling one after that callback returned or threw is an
|
|
1521
|
+
* implementation-contract violation (the operation's diagnostics are already final), so it throws.
|
|
1522
|
+
*/
|
|
1523
|
+
function throwClosedCollector(method) {
|
|
1524
|
+
throw new TypeError(`${method} was called after its callback returned. Diagnostics must be reported synchronously while the callback runs.`);
|
|
1525
|
+
}
|
|
1511
1526
|
//#endregion
|
|
1512
1527
|
//#region src/runtime/deps.ts
|
|
1513
1528
|
function consumerDependencyDiagnostic(params, dependency, message, received, related, cause) {
|
|
@@ -1636,24 +1651,32 @@ function materializeResolvedLeaf(leaf, params) {
|
|
|
1636
1651
|
const related = locationOf(operation, resolveTargetWidgetId(params.nodes, leaf.targetNodeId));
|
|
1637
1652
|
const leafId = nextLeafId++;
|
|
1638
1653
|
switch (operation.type) {
|
|
1639
|
-
case "state-get":
|
|
1640
|
-
|
|
1641
|
-
|
|
1642
|
-
|
|
1643
|
-
|
|
1644
|
-
const
|
|
1645
|
-
|
|
1646
|
-
|
|
1654
|
+
case "state-get": {
|
|
1655
|
+
let target;
|
|
1656
|
+
return () => {
|
|
1657
|
+
target ??= resolveEntry(params, leaf.targetNodeId).state.get(operation.key);
|
|
1658
|
+
if (target === void 0) throw new Error(`widget-core: internal error — resolved state-get target "${operation.key}" is missing.`);
|
|
1659
|
+
const raw = target.internal.get();
|
|
1660
|
+
if (leaf.refinements.length === 0) return {
|
|
1661
|
+
ok: true,
|
|
1662
|
+
value: raw
|
|
1663
|
+
};
|
|
1664
|
+
const refined = applyRefinements(raw, leaf.refinements);
|
|
1665
|
+
if (!refined.ok) {
|
|
1666
|
+
const diagnostic = consumerDependencyDiagnostic(params, reference, "The dependency value failed validation.", { value: refined.received }, related);
|
|
1667
|
+
const diagnostics = freezeDiagnosticSnapshot([deepFreezeDiagnostic(diagnostic)]);
|
|
1668
|
+
reportDependencyDiagnostic(params, diagnostic, dependencyDedupeDescriptor(leafId, refined.received));
|
|
1669
|
+
return {
|
|
1670
|
+
ok: false,
|
|
1671
|
+
failure: { diagnostics }
|
|
1672
|
+
};
|
|
1673
|
+
}
|
|
1647
1674
|
return {
|
|
1648
|
-
ok:
|
|
1649
|
-
|
|
1675
|
+
ok: true,
|
|
1676
|
+
value: refined.value
|
|
1650
1677
|
};
|
|
1651
|
-
}
|
|
1652
|
-
return {
|
|
1653
|
-
ok: true,
|
|
1654
|
-
value: refined.value
|
|
1655
1678
|
};
|
|
1656
|
-
}
|
|
1679
|
+
}
|
|
1657
1680
|
case "state-set": return (candidate) => {
|
|
1658
1681
|
const target = resolveEntry(params, leaf.targetNodeId).state.get(operation.key);
|
|
1659
1682
|
if (target === void 0) throw new Error(`widget-core: internal error — resolved state-set target "${operation.key}" is missing.`);
|
|
@@ -1667,29 +1690,36 @@ function materializeResolvedLeaf(leaf, params) {
|
|
|
1667
1690
|
failure: { diagnostics: wrapTargetFailure(params, reference, result.failure.diagnostics, related, leafId) }
|
|
1668
1691
|
};
|
|
1669
1692
|
};
|
|
1670
|
-
case "property-get":
|
|
1671
|
-
|
|
1672
|
-
|
|
1673
|
-
|
|
1674
|
-
|
|
1675
|
-
|
|
1676
|
-
|
|
1677
|
-
};
|
|
1678
|
-
const refined = applyRefinements(targetResult.value, leaf.refinements);
|
|
1679
|
-
if (!refined.ok) {
|
|
1680
|
-
const diagnostic = consumerDependencyDiagnostic(params, reference, "The dependency value failed validation.", { value: refined.received }, related);
|
|
1681
|
-
const diagnostics = freezeDiagnosticSnapshot([deepFreezeDiagnostic(diagnostic)]);
|
|
1682
|
-
reportDependencyDiagnostic(params, diagnostic, dependencyDedupeDescriptor(leafId, refined.received));
|
|
1683
|
-
return {
|
|
1693
|
+
case "property-get": {
|
|
1694
|
+
let target;
|
|
1695
|
+
return () => {
|
|
1696
|
+
target ??= resolveEntry(params, leaf.targetNodeId).properties.get(operation.name);
|
|
1697
|
+
if (target === void 0) throw new Error(`widget-core: internal error — resolved property-get target "${operation.name}" is missing.`);
|
|
1698
|
+
const targetResult = target.internal.getResult();
|
|
1699
|
+
if (!targetResult.ok) return {
|
|
1684
1700
|
ok: false,
|
|
1685
|
-
failure: { diagnostics }
|
|
1701
|
+
failure: { diagnostics: wrapTargetFailure(params, reference, targetResult.failure.diagnostics, related, leafId) }
|
|
1702
|
+
};
|
|
1703
|
+
if (leaf.refinements.length === 0) return {
|
|
1704
|
+
ok: true,
|
|
1705
|
+
value: targetResult.value
|
|
1706
|
+
};
|
|
1707
|
+
const refined = applyRefinements(targetResult.value, leaf.refinements);
|
|
1708
|
+
if (!refined.ok) {
|
|
1709
|
+
const diagnostic = consumerDependencyDiagnostic(params, reference, "The dependency value failed validation.", { value: refined.received }, related);
|
|
1710
|
+
const diagnostics = freezeDiagnosticSnapshot([deepFreezeDiagnostic(diagnostic)]);
|
|
1711
|
+
reportDependencyDiagnostic(params, diagnostic, dependencyDedupeDescriptor(leafId, refined.received));
|
|
1712
|
+
return {
|
|
1713
|
+
ok: false,
|
|
1714
|
+
failure: { diagnostics }
|
|
1715
|
+
};
|
|
1716
|
+
}
|
|
1717
|
+
return {
|
|
1718
|
+
ok: true,
|
|
1719
|
+
value: refined.value
|
|
1686
1720
|
};
|
|
1687
|
-
}
|
|
1688
|
-
return {
|
|
1689
|
-
ok: true,
|
|
1690
|
-
value: refined.value
|
|
1691
1721
|
};
|
|
1692
|
-
}
|
|
1722
|
+
}
|
|
1693
1723
|
case "method-invoke": return (...args) => {
|
|
1694
1724
|
const target = resolveEntry(params, leaf.targetNodeId).methods.get(operation.name);
|
|
1695
1725
|
if (target === void 0) throw new Error(`widget-core: internal error — resolved method-invoke target "${operation.name}" is missing.`);
|
|
@@ -1744,17 +1774,20 @@ function materializeDependencyTree(tree, params) {
|
|
|
1744
1774
|
//#endregion
|
|
1745
1775
|
//#region src/runtime/collector.ts
|
|
1746
1776
|
function createOperationCollector() {
|
|
1747
|
-
|
|
1748
|
-
|
|
1777
|
+
let entries = null;
|
|
1778
|
+
let seenAnchorsByScope = null;
|
|
1779
|
+
let closed = false;
|
|
1749
1780
|
return {
|
|
1750
1781
|
addDiagnostic(input) {
|
|
1751
|
-
|
|
1782
|
+
if (closed) throwClosedCollector("addDiagnostic");
|
|
1783
|
+
(entries ??= []).push({
|
|
1752
1784
|
kind: "relative",
|
|
1753
1785
|
input
|
|
1754
1786
|
});
|
|
1755
1787
|
},
|
|
1756
1788
|
addFinalizedDiagnostic(diagnostic, dedupe) {
|
|
1757
1789
|
if (dedupe !== void 0) {
|
|
1790
|
+
seenAnchorsByScope ??= /* @__PURE__ */ new Map();
|
|
1758
1791
|
let seenAnchors = seenAnchorsByScope.get(dedupe.scope);
|
|
1759
1792
|
if (seenAnchors === void 0) {
|
|
1760
1793
|
seenAnchors = /* @__PURE__ */ new Set();
|
|
@@ -1763,16 +1796,21 @@ function createOperationCollector() {
|
|
|
1763
1796
|
if (seenAnchors.has(dedupe.anchor)) return;
|
|
1764
1797
|
seenAnchors.add(dedupe.anchor);
|
|
1765
1798
|
}
|
|
1766
|
-
entries.push({
|
|
1799
|
+
(entries ??= []).push({
|
|
1767
1800
|
kind: "final",
|
|
1768
1801
|
diagnostic
|
|
1769
1802
|
});
|
|
1770
1803
|
},
|
|
1771
1804
|
hasAnyDiagnostic() {
|
|
1772
|
-
|
|
1805
|
+
if (closed) throwClosedCollector("hasAnyDiagnostic");
|
|
1806
|
+
return entries !== null;
|
|
1773
1807
|
},
|
|
1774
1808
|
finalize(toFinalDiagnostic) {
|
|
1809
|
+
if (entries === null) return EMPTY_DIAGNOSTICS;
|
|
1775
1810
|
return freezeDiagnosticSnapshot(entries.map((entry) => entry.kind === "relative" ? toFinalDiagnostic(entry.input) : entry.diagnostic));
|
|
1811
|
+
},
|
|
1812
|
+
close() {
|
|
1813
|
+
closed = true;
|
|
1776
1814
|
}
|
|
1777
1815
|
};
|
|
1778
1816
|
}
|
|
@@ -1780,6 +1818,12 @@ function createOperationCollector() {
|
|
|
1780
1818
|
//#region src/runtime/method.ts
|
|
1781
1819
|
function createMethodPrimitive(context, params) {
|
|
1782
1820
|
const diagnosticsSignal = signal(EMPTY_DIAGNOSTICS);
|
|
1821
|
+
let committedDiagnostics = EMPTY_DIAGNOSTICS;
|
|
1822
|
+
function commitDiagnostics(next) {
|
|
1823
|
+
if (next === committedDiagnostics) return;
|
|
1824
|
+
committedDiagnostics = next;
|
|
1825
|
+
writeDeferringFlush(() => diagnosticsSignal(next));
|
|
1826
|
+
}
|
|
1783
1827
|
function invoke(...args) {
|
|
1784
1828
|
context.assertActive();
|
|
1785
1829
|
return runRuntimeOperation(() => invokeWithinOperation(...args));
|
|
@@ -1793,12 +1837,19 @@ function createMethodPrimitive(context, params) {
|
|
|
1793
1837
|
addDiagnostic: argsCollector.addDiagnostic,
|
|
1794
1838
|
hasAnyDiagnostic: argsCollector.hasAnyDiagnostic
|
|
1795
1839
|
};
|
|
1796
|
-
|
|
1797
|
-
|
|
1798
|
-
|
|
1840
|
+
let validArgs;
|
|
1841
|
+
let hasArgsDiagnostic;
|
|
1842
|
+
try {
|
|
1843
|
+
validArgs = params.definition.validateArgs(args, argsCtx);
|
|
1844
|
+
assertSyncValue(validArgs, `Method "${params.name}"'s validateArgs`);
|
|
1845
|
+
hasArgsDiagnostic = argsCollector.hasAnyDiagnostic();
|
|
1846
|
+
} finally {
|
|
1847
|
+
argsCollector.close();
|
|
1848
|
+
}
|
|
1849
|
+
if (!validArgs || hasArgsDiagnostic) {
|
|
1799
1850
|
const finalized = argsCollector.finalize((input) => buildMethodArgsDiagnostic(params.widgetId, params.name, args, input));
|
|
1800
1851
|
const diagnostics = finalized.length > 0 ? finalized : freezeDiagnosticSnapshot([buildDefaultMethodArgsDiagnostic(params.widgetId, params.name, args)]);
|
|
1801
|
-
|
|
1852
|
+
commitDiagnostics(diagnostics);
|
|
1802
1853
|
return Object.freeze({
|
|
1803
1854
|
ok: false,
|
|
1804
1855
|
failure: { diagnostics }
|
|
@@ -1816,10 +1867,15 @@ function createMethodPrimitive(context, params) {
|
|
|
1816
1867
|
addDiagnostic: execCollector.addDiagnostic,
|
|
1817
1868
|
hasAnyDiagnostic: execCollector.hasAnyDiagnostic
|
|
1818
1869
|
};
|
|
1819
|
-
|
|
1870
|
+
let value;
|
|
1871
|
+
try {
|
|
1872
|
+
value = context.withActiveCollector(sink, () => params.definition.execute(executeCtx));
|
|
1873
|
+
} finally {
|
|
1874
|
+
execCollector.close();
|
|
1875
|
+
}
|
|
1820
1876
|
assertSyncValue(value, `Method "${params.name}"'s execute`);
|
|
1821
1877
|
const diagnostics = execCollector.finalize((input) => buildMethodResultDiagnostic(params.widgetId, params.name, value, input));
|
|
1822
|
-
|
|
1878
|
+
commitDiagnostics(toDiagnosticSnapshot(diagnostics));
|
|
1823
1879
|
const result = diagnostics.length > 0 ? {
|
|
1824
1880
|
ok: false,
|
|
1825
1881
|
failure: { diagnostics }
|
|
@@ -1904,17 +1960,22 @@ function resolveStateOverrides(compiled, overrideStateDefaults) {
|
|
|
1904
1960
|
const NEVER_EVALUATED_SNAPSHOT = Object.freeze({ status: "never-evaluated" });
|
|
1905
1961
|
function createPropertyPrimitive(context, params) {
|
|
1906
1962
|
const diagnosticsSignal = signal(EMPTY_DIAGNOSTICS);
|
|
1963
|
+
let committedDiagnostics = EMPTY_DIAGNOSTICS;
|
|
1907
1964
|
let inspectionSnapshot = NEVER_EVALUATED_SNAPSHOT;
|
|
1908
1965
|
let inspectionListeners = null;
|
|
1909
1966
|
let lastPublishedResult = null;
|
|
1910
|
-
function
|
|
1911
|
-
inspectionSnapshot
|
|
1967
|
+
function readInspectionSnapshot() {
|
|
1968
|
+
return inspectionSnapshot ??= Object.freeze({
|
|
1912
1969
|
status: "completed",
|
|
1913
|
-
result
|
|
1970
|
+
result: lastPublishedResult
|
|
1914
1971
|
});
|
|
1915
|
-
|
|
1972
|
+
}
|
|
1973
|
+
function publishInspectionCompletion() {
|
|
1974
|
+
inspectionSnapshot = null;
|
|
1975
|
+
if (inspectionListeners === null || inspectionListeners.length === 0) return;
|
|
1976
|
+
const snapshot = readInspectionSnapshot();
|
|
1916
1977
|
const listenersSnapshot = inspectionListeners.slice();
|
|
1917
|
-
for (const entry of listenersSnapshot) invokeListenerIsolated(entry.listener,
|
|
1978
|
+
for (const entry of listenersSnapshot) invokeListenerIsolated(entry.listener, snapshot);
|
|
1918
1979
|
}
|
|
1919
1980
|
const resultComputed = computed(() => {
|
|
1920
1981
|
const collector = createOperationCollector();
|
|
@@ -1927,10 +1988,19 @@ function createPropertyPrimitive(context, params) {
|
|
|
1927
1988
|
addDiagnostic: collector.addDiagnostic,
|
|
1928
1989
|
hasAnyDiagnostic: collector.hasAnyDiagnostic
|
|
1929
1990
|
};
|
|
1930
|
-
|
|
1991
|
+
let value;
|
|
1992
|
+
try {
|
|
1993
|
+
value = context.withActiveCollector(sink, () => params.definition.compute(ctx));
|
|
1994
|
+
} finally {
|
|
1995
|
+
collector.close();
|
|
1996
|
+
}
|
|
1931
1997
|
assertSyncValue(value, `Property "${params.name}"'s compute`);
|
|
1932
1998
|
const diagnostics = collector.finalize((input) => buildPropertyResultDiagnostic(params.widgetId, params.name, value, input));
|
|
1933
|
-
|
|
1999
|
+
const snapshot = toDiagnosticSnapshot(diagnostics);
|
|
2000
|
+
if (snapshot !== committedDiagnostics) {
|
|
2001
|
+
committedDiagnostics = snapshot;
|
|
2002
|
+
writeDeferringFlush(() => diagnosticsSignal(snapshot));
|
|
2003
|
+
}
|
|
1934
2004
|
const result = diagnostics.length > 0 ? {
|
|
1935
2005
|
ok: false,
|
|
1936
2006
|
failure: { diagnostics }
|
|
@@ -1961,7 +2031,7 @@ function createPropertyPrimitive(context, params) {
|
|
|
1961
2031
|
const result = runRuntimeOperation(resultComputed);
|
|
1962
2032
|
if (result !== lastPublishedResult) {
|
|
1963
2033
|
lastPublishedResult = result;
|
|
1964
|
-
publishInspectionCompletion(
|
|
2034
|
+
publishInspectionCompletion();
|
|
1965
2035
|
}
|
|
1966
2036
|
return result;
|
|
1967
2037
|
}
|
|
@@ -1969,7 +2039,7 @@ function createPropertyPrimitive(context, params) {
|
|
|
1969
2039
|
getResult: getResultWithInspectionPublish,
|
|
1970
2040
|
getDiagnostics: () => diagnosticsSignal(),
|
|
1971
2041
|
inspection: {
|
|
1972
|
-
getSnapshot:
|
|
2042
|
+
getSnapshot: readInspectionSnapshot,
|
|
1973
2043
|
subscribe: (listener) => {
|
|
1974
2044
|
const entry = { listener };
|
|
1975
2045
|
if (inspectionListeners === null) inspectionListeners = [];
|
|
@@ -2024,6 +2094,12 @@ function createStatePrimitive(context, params) {
|
|
|
2024
2094
|
* out of the graph, so the propagations they deferred are released here: still inside the very `set()`
|
|
2025
2095
|
* call that caused them, before its `ExecutionResult` reaches the caller.
|
|
2026
2096
|
*/
|
|
2097
|
+
let committedDiagnostics = EMPTY_DIAGNOSTICS;
|
|
2098
|
+
function commitDiagnostics(next) {
|
|
2099
|
+
if (next === committedDiagnostics) return;
|
|
2100
|
+
committedDiagnostics = next;
|
|
2101
|
+
writeDeferringFlush(() => diagnosticsSignal(next));
|
|
2102
|
+
}
|
|
2027
2103
|
function attemptSet(candidate) {
|
|
2028
2104
|
return runRuntimeOperation(() => attemptSetWithinOperation(candidate));
|
|
2029
2105
|
}
|
|
@@ -2034,12 +2110,19 @@ function createStatePrimitive(context, params) {
|
|
|
2034
2110
|
addDiagnostic: collector.addDiagnostic,
|
|
2035
2111
|
hasAnyDiagnostic: collector.hasAnyDiagnostic
|
|
2036
2112
|
};
|
|
2037
|
-
|
|
2038
|
-
|
|
2039
|
-
|
|
2113
|
+
let isValid;
|
|
2114
|
+
let hasDiagnostic;
|
|
2115
|
+
try {
|
|
2116
|
+
isValid = params.definition.validate(candidate, ctx);
|
|
2117
|
+
assertSyncValue(isValid, `State "${params.key}"'s validate`);
|
|
2118
|
+
hasDiagnostic = collector.hasAnyDiagnostic();
|
|
2119
|
+
} finally {
|
|
2120
|
+
collector.close();
|
|
2121
|
+
}
|
|
2122
|
+
if (!isValid || hasDiagnostic) {
|
|
2040
2123
|
const finalized = collector.finalize((input) => buildStateValidationDiagnostic(params.widgetId, params.key, candidate, input));
|
|
2041
2124
|
const diagnostics = finalized.length > 0 ? finalized : freezeDiagnosticSnapshot([buildDefaultStateValidationDiagnostic(params.widgetId, params.key, candidate)]);
|
|
2042
|
-
|
|
2125
|
+
commitDiagnostics(diagnostics);
|
|
2043
2126
|
return {
|
|
2044
2127
|
ok: false,
|
|
2045
2128
|
failure: { diagnostics }
|
|
@@ -2048,14 +2131,26 @@ function createStatePrimitive(context, params) {
|
|
|
2048
2131
|
assertSyncValue(candidate, `State "${params.key}"'s value`);
|
|
2049
2132
|
const previous = valueSignal();
|
|
2050
2133
|
valueSignal(candidate);
|
|
2051
|
-
|
|
2134
|
+
commitDiagnostics(EMPTY_DIAGNOSTICS);
|
|
2052
2135
|
if (candidate !== previous) publishInspectionSnapshot(candidate);
|
|
2053
2136
|
return {
|
|
2054
2137
|
ok: true,
|
|
2055
2138
|
value: candidate
|
|
2056
2139
|
};
|
|
2057
2140
|
}
|
|
2141
|
+
let initialValue = null;
|
|
2142
|
+
let initialDiagnostics = EMPTY_DIAGNOSTICS;
|
|
2058
2143
|
const internal = {
|
|
2144
|
+
captureInitial() {
|
|
2145
|
+
initialValue = valueSignal();
|
|
2146
|
+
initialDiagnostics = committedDiagnostics;
|
|
2147
|
+
},
|
|
2148
|
+
restoreInitial() {
|
|
2149
|
+
const previous = valueSignal();
|
|
2150
|
+
valueSignal(initialValue);
|
|
2151
|
+
commitDiagnostics(initialDiagnostics);
|
|
2152
|
+
if (initialValue !== previous) publishInspectionSnapshot(initialValue);
|
|
2153
|
+
},
|
|
2059
2154
|
get: () => valueSignal(),
|
|
2060
2155
|
getDiagnostics: () => diagnosticsSignal(),
|
|
2061
2156
|
attemptSet,
|
|
@@ -2141,8 +2236,8 @@ function createWidgetSystemRuntime(blueprint, options) {
|
|
|
2141
2236
|
const blueprintView = buildBlueprintView(blueprint);
|
|
2142
2237
|
const registry = /* @__PURE__ */ new Map();
|
|
2143
2238
|
function buildConfigFragmentFor(node) {
|
|
2144
|
-
|
|
2145
|
-
return () =>
|
|
2239
|
+
const fragment = readWidgetPluginDefinition(node.plugin).config === null ? Object.freeze({}) : Object.freeze({ config: node.config });
|
|
2240
|
+
return () => fragment;
|
|
2146
2241
|
}
|
|
2147
2242
|
for (let nodeId = 0; nodeId < compiled.nodes.length; nodeId++) {
|
|
2148
2243
|
const node = compiled.nodes[nodeId];
|
|
@@ -2184,11 +2279,12 @@ function createWidgetSystemRuntime(blueprint, options) {
|
|
|
2184
2279
|
candidate = overrides.get(key);
|
|
2185
2280
|
hasCandidate = true;
|
|
2186
2281
|
} else if (member.definition.default) {
|
|
2187
|
-
candidate = member.definition.default(buildConfigFragment());
|
|
2282
|
+
candidate = member.definition.default({ ...buildConfigFragment() });
|
|
2188
2283
|
assertSyncValue(candidate, `State "${key}"'s default`);
|
|
2189
2284
|
hasCandidate = true;
|
|
2190
2285
|
}
|
|
2191
2286
|
if (hasCandidate) primitive.internal.attemptSet(candidate);
|
|
2287
|
+
primitive.internal.captureInitial();
|
|
2192
2288
|
}
|
|
2193
2289
|
}
|
|
2194
2290
|
for (let nodeId = 0; nodeId < compiled.nodes.length; nodeId++) {
|
|
@@ -2258,12 +2354,24 @@ function createWidgetSystemRuntime(blueprint, options) {
|
|
|
2258
2354
|
if (nodeId === void 0) return null;
|
|
2259
2355
|
return runtimeWidgetsByNodeId.get(nodeId) ?? null;
|
|
2260
2356
|
}
|
|
2357
|
+
function resetState() {
|
|
2358
|
+
context.assertActive();
|
|
2359
|
+
runRuntimeOperation(() => {
|
|
2360
|
+
startBatch();
|
|
2361
|
+
try {
|
|
2362
|
+
for (const entry of registry.values()) for (const primitive of entry.state.values()) primitive.internal.restoreInitial();
|
|
2363
|
+
} finally {
|
|
2364
|
+
endBatch();
|
|
2365
|
+
}
|
|
2366
|
+
});
|
|
2367
|
+
}
|
|
2261
2368
|
const runtime = {
|
|
2262
2369
|
blueprint,
|
|
2263
2370
|
get isDisposed() {
|
|
2264
2371
|
return context.isDisposed();
|
|
2265
2372
|
},
|
|
2266
2373
|
getWidget,
|
|
2374
|
+
resetState,
|
|
2267
2375
|
getDiagnostics: aggregate.getDiagnostics,
|
|
2268
2376
|
subscribeDiagnostics: aggregate.subscribeDiagnostics,
|
|
2269
2377
|
dispose: () => context.dispose()
|
|
@@ -2360,13 +2468,27 @@ function createDependencyBuilder() {
|
|
|
2360
2468
|
}
|
|
2361
2469
|
//#endregion
|
|
2362
2470
|
//#region src/blueprint/diagnostics.ts
|
|
2471
|
+
/**
|
|
2472
|
+
* A compile-time callback's collector. `close()` ends its plugin-facing lifetime once the callback has
|
|
2473
|
+
* returned or thrown; a later `addDiagnostic` / `hasAnyDiagnostic` call then throws.
|
|
2474
|
+
*/
|
|
2363
2475
|
function createCollector() {
|
|
2364
2476
|
const items = [];
|
|
2477
|
+
let closed = false;
|
|
2365
2478
|
return {
|
|
2366
2479
|
items,
|
|
2367
2480
|
collector: {
|
|
2368
|
-
addDiagnostic: (diagnostic) =>
|
|
2369
|
-
|
|
2481
|
+
addDiagnostic: (diagnostic) => {
|
|
2482
|
+
if (closed) throwClosedCollector("addDiagnostic");
|
|
2483
|
+
items.push(diagnostic);
|
|
2484
|
+
},
|
|
2485
|
+
hasAnyDiagnostic: () => {
|
|
2486
|
+
if (closed) throwClosedCollector("hasAnyDiagnostic");
|
|
2487
|
+
return items.length > 0;
|
|
2488
|
+
}
|
|
2489
|
+
},
|
|
2490
|
+
close: () => {
|
|
2491
|
+
closed = true;
|
|
2370
2492
|
}
|
|
2371
2493
|
};
|
|
2372
2494
|
}
|
|
@@ -2408,23 +2530,9 @@ function methodLocation(node, name) {
|
|
|
2408
2530
|
name
|
|
2409
2531
|
};
|
|
2410
2532
|
}
|
|
2411
|
-
function
|
|
2412
|
-
if (path === void 0) return "invalid-widget-definition";
|
|
2413
|
-
const first = path[0];
|
|
2414
|
-
if (first === "id") return "invalid-widget-id";
|
|
2415
|
-
if (first === "type") return message.startsWith("Unknown plugin type") ? "unknown-widget-type" : "invalid-widget-type";
|
|
2416
|
-
if (first === "config") return message.includes("no config capability") ? "unexpected-widget-config" : "invalid-widget-definition";
|
|
2417
|
-
if (first === "slots") {
|
|
2418
|
-
if (message.includes("not declared")) return "undeclared-widget-slot";
|
|
2419
|
-
if (message.includes("must be an array")) return "invalid-widget-slot";
|
|
2420
|
-
if (message.includes("no slots capability")) return "unexpected-widget-slots";
|
|
2421
|
-
return "invalid-widget-slots";
|
|
2422
|
-
}
|
|
2423
|
-
return "invalid-widget-definition";
|
|
2424
|
-
}
|
|
2425
|
-
function definitionDiagnostic(node, message, path, related) {
|
|
2533
|
+
function definitionDiagnostic(node, code, message, path, related) {
|
|
2426
2534
|
return {
|
|
2427
|
-
code
|
|
2535
|
+
code,
|
|
2428
2536
|
location: widgetLocation(node),
|
|
2429
2537
|
message,
|
|
2430
2538
|
...path === void 0 ? {} : { path },
|
|
@@ -2449,20 +2557,10 @@ function structureDiagnostic(node, message, slot, index, related, reason) {
|
|
|
2449
2557
|
...reason === void 0 ? {} : { reason }
|
|
2450
2558
|
};
|
|
2451
2559
|
}
|
|
2452
|
-
function
|
|
2453
|
-
if (message.includes("ambiguous")) return "ambiguous-dependency-target";
|
|
2454
|
-
if (message.includes("could not be resolved")) return "unresolved-dependency-target";
|
|
2455
|
-
if (message.includes("does not exist")) return "missing-dependency-target";
|
|
2456
|
-
if (message.includes("no state capability") || message.includes("no properties capability") || message.includes("no methods capability")) return "missing-dependency-capability";
|
|
2457
|
-
if (message.includes("no state member") || message.includes("no property") || message.includes("no method")) return "missing-dependency-member";
|
|
2458
|
-
if (message.includes("invokes writeful")) return "property-dependency-has-write-effects";
|
|
2459
|
-
return "property-evaluation-cycle";
|
|
2460
|
-
}
|
|
2461
|
-
function dependencyDiagnostic(node, member, message, dependency, related) {
|
|
2462
|
-
const location = member.type === "property" ? propertyLocation(node, member.name) : methodLocation(node, member.name);
|
|
2560
|
+
function dependencyDiagnostic(node, member, code, message, dependency, related) {
|
|
2463
2561
|
return {
|
|
2464
|
-
code
|
|
2465
|
-
location,
|
|
2562
|
+
code,
|
|
2563
|
+
location: member.type === "property" ? propertyLocation(node, member.name) : methodLocation(node, member.name),
|
|
2466
2564
|
message,
|
|
2467
2565
|
...dependency === void 0 ? {} : { dependency },
|
|
2468
2566
|
...toNonEmpty(related ?? []) === void 0 ? {} : { related: toNonEmpty(related ?? []) }
|
|
@@ -2555,39 +2653,39 @@ function resolveLeaf(nodes, nodeIdsByWidgetId, rootNodeId, ownerNodeId, member,
|
|
|
2555
2653
|
}
|
|
2556
2654
|
if (candidateIds.length === 0) {
|
|
2557
2655
|
if ((target.type === "parent" || target.type === "widget") && target.optional) return absent();
|
|
2558
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, describeMissingTarget(target), reference));
|
|
2656
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-target", describeMissingTarget(target), reference));
|
|
2559
2657
|
return invalid();
|
|
2560
2658
|
}
|
|
2561
2659
|
if (candidateIds.length > 1) {
|
|
2562
2660
|
const related = candidateIds.map((id) => widgetLocation(nodes[id].publicNode));
|
|
2563
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "Dependency target is ambiguous: multiple widgets share that id.", reference, related));
|
|
2661
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "ambiguous-dependency-target", "Dependency target is ambiguous: multiple widgets share that id.", reference, related));
|
|
2564
2662
|
return invalid();
|
|
2565
2663
|
}
|
|
2566
2664
|
const targetNodeId = candidateIds[0];
|
|
2567
2665
|
const targetWorking = nodes[targetNodeId];
|
|
2568
2666
|
if (!targetWorking.resolved) {
|
|
2569
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "Dependency target could not be resolved to a widget.", reference, [widgetLocation(targetWorking.publicNode)]));
|
|
2667
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "unresolved-dependency-target", "Dependency target could not be resolved to a widget.", reference, [widgetLocation(targetWorking.publicNode)]));
|
|
2570
2668
|
return invalid(targetNodeId);
|
|
2571
2669
|
}
|
|
2572
2670
|
const targetDefinition = readWidgetPluginDefinition(targetWorking.plugin);
|
|
2573
2671
|
const targetPublicNode = targetWorking.publicNode;
|
|
2574
2672
|
if (operation.type === "state-get" || operation.type === "state-set") {
|
|
2575
2673
|
if (targetDefinition.state === null) {
|
|
2576
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "Dependency target has no state capability.", reference, [widgetLocation(targetPublicNode)]));
|
|
2674
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-capability", "Dependency target has no state capability.", reference, [widgetLocation(targetPublicNode)]));
|
|
2577
2675
|
return invalid(targetNodeId);
|
|
2578
2676
|
}
|
|
2579
2677
|
if (!targetDefinition.state.has(operation.key)) {
|
|
2580
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, `Dependency target has no state member "${operation.key}".`, reference, [widgetLocation(targetPublicNode)]));
|
|
2678
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-member", `Dependency target has no state member "${operation.key}".`, reference, [widgetLocation(targetPublicNode)]));
|
|
2581
2679
|
return invalid(targetNodeId);
|
|
2582
2680
|
}
|
|
2583
2681
|
if (operation.type === "state-set" && member.type === "method") directWriteSeeds.add(`${ownerNodeId}:${member.name}`);
|
|
2584
2682
|
} else if (operation.type === "property-get") {
|
|
2585
2683
|
if (targetDefinition.properties === null) {
|
|
2586
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "Dependency target has no properties capability.", reference, [widgetLocation(targetPublicNode)]));
|
|
2684
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-capability", "Dependency target has no properties capability.", reference, [widgetLocation(targetPublicNode)]));
|
|
2587
2685
|
return invalid(targetNodeId);
|
|
2588
2686
|
}
|
|
2589
2687
|
if (!targetDefinition.properties.has(operation.name)) {
|
|
2590
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, `Dependency target has no property "${operation.name}".`, reference, [widgetLocation(targetPublicNode)]));
|
|
2688
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-member", `Dependency target has no property "${operation.name}".`, reference, [widgetLocation(targetPublicNode)]));
|
|
2591
2689
|
return invalid(targetNodeId);
|
|
2592
2690
|
}
|
|
2593
2691
|
const key = edgeKey(member.type, ownerNodeId, member.name, "property", targetNodeId, operation.name);
|
|
@@ -2602,11 +2700,11 @@ function resolveLeaf(nodes, nodeIdsByWidgetId, rootNodeId, ownerNodeId, member,
|
|
|
2602
2700
|
});
|
|
2603
2701
|
} else {
|
|
2604
2702
|
if (targetDefinition.methods === null) {
|
|
2605
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "Dependency target has no methods capability.", reference, [widgetLocation(targetPublicNode)]));
|
|
2703
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-capability", "Dependency target has no methods capability.", reference, [widgetLocation(targetPublicNode)]));
|
|
2606
2704
|
return invalid(targetNodeId);
|
|
2607
2705
|
}
|
|
2608
2706
|
if (!targetDefinition.methods.has(operation.name)) {
|
|
2609
|
-
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, `Dependency target has no method "${operation.name}".`, reference, [widgetLocation(targetPublicNode)]));
|
|
2707
|
+
finalDiagnostics.push(dependencyDiagnostic(ownerPublicNode, member, "missing-dependency-member", `Dependency target has no method "${operation.name}".`, reference, [widgetLocation(targetPublicNode)]));
|
|
2610
2708
|
return invalid(targetNodeId);
|
|
2611
2709
|
}
|
|
2612
2710
|
const key = edgeKey(member.type, ownerNodeId, member.name, "method", targetNodeId, operation.name);
|
|
@@ -2744,7 +2842,7 @@ function emitPurityDiagnostics(nodes, edges, writefulMethods, finalDiagnostics)
|
|
|
2744
2842
|
finalDiagnostics.push(dependencyDiagnostic(ownerNode, {
|
|
2745
2843
|
type: "property",
|
|
2746
2844
|
name: edge.fromName
|
|
2747
|
-
}, `Property "${edge.fromName}" invokes writeful method "${edge.toName}".`, edge.reference, [methodLocation(targetNode, edge.toName)]));
|
|
2845
|
+
}, "property-dependency-has-write-effects", `Property "${edge.fromName}" invokes writeful method "${edge.toName}".`, edge.reference, [methodLocation(targetNode, edge.toName)]));
|
|
2748
2846
|
}
|
|
2749
2847
|
}
|
|
2750
2848
|
/**
|
|
@@ -2808,7 +2906,7 @@ function emitCycleDiagnostics(nodes, memberOrder, memberOrderKeys, adjacency, fi
|
|
|
2808
2906
|
finalDiagnostics.push(dependencyDiagnostic(ownerNode, {
|
|
2809
2907
|
type: "property",
|
|
2810
2908
|
name: property.name
|
|
2811
|
-
}, `Property "${property.name}" participates in an evaluation cycle.`, void 0, related));
|
|
2909
|
+
}, "property-evaluation-cycle", `Property "${property.name}" participates in an evaluation cycle.`, void 0, related));
|
|
2812
2910
|
}
|
|
2813
2911
|
}
|
|
2814
2912
|
return invalidCycles;
|
|
@@ -2948,13 +3046,13 @@ function buildNode(ctx, rawValue, parentNodeId, parentPublicNode, placement) {
|
|
|
2948
3046
|
const localDiagnostics = [];
|
|
2949
3047
|
const raw = isRecoverableObject(rawValue) ? rawValue : null;
|
|
2950
3048
|
if (raw === null) {
|
|
2951
|
-
localDiagnostics.push(definitionDiagnostic(publicNode, "Widget definition must be a plain object."));
|
|
3049
|
+
localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-definition", "Widget definition must be a plain object."));
|
|
2952
3050
|
finalizeShell(shell, working);
|
|
2953
3051
|
flushDiagnostics(ctx, localDiagnostics);
|
|
2954
3052
|
return nodeId;
|
|
2955
3053
|
}
|
|
2956
3054
|
if (ctx.activeSourceObjects.has(raw)) {
|
|
2957
|
-
localDiagnostics.push(definitionDiagnostic(publicNode, "Widget definition contains a cyclic source reference."));
|
|
3055
|
+
localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-definition", "Widget definition contains a cyclic source reference."));
|
|
2958
3056
|
finalizeShell(shell, working);
|
|
2959
3057
|
flushDiagnostics(ctx, localDiagnostics);
|
|
2960
3058
|
return nodeId;
|
|
@@ -2963,15 +3061,15 @@ function buildNode(ctx, rawValue, parentNodeId, parentPublicNode, placement) {
|
|
|
2963
3061
|
const idProperty = readOwnDataProperty(raw, "id");
|
|
2964
3062
|
const rawId = idProperty.accessible ? idProperty.value : void 0;
|
|
2965
3063
|
const hasValidId = idProperty.found && idProperty.accessible && typeof rawId === "string";
|
|
2966
|
-
if (!hasValidId) localDiagnostics.push(definitionDiagnostic(publicNode, "Widget \"id\" is missing or is not a string.", ["id"]));
|
|
3064
|
+
if (!hasValidId) localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-id", "Widget \"id\" is missing or is not a string.", ["id"]));
|
|
2967
3065
|
const typeProperty = readOwnDataProperty(raw, "type");
|
|
2968
3066
|
const rawType = typeProperty.accessible ? typeProperty.value : void 0;
|
|
2969
3067
|
const hasValidTypeShape = typeProperty.found && typeProperty.accessible && typeof rawType === "string";
|
|
2970
3068
|
let plugin = null;
|
|
2971
|
-
if (!hasValidTypeShape) localDiagnostics.push(definitionDiagnostic(publicNode, "Widget \"type\" is missing or is not a string.", ["type"]));
|
|
3069
|
+
if (!hasValidTypeShape) localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-type", "Widget \"type\" is missing or is not a string.", ["type"]));
|
|
2972
3070
|
else {
|
|
2973
3071
|
plugin = ctx.pluginsByType.get(rawType) ?? null;
|
|
2974
|
-
if (plugin === null) localDiagnostics.push(definitionDiagnostic(publicNode, `Unknown plugin type "${rawType}".`, ["type"]));
|
|
3072
|
+
if (plugin === null) localDiagnostics.push(definitionDiagnostic(publicNode, "unknown-widget-type", `Unknown plugin type "${rawType}".`, ["type"]));
|
|
2975
3073
|
}
|
|
2976
3074
|
const resolved = hasValidId && hasValidTypeShape && plugin !== null;
|
|
2977
3075
|
working.resolved = resolved;
|
|
@@ -2992,7 +3090,7 @@ function buildNode(ctx, rawValue, parentNodeId, parentPublicNode, placement) {
|
|
|
2992
3090
|
working.config = resolved;
|
|
2993
3091
|
} else {
|
|
2994
3092
|
const rawConfigValue = configProperty.found ? configProperty.value : null;
|
|
2995
|
-
const { collector, items } = createCollector();
|
|
3093
|
+
const { collector, items, close } = createCollector();
|
|
2996
3094
|
let ok = false;
|
|
2997
3095
|
try {
|
|
2998
3096
|
const rawValidateResult = definition.config.validate(rawConfigValue, collector);
|
|
@@ -3002,6 +3100,8 @@ function buildNode(ctx, rawValue, parentNodeId, parentPublicNode, placement) {
|
|
|
3002
3100
|
finalizeShell(shell, working);
|
|
3003
3101
|
flushDiagnostics(ctx, localDiagnostics);
|
|
3004
3102
|
throw error;
|
|
3103
|
+
} finally {
|
|
3104
|
+
close();
|
|
3005
3105
|
}
|
|
3006
3106
|
if (ok && items.length === 0) {
|
|
3007
3107
|
const resolved = definition.config.resolve(rawConfigValue);
|
|
@@ -3017,7 +3117,7 @@ function buildNode(ctx, rawValue, parentNodeId, parentPublicNode, placement) {
|
|
|
3017
3117
|
working.config = resolved;
|
|
3018
3118
|
}
|
|
3019
3119
|
}
|
|
3020
|
-
} else if (configProperty.found) localDiagnostics.push(definitionDiagnostic(publicNode, "Widget declares \"config\" but its plugin has no config capability.", ["config"]));
|
|
3120
|
+
} else if (configProperty.found) localDiagnostics.push(definitionDiagnostic(publicNode, "unexpected-widget-config", "Widget declares \"config\" but its plugin has no config capability.", ["config"]));
|
|
3021
3121
|
}
|
|
3022
3122
|
if (resolved && plugin !== null) {
|
|
3023
3123
|
const definition = readWidgetPluginDefinition(plugin);
|
|
@@ -3062,30 +3162,30 @@ function recoverSlots(ctx, working, raw, plugin, localDiagnostics) {
|
|
|
3062
3162
|
return;
|
|
3063
3163
|
}
|
|
3064
3164
|
if (!slotsProperty.accessible) {
|
|
3065
|
-
localDiagnostics.push(definitionDiagnostic(publicNode, "Widget \"slots\" could not be inspected safely.", ["slots"]));
|
|
3165
|
+
localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-slots", "Widget \"slots\" could not be inspected safely.", ["slots"]));
|
|
3066
3166
|
fillMissingDeclaredSlots();
|
|
3067
3167
|
return;
|
|
3068
3168
|
}
|
|
3069
3169
|
const rawSlotsValue = slotsProperty.value;
|
|
3070
3170
|
if (!isRecoverableObject(rawSlotsValue)) {
|
|
3071
|
-
localDiagnostics.push(definitionDiagnostic(publicNode, "Widget \"slots\" must be a plain object.", ["slots"]));
|
|
3171
|
+
localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-slots", "Widget \"slots\" must be a plain object.", ["slots"]));
|
|
3072
3172
|
fillMissingDeclaredSlots();
|
|
3073
3173
|
return;
|
|
3074
3174
|
}
|
|
3075
|
-
if (plugin !== null && declaredSlots === null) localDiagnostics.push(definitionDiagnostic(publicNode, "Widget declares \"slots\" but its plugin has no slots capability.", ["slots"]));
|
|
3175
|
+
if (plugin !== null && declaredSlots === null) localDiagnostics.push(definitionDiagnostic(publicNode, "unexpected-widget-slots", "Widget declares \"slots\" but its plugin has no slots capability.", ["slots"]));
|
|
3076
3176
|
const slotNames = readOwnEnumerableStringKeys(rawSlotsValue);
|
|
3077
3177
|
if (slotNames === null) {
|
|
3078
|
-
localDiagnostics.push(definitionDiagnostic(publicNode, "Widget \"slots\" could not be inspected safely.", ["slots"]));
|
|
3178
|
+
localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-slots", "Widget \"slots\" could not be inspected safely.", ["slots"]));
|
|
3079
3179
|
fillMissingDeclaredSlots();
|
|
3080
3180
|
return;
|
|
3081
3181
|
}
|
|
3082
3182
|
for (const slotName of slotNames) {
|
|
3083
3183
|
const slotProperty = readOwnDataProperty(rawSlotsValue, slotName);
|
|
3084
3184
|
const isDeclared = declaredSlots !== null && declaredSlots.has(slotName);
|
|
3085
|
-
if (declaredSlots !== null && !isDeclared) localDiagnostics.push(definitionDiagnostic(publicNode, `Widget slot "${slotName}" is not declared by its plugin.`, ["slots", slotName]));
|
|
3185
|
+
if (declaredSlots !== null && !isDeclared) localDiagnostics.push(definitionDiagnostic(publicNode, "undeclared-widget-slot", `Widget slot "${slotName}" is not declared by its plugin.`, ["slots", slotName]));
|
|
3086
3186
|
const slotArray = readArrayInfo(slotProperty.value);
|
|
3087
3187
|
if (!slotProperty.found || !slotProperty.accessible || !slotArray.isArray || !slotArray.accessible) {
|
|
3088
|
-
localDiagnostics.push(definitionDiagnostic(publicNode, `Widget slot "${slotName}" must be an array.`, ["slots", slotName]));
|
|
3188
|
+
localDiagnostics.push(definitionDiagnostic(publicNode, "invalid-widget-slot", `Widget slot "${slotName}" must be an array.`, ["slots", slotName]));
|
|
3089
3189
|
continue;
|
|
3090
3190
|
}
|
|
3091
3191
|
const childNodeIds = [];
|
|
@@ -3142,7 +3242,7 @@ function emitDuplicateIdDiagnostics(ctx, index) {
|
|
|
3142
3242
|
for (const nodeId of ids) {
|
|
3143
3243
|
const node = ctx.nodes[nodeId];
|
|
3144
3244
|
const related = ids.filter((otherId) => otherId !== nodeId).map((otherId) => widgetLocation(ctx.nodes[otherId].publicNode));
|
|
3145
|
-
ctx.finalDiagnostics.push(definitionDiagnostic(node.publicNode, `Duplicate widget id "${node.id}".`, ["id"], related));
|
|
3245
|
+
ctx.finalDiagnostics.push(definitionDiagnostic(node.publicNode, "invalid-widget-id", `Duplicate widget id "${node.id}".`, ["id"], related));
|
|
3146
3246
|
}
|
|
3147
3247
|
}
|
|
3148
3248
|
}
|
|
@@ -3285,45 +3385,57 @@ function runStructureValidation(system, nodes, semanticOrder, compileFacade, fin
|
|
|
3285
3385
|
if (definition.slots !== null) for (const [slotName, slotDefinition] of definition.slots) {
|
|
3286
3386
|
if (slotDefinition.validateStructure === void 0) continue;
|
|
3287
3387
|
const children = (node.semanticSlots.get(slotName) ?? []).map((id) => compileFacade.facadeForNodeId(id));
|
|
3288
|
-
const { collector, items } = createCollector();
|
|
3289
|
-
|
|
3290
|
-
|
|
3291
|
-
|
|
3292
|
-
|
|
3293
|
-
|
|
3294
|
-
|
|
3295
|
-
|
|
3296
|
-
|
|
3297
|
-
|
|
3388
|
+
const { collector, items, close } = createCollector();
|
|
3389
|
+
try {
|
|
3390
|
+
assertSyncValue(slotDefinition.validateStructure({
|
|
3391
|
+
widget: widgetFacade,
|
|
3392
|
+
slot: slotName,
|
|
3393
|
+
children,
|
|
3394
|
+
blueprint: compileFacade.view,
|
|
3395
|
+
...configFragment(node),
|
|
3396
|
+
...collector
|
|
3397
|
+
}), `Slot "${slotName}"'s validateStructure`);
|
|
3398
|
+
} finally {
|
|
3399
|
+
close();
|
|
3400
|
+
}
|
|
3401
|
+
for (const item of items) finalDiagnostics.push(structureDiagnostic(publicNode, item.message, slotName, item.index, void 0, item.reason));
|
|
3298
3402
|
}
|
|
3299
3403
|
if (definition.validateStructure !== null) {
|
|
3300
|
-
const { collector, items } = createCollector();
|
|
3301
|
-
|
|
3302
|
-
|
|
3303
|
-
|
|
3304
|
-
|
|
3305
|
-
|
|
3306
|
-
|
|
3404
|
+
const { collector, items, close } = createCollector();
|
|
3405
|
+
try {
|
|
3406
|
+
assertSyncValue(definition.validateStructure({
|
|
3407
|
+
widget: widgetFacade,
|
|
3408
|
+
blueprint: compileFacade.view,
|
|
3409
|
+
...configFragment(node),
|
|
3410
|
+
...collector
|
|
3411
|
+
}), `Plugin "${node.type}"'s validateStructure`);
|
|
3412
|
+
} finally {
|
|
3413
|
+
close();
|
|
3414
|
+
}
|
|
3307
3415
|
for (const item of items) {
|
|
3308
3416
|
const slot = "slot" in item ? item.slot : void 0;
|
|
3309
3417
|
const index = "index" in item ? item.index : void 0;
|
|
3310
|
-
finalDiagnostics.push(structureDiagnostic(publicNode, item.message, slot, index));
|
|
3418
|
+
finalDiagnostics.push(structureDiagnostic(publicNode, item.message, slot, index, void 0, item.reason));
|
|
3311
3419
|
}
|
|
3312
3420
|
}
|
|
3313
3421
|
}
|
|
3314
3422
|
if (system.validateStructure !== null) {
|
|
3315
|
-
const { collector, items } = createCollector();
|
|
3316
|
-
|
|
3317
|
-
|
|
3318
|
-
|
|
3319
|
-
|
|
3423
|
+
const { collector, items, close } = createCollector();
|
|
3424
|
+
try {
|
|
3425
|
+
assertSyncValue(system.validateStructure({
|
|
3426
|
+
blueprint: compileFacade.view,
|
|
3427
|
+
...collector
|
|
3428
|
+
}), "System-level validateStructure");
|
|
3429
|
+
} finally {
|
|
3430
|
+
close();
|
|
3431
|
+
}
|
|
3320
3432
|
const semanticOrderIndex = /* @__PURE__ */ new Map();
|
|
3321
3433
|
semanticOrder.forEach((nodeId, index) => semanticOrderIndex.set(nodeId, index));
|
|
3322
3434
|
for (const item of items) {
|
|
3323
3435
|
const { location, related } = item;
|
|
3324
3436
|
const nodeId = compileFacade.resolveNodeId(location.node);
|
|
3325
3437
|
const realNode = nodeId !== void 0 ? nodes[nodeId].publicNode : location.node;
|
|
3326
|
-
finalDiagnostics.push(structureDiagnostic(realNode, item.message, location.type === "widget" ? void 0 : location.slot, location.type === "slot-child" ? location.index : void 0, normalizeRelated(nodes, semanticOrderIndex, compileFacade.resolveNodeId, related)));
|
|
3438
|
+
finalDiagnostics.push(structureDiagnostic(realNode, item.message, location.type === "widget" ? void 0 : location.slot, location.type === "slot-child" ? location.index : void 0, normalizeRelated(nodes, semanticOrderIndex, compileFacade.resolveNodeId, related), item.reason));
|
|
3327
3439
|
}
|
|
3328
3440
|
}
|
|
3329
3441
|
}
|
|
@@ -3517,9 +3629,17 @@ function buildCompiledNodes(nodes, diagnosticsByNode) {
|
|
|
3517
3629
|
};
|
|
3518
3630
|
});
|
|
3519
3631
|
}
|
|
3520
|
-
|
|
3632
|
+
const JSON_PROVEN_BY_CONSTRUCTION = Object.freeze({
|
|
3633
|
+
compatible: true,
|
|
3634
|
+
diagnostics: Object.freeze([])
|
|
3635
|
+
});
|
|
3636
|
+
/**
|
|
3637
|
+
* `sourceJsonProven` is set only for a value Core itself produced with `JSON.parse` (no reviver): such a
|
|
3638
|
+
* value cannot hold anything `inspectJsonValue` rejects, so the inspection would prove nothing new.
|
|
3639
|
+
*/
|
|
3640
|
+
function compileBlueprint(system, definition, sourceJsonProven = false) {
|
|
3521
3641
|
const { nodes, rootNodeId, nodeIdByPublicNode, nodeIdsByWidgetId, finalDiagnostics, diagnosticsByNode } = recoverBlueprint(system, definition);
|
|
3522
|
-
const jsonInspection = inspectJsonValue(definition);
|
|
3642
|
+
const jsonInspection = sourceJsonProven ? JSON_PROVEN_BY_CONSTRUCTION : inspectJsonValue(definition);
|
|
3523
3643
|
const sourceJsonCompatible = jsonInspection.compatible;
|
|
3524
3644
|
finalDiagnostics.push(...jsonInspection.diagnostics);
|
|
3525
3645
|
const semanticOrder = computeSemanticOrder(nodes, rootNodeId);
|
|
@@ -3680,6 +3800,9 @@ function createWidgetSystem(options) {
|
|
|
3680
3800
|
},
|
|
3681
3801
|
createBlueprint(definition) {
|
|
3682
3802
|
return compileBlueprint(system, definition);
|
|
3803
|
+
},
|
|
3804
|
+
createBlueprintFromJson(text) {
|
|
3805
|
+
return compileBlueprint(system, JSON.parse(text), true);
|
|
3683
3806
|
}
|
|
3684
3807
|
};
|
|
3685
3808
|
return Object.freeze(system);
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Jt as WidgetSystemBlueprint, T as BlueprintDependencyReference, Tn as WidgetPluginConfigMetadata, Tt as ResolvedBlueprintWidgetNode, Vt as UnresolvedBlueprintWidgetNode, Xt as WidgetSystemRuntime, bt as BlueprintWidgetNode, cn as AnyWidgetPluginTuple, dr as WidgetMemberKey, lt as RuntimePropertyDiagnostic, sn as AnyWidgetPlugin, tr as ExecutionResult } from "../dep-
|
|
1
|
+
import { Jt as WidgetSystemBlueprint, T as BlueprintDependencyReference, Tn as WidgetPluginConfigMetadata, Tt as ResolvedBlueprintWidgetNode, Vt as UnresolvedBlueprintWidgetNode, Xt as WidgetSystemRuntime, bt as BlueprintWidgetNode, cn as AnyWidgetPluginTuple, dr as WidgetMemberKey, lt as RuntimePropertyDiagnostic, sn as AnyWidgetPlugin, tr as ExecutionResult } from "../dep-DKbvAjPb.mjs";
|
|
2
2
|
//#region src/inspection/types.d.ts
|
|
3
3
|
declare const inspectionNodeIdBrand: unique symbol;
|
|
4
4
|
/**
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { Lt as RuntimeWidget, Xt as WidgetSystemRuntime, cn as AnyWidgetPluginTuple, dr as WidgetMemberKey } from "../dep-
|
|
1
|
+
import { Lt as RuntimeWidget, Xt as WidgetSystemRuntime, cn as AnyWidgetPluginTuple, dr as WidgetMemberKey } from "../dep-DKbvAjPb.mjs";
|
|
2
2
|
//#region src/integration/index.d.ts
|
|
3
3
|
type WidgetIntegrationErrorCode = 'runtime-widget-mismatch' | 'foreign-runtime';
|
|
4
4
|
declare class WidgetIntegrationError extends Error {
|
package/package.json
CHANGED