@inf-monkeys-tech/monkeys 1.1.24 → 1.1.25

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

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;