@inf-monkeys-tech/monkeys 1.1.24 → 1.1.26

package/README.md

@@ -37,6 +37,31 @@ import { resolveThemeTokens } from '@inf-monkeys-tech/monkeys/runtime';
 
 `projectCurrentNavigationPages` refreshes Page routes and access policies from a complete, tenant-authorized catalog. Consumers hide unavailable or disabled nodes and empty groups, and enforce both Navigation audience and current Page permissions. Catalog failures remain errors. Persisted release and dependency hashes are not rewritten by runtime projection.
 
+### 首屏查询时机（候选）
+
+`Page.initialQueryPolicy` 控制组件代码准备期间的提前请求：省略或 `"auto"` 自动推导可提前执行的查询；`"explicit"` 只考虑显式标记的查询；`"disabled"` 关闭本页所有提前请求，包括显式标记。关闭提前请求不影响组件挂载后的正常查询。
+
+在节点 `data`（编译后为 `queryBindings`）中设置 `loadTiming: "page-start"` 可标记提前请求；`loadTiming: "component-mount"` 将该条查询排除，即使页面启用自动推导。省略 `loadTiming` 跟随页面策略。例如，仅提前获取列表：
+
+```js
+const page = {
+  // ...其余 Page 必填字段
+  initialQueryPolicy: 'explicit',
+  body: {
+    // ...已注册组件和端口
+    data: [{
+      // ...query、parameters、port、pagination 等必填字段
+      bindingId: 'list',
+      loadTiming: 'page-start',
+    }],
+  },
+};
+```
+
+这些字段是调度提示，不绕过权限、`queryWhen`、节点及祖先的生命周期或参数依赖。当前 Studio 宿主仅提前执行已授权、可解析参数、`execution: "server"` 且 `cache: "identity-scoped"` 的 Design 组件查询，每次准备最多 8 条；未满足条件的仍走原查询流程。已有 `queryPolicy: "manual"` 等触发方式保持不变。同一请求结果仅向挂载后的组件交接一次，不增加业务数据持久缓存。
+
+两个字段均不注入 schema 默认值，旧声明和编译身份保持不变。发布含新字段的 Page 前，需要先更新 SDK、服务端编译器和 Studio 宿主；当前仅为本地候选。
+
 ## 发布门禁
 
 ```bash
@@ -80,6 +105,14 @@ sourceHash. No generated artifacts authorize registration, publication or calls.
 
 This contract does not expose localStorage keys or execute scripts. The host must resolve exactly one supported provider/version, validate its slot and persistence requirements, enforce identity lifecycle guards, and grant writes only through the declared mappings. Missing providers must fail explicitly. Provider-specific semantics and shared namespaces remain host responsibilities. Deployments must upgrade SDK readers/compilers and the host provider together before publishing Pages using this field.
 
+### Prepared property projections
+
+`preparePagePropertyProjection(bindings)` from `@inf-monkeys-tech/monkeys/runtime` validates and snapshots a binding list once, returning `(base, context) => projectedModel`. Share this function across repeated rows with the same declaration; pass each row's current context on every call. Declaration shape, target-path overlap and expression arity are checked at preparation. Dynamic property types, destination shapes, value limits and the shared operation budget are still checked during every evaluation.
+
+`preparePageExpression(expression)` similarly returns `(context) => value` for an immutable standalone expression, such as a repeated collection source. Preparation snapshots the declaration and checks its shape and arity once. Each evaluation reads the supplied context and resets its operation budget, while retaining dynamic value/type guards. Mutable literal outputs cannot alter the private snapshot. Replace the prepared function when the declaration changes; use `evaluatePageExpression` when intentionally editing a declaration in place between calls.
+
+The plan retains no row contexts or results. Source declaration edits do not change an existing plan: prepare a new one when the Page revision changes. Literal objects in returned models are isolated from the private snapshot. `projectPageProperties(base, bindings, context)` remains available for one-shot calls and observes declaration edits on each invocation. Hosts using older SDK releases can keep that path until the prepared API is installed.
+
 ### Stable runtime contracts
 
 `runtimeContractVersion` is a provider-owned public contract identifier, independent of implementation revisions. `resolvePage` and `compileWorkbenchRuntimeBundle` derive it from exact governed registrations. The Page compiler rejects user-supplied contract labels that disagree with those registrations. A compatible implementation can serve a previously compiled RenderNode without changing the published definition or its dependency hashes.

package/lib/contracts/declarative-control-http.d.ts

@@ -4790,6 +4790,11 @@ export declare const DeclarativeCreateTemplateRegistrationSchema: z.ZodObject<{
         }, z.core.$strict>>>;
         shell: z.ZodOptional<z.ZodString>;
         body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         state: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scopeNodeId: z.ZodOptional<z.ZodString>;
             initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -7467,6 +7472,10 @@ export declare const DeclarativeCreateTemplateRegistrationSchema: z.ZodObject<{
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>>;
             queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+            loadTiming: z.ZodOptional<z.ZodEnum<{
+                "page-start": "page-start";
+                "component-mount": "component-mount";
+            }>>;
             accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
             draftRetention: z.ZodOptional<z.ZodObject<{
                 identityParameters: z.ZodArray<z.ZodString>;
@@ -7567,6 +7576,11 @@ export declare const DeclarativeCreateTemplateRegistrationSchema: z.ZodObject<{
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         actionBindings: z.ZodArray<z.ZodObject<{
             bindingId: z.ZodString;
             commandRevisionRef: z.ZodObject<{
@@ -12846,6 +12860,11 @@ export declare const ProductDeclarativeAuthoringCatalogSchema: z.ZodObject<{
             }, z.core.$strict>>>;
             shell: z.ZodOptional<z.ZodString>;
             body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+            initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                disabled: "disabled";
+                explicit: "explicit";
+            }>>;
             state: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scopeNodeId: z.ZodOptional<z.ZodString>;
                 initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -15523,6 +15542,10 @@ export declare const ProductDeclarativeAuthoringCatalogSchema: z.ZodObject<{
                     when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
                 }, z.core.$strict>>>;
                 queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+                loadTiming: z.ZodOptional<z.ZodEnum<{
+                    "page-start": "page-start";
+                    "component-mount": "component-mount";
+                }>>;
                 accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
                 draftRetention: z.ZodOptional<z.ZodObject<{
                     identityParameters: z.ZodArray<z.ZodString>;
@@ -15623,6 +15646,11 @@ export declare const ProductDeclarativeAuthoringCatalogSchema: z.ZodObject<{
                     when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>>;
+            initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                disabled: "disabled";
+                explicit: "explicit";
+            }>>;
             actionBindings: z.ZodArray<z.ZodObject<{
                 bindingId: z.ZodString;
                 commandRevisionRef: z.ZodObject<{
@@ -21458,6 +21486,11 @@ export declare const DeclarativeCreateTemplateChoiceSchema: z.ZodObject<{
             }, z.core.$strict>>>;
             shell: z.ZodOptional<z.ZodString>;
             body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+            initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                disabled: "disabled";
+                explicit: "explicit";
+            }>>;
             state: z.ZodOptional<z.ZodArray<z.ZodObject<{
                 scopeNodeId: z.ZodOptional<z.ZodString>;
                 initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -24135,6 +24168,10 @@ export declare const DeclarativeCreateTemplateChoiceSchema: z.ZodObject<{
                     when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
                 }, z.core.$strict>>>;
                 queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+                loadTiming: z.ZodOptional<z.ZodEnum<{
+                    "page-start": "page-start";
+                    "component-mount": "component-mount";
+                }>>;
                 accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
                 draftRetention: z.ZodOptional<z.ZodObject<{
                     identityParameters: z.ZodArray<z.ZodString>;
@@ -24235,6 +24272,11 @@ export declare const DeclarativeCreateTemplateChoiceSchema: z.ZodObject<{
                     when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
                 }, z.core.$strict>>;
             }, z.core.$strict>>>;
+            initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+                auto: "auto";
+                disabled: "disabled";
+                explicit: "explicit";
+            }>>;
             actionBindings: z.ZodArray<z.ZodObject<{
                 bindingId: z.ZodString;
                 commandRevisionRef: z.ZodObject<{
@@ -29678,6 +29720,11 @@ export declare const DeclarativeDocumentSchema: z.ZodUnion<readonly [z.ZodObject
     }, z.core.$strict>>>;
     shell: z.ZodOptional<z.ZodString>;
     body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+    initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        disabled: "disabled";
+        explicit: "explicit";
+    }>>;
     state: z.ZodOptional<z.ZodArray<z.ZodObject<{
         scopeNodeId: z.ZodOptional<z.ZodString>;
         initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -32355,6 +32402,10 @@ export declare const DeclarativeDocumentSchema: z.ZodUnion<readonly [z.ZodObject
             when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
         }, z.core.$strict>>>;
         queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+        loadTiming: z.ZodOptional<z.ZodEnum<{
+            "page-start": "page-start";
+            "component-mount": "component-mount";
+        }>>;
         accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
         draftRetention: z.ZodOptional<z.ZodObject<{
             identityParameters: z.ZodArray<z.ZodString>;
@@ -32455,6 +32506,11 @@ export declare const DeclarativeDocumentSchema: z.ZodUnion<readonly [z.ZodObject
             when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
         }, z.core.$strict>>;
     }, z.core.$strict>>>;
+    initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        disabled: "disabled";
+        explicit: "explicit";
+    }>>;
     actionBindings: z.ZodArray<z.ZodObject<{
         bindingId: z.ZodString;
         commandRevisionRef: z.ZodObject<{
@@ -36821,6 +36877,11 @@ export declare const DeclarativeSaveDraftIntentSchema: z.ZodObject<{
         }, z.core.$strict>>>;
         shell: z.ZodOptional<z.ZodString>;
         body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         state: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scopeNodeId: z.ZodOptional<z.ZodString>;
             initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -39498,6 +39559,10 @@ export declare const DeclarativeSaveDraftIntentSchema: z.ZodObject<{
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>>;
             queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+            loadTiming: z.ZodOptional<z.ZodEnum<{
+                "page-start": "page-start";
+                "component-mount": "component-mount";
+            }>>;
             accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
             draftRetention: z.ZodOptional<z.ZodObject<{
                 identityParameters: z.ZodArray<z.ZodString>;
@@ -39598,6 +39663,11 @@ export declare const DeclarativeSaveDraftIntentSchema: z.ZodObject<{
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         actionBindings: z.ZodArray<z.ZodObject<{
             bindingId: z.ZodString;
             commandRevisionRef: z.ZodObject<{
@@ -53564,6 +53634,11 @@ export declare const DeclarativeDraftResultSchema: z.ZodObject<{
         }, z.core.$strict>>>;
         shell: z.ZodOptional<z.ZodString>;
         body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         state: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scopeNodeId: z.ZodOptional<z.ZodString>;
             initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -56241,6 +56316,10 @@ export declare const DeclarativeDraftResultSchema: z.ZodObject<{
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>>;
             queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+            loadTiming: z.ZodOptional<z.ZodEnum<{
+                "page-start": "page-start";
+                "component-mount": "component-mount";
+            }>>;
             accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
             draftRetention: z.ZodOptional<z.ZodObject<{
                 identityParameters: z.ZodArray<z.ZodString>;
@@ -56341,6 +56420,11 @@ export declare const DeclarativeDraftResultSchema: z.ZodObject<{
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         actionBindings: z.ZodArray<z.ZodObject<{
             bindingId: z.ZodString;
             commandRevisionRef: z.ZodObject<{
@@ -61890,6 +61974,7 @@ export declare const DeclarativePreviewResultSchema: z.ZodObject<{
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -62811,6 +62896,7 @@ export declare const DeclarativePreviewResultSchema: z.ZodObject<{
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -64323,6 +64409,7 @@ export declare const DeclarativePreviewResultSchema: z.ZodObject<{
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -65244,6 +65331,7 @@ export declare const DeclarativePreviewResultSchema: z.ZodObject<{
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -72020,6 +72108,7 @@ export declare const DeclarativePublicationItemResultSchema: z.ZodObject<{
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -72941,6 +73030,7 @@ export declare const DeclarativePublicationItemResultSchema: z.ZodObject<{
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -74453,6 +74543,7 @@ export declare const DeclarativePublicationItemResultSchema: z.ZodObject<{
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -75374,6 +75465,7 @@ export declare const DeclarativePublicationItemResultSchema: z.ZodObject<{
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -82153,6 +82245,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -83074,6 +83167,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -84586,6 +84680,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -85507,6 +85602,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -92314,6 +92410,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -93235,6 +93332,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -94747,6 +94845,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -95668,6 +95767,7 @@ export declare const DeclarativePublicationResultSchema: z.ZodUnion<readonly [z.
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -99288,6 +99388,11 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
         }, z.core.$strict>>>;
         shell: z.ZodOptional<z.ZodString>;
         body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         state: z.ZodOptional<z.ZodArray<z.ZodObject<{
             scopeNodeId: z.ZodOptional<z.ZodString>;
             initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -101965,6 +102070,10 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>>;
             queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+            loadTiming: z.ZodOptional<z.ZodEnum<{
+                "page-start": "page-start";
+                "component-mount": "component-mount";
+            }>>;
             accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
             draftRetention: z.ZodOptional<z.ZodObject<{
                 identityParameters: z.ZodArray<z.ZodString>;
@@ -102065,6 +102174,11 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
             }, z.core.$strict>>;
         }, z.core.$strict>>>;
+        initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+            auto: "auto";
+            disabled: "disabled";
+            explicit: "explicit";
+        }>>;
         actionBindings: z.ZodArray<z.ZodObject<{
             bindingId: z.ZodString;
             commandRevisionRef: z.ZodObject<{
@@ -107610,6 +107724,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -108531,6 +108646,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -110043,6 +110159,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -110964,6 +111081,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -117744,6 +117862,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -118665,6 +118784,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -120177,6 +120297,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -121098,6 +121219,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -127905,6 +128027,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -128826,6 +128949,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -130338,6 +130462,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -131259,6 +131384,7 @@ export declare const DeclarativeAuthoringCommandResultSchema: z.ZodUnion<readonl
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -137824,6 +137950,11 @@ export declare const DeclarativeAuthoringBootstrapSchema: z.ZodObject<{
                 }, z.core.$strict>>>;
                 shell: z.ZodOptional<z.ZodString>;
                 body: z.ZodType<import("./declarative-control").PageNode, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageNode, unknown>>;
+                initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+                    auto: "auto";
+                    disabled: "disabled";
+                    explicit: "explicit";
+                }>>;
                 state: z.ZodOptional<z.ZodArray<z.ZodObject<{
                     scopeNodeId: z.ZodOptional<z.ZodString>;
                     initialValue: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
@@ -140501,6 +140632,10 @@ export declare const DeclarativeAuthoringBootstrapSchema: z.ZodObject<{
                         when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
                     }, z.core.$strict>>>;
                     queryWhen: z.ZodOptional<z.ZodType<import("./declarative-control").PageStateActivation, unknown, z.core.$ZodTypeInternals<import("./declarative-control").PageStateActivation, unknown>>>;
+                    loadTiming: z.ZodOptional<z.ZodEnum<{
+                        "page-start": "page-start";
+                        "component-mount": "component-mount";
+                    }>>;
                     accessFailure: z.ZodOptional<z.ZodLiteral<"render-forbidden">>;
                     draftRetention: z.ZodOptional<z.ZodObject<{
                         identityParameters: z.ZodArray<z.ZodString>;
@@ -140601,6 +140736,11 @@ export declare const DeclarativeAuthoringBootstrapSchema: z.ZodObject<{
                         when: z.ZodOptional<z.ZodPipe<z.ZodUnknown, z.ZodType<import("./page-expression").PageExpression, unknown, z.core.$ZodTypeInternals<import("./page-expression").PageExpression, unknown>>>>;
                     }, z.core.$strict>>;
                 }, z.core.$strict>>>;
+                initialQueryPolicy: z.ZodOptional<z.ZodEnum<{
+                    auto: "auto";
+                    disabled: "disabled";
+                    explicit: "explicit";
+                }>>;
                 actionBindings: z.ZodArray<z.ZodObject<{
                     bindingId: z.ZodString;
                     commandRevisionRef: z.ZodObject<{
@@ -149060,6 +149200,7 @@ export declare const DeclarativeRuntimeResolvedSchema: z.ZodObject<{
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -149981,6 +150122,7 @@ export declare const DeclarativeRuntimeResolvedSchema: z.ZodObject<{
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -151493,6 +151635,7 @@ export declare const DeclarativeRuntimeResolvedSchema: z.ZodObject<{
                 when?: import("./page-expression").PageExpression | undefined;
             }[] | undefined;
             queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+            loadTiming?: "page-start" | "component-mount" | undefined;
             accessFailure?: "render-forbidden" | undefined;
             draftRetention?: {
                 identityParameters: string[];
@@ -152414,6 +152557,7 @@ export declare const DeclarativeRuntimeResolvedSchema: z.ZodObject<{
             queries: Record<string, string>;
             writeInteractions: string[];
         }[] | undefined;
+        initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
         programBindings?: {
             source: {
                 capabilityInstanceId: string;
@@ -157236,6 +157380,7 @@ export declare const DeclarativeRuntimeResolveResultSchema: z.ZodUnion<readonly
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -158157,6 +158302,7 @@ export declare const DeclarativeRuntimeResolveResultSchema: z.ZodUnion<readonly
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;
@@ -159669,6 +159815,7 @@ export declare const DeclarativeRuntimeResolveResultSchema: z.ZodUnion<readonly
                     when?: import("./page-expression").PageExpression | undefined;
                 }[] | undefined;
                 queryWhen?: import("./declarative-control").PageStateActivation | undefined;
+                loadTiming?: "page-start" | "component-mount" | undefined;
                 accessFailure?: "render-forbidden" | undefined;
                 draftRetention?: {
                     identityParameters: string[];
@@ -160590,6 +160737,7 @@ export declare const DeclarativeRuntimeResolveResultSchema: z.ZodUnion<readonly
                 queries: Record<string, string>;
                 writeInteractions: string[];
             }[] | undefined;
+            initialQueryPolicy?: "auto" | "disabled" | "explicit" | undefined;
             programBindings?: {
                 source: {
                     capabilityInstanceId: string;