@uniformdev/canvas 20.78.0 → 20.79.1

package/dist/index.d.mts

@@ -571,6 +571,11 @@ interface components$q {
             _patternDataResources?: {
                 [key: string]: components$q["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$q["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -644,6 +649,11 @@ interface components$q {
             _patternDataResources?: {
                 [key: string]: components$q["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
             _patternError?: components$q["schemas"]["PatternError"];
             /**
@@ -678,6 +688,12 @@ interface components$q {
             _overridability?: components$q["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /**
          * Defines how to override a specific component.
@@ -1145,6 +1161,12 @@ interface components$q {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -1610,6 +1632,11 @@ interface components$p {
             _patternDataResources?: {
                 [key: string]: components$p["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$p["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -2414,6 +2441,11 @@ interface components$o {
             _patternDataResources?: {
                 [key: string]: components$o["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$o["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -2685,17 +2717,24 @@ interface components$o {
         keyword: string;
         /**
          * Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
-         *     skipOverridesResolution, withComponentIDs) overrides this alias.
+         *     skipOverridesResolution, withComponentIDs, skipContentTypeResolution) overrides this alias.
          *       - `canonical`: PUT-safe structure — patterns and overrides left
          *         unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
          *         (skipPatternResolution=true, skipOverridesResolution=true,
-         *         withComponentIDs=true).
+         *         withComponentIDs=true, skipContentTypeResolution=false).
          *       - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
          *         the expanded pattern nodes.
-         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
-         *         and component `_id`s removed.
+         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved,
+         *         component `_id`s removed, and each entry returned as stored
+         *         (skipContentTypeResolution=true).
          */
         format: "canonical" | "editor" | "delivery";
+        /**
+         * Improves performance by skipping dynamic data revalidations; appropriate for content delivery.
+         *     Default: true when `format` is delivery. False otherwise.
+         *     Prefer selecting a `format` rather than using this option.
+         */
+        skipContentTypeResolution: boolean;
         /**
          * If true, any pattern references in the composition will be left unresolved.
          *     This is appropriate if you intend to serialize the composition without patterns
@@ -3336,6 +3375,12 @@ interface paths$k {
                      *     Prefer selecting a `format` rather than using this option.
                      */
                     skipOverridesResolution?: components$m["parameters"]["skipOverridesResolution"];
+                    /**
+                     * Improves performance by skipping dynamic data revalidations; appropriate for content delivery.
+                     *     Default: true when `format` is delivery. False otherwise.
+                     *     Prefer selecting a `format` rather than using this option.
+                     */
+                    skipContentTypeResolution?: components$m["parameters"]["skipContentTypeResolution"];
                     /**
                      * One or more locales to filter and localize by.
                      *     Only entries that enable one of the specified locales _or enable no locales_ will be returned.
@@ -3390,15 +3435,16 @@ interface paths$k {
                     editions?: components$m["parameters"]["editions"];
                     /**
                      * Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
-                     *     skipOverridesResolution, withComponentIDs) overrides this alias.
+                     *     skipOverridesResolution, withComponentIDs, skipContentTypeResolution) overrides this alias.
                      *       - `canonical`: PUT-safe structure — patterns and overrides left
                      *         unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
                      *         (skipPatternResolution=true, skipOverridesResolution=true,
-                     *         withComponentIDs=true).
+                     *         withComponentIDs=true, skipContentTypeResolution=false).
                      *       - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
                      *         the expanded pattern nodes.
-                     *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
-                     *         and component `_id`s removed.
+                     *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved,
+                     *         component `_id`s removed, and each entry returned as stored
+                     *         (skipContentTypeResolution=true).
                      */
                     format?: components$m["parameters"]["format"];
                     /**
@@ -3789,6 +3835,11 @@ interface components$m {
             _patternDataResources?: {
                 [key: string]: components$m["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$m["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -4353,6 +4404,12 @@ interface components$m {
          *     Prefer selecting a `format` rather than using this option.
          */
         skipOverridesResolution: boolean;
+        /**
+         * Improves performance by skipping dynamic data revalidations; appropriate for content delivery.
+         *     Default: true when `format` is delivery. False otherwise.
+         *     Prefer selecting a `format` rather than using this option.
+         */
+        skipContentTypeResolution: boolean;
         /**
          * One or more locales to filter and localize by.
          *     Only entries that enable one of the specified locales _or enable no locales_ will be returned.
@@ -4407,15 +4464,16 @@ interface components$m {
         editions: "auto" | "all" | "raw";
         /**
          * Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
-         *     skipOverridesResolution, withComponentIDs) overrides this alias.
+         *     skipOverridesResolution, withComponentIDs, skipContentTypeResolution) overrides this alias.
          *       - `canonical`: PUT-safe structure — patterns and overrides left
          *         unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
          *         (skipPatternResolution=true, skipOverridesResolution=true,
-         *         withComponentIDs=true).
+         *         withComponentIDs=true, skipContentTypeResolution=false).
          *       - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
          *         the expanded pattern nodes.
-         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
-         *         and component `_id`s removed.
+         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved,
+         *         component `_id`s removed, and each entry returned as stored
+         *         (skipContentTypeResolution=true).
          */
         format: "canonical" | "editor" | "delivery";
         /**
@@ -6222,6 +6280,12 @@ interface components$e {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -6311,6 +6375,11 @@ interface components$e {
             _patternDataResources?: {
                 [key: string]: components$e["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$e["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -6474,6 +6543,11 @@ interface components$e {
             _patternDataResources?: {
                 [key: string]: components$e["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$e["schemas"]["DataResourceDefinitions"];
             _patternError?: components$e["schemas"]["PatternError"];
             /**
@@ -6508,6 +6582,12 @@ interface components$e {
             _overridability?: components$e["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -7593,6 +7673,12 @@ interface components$d {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -7682,6 +7768,11 @@ interface components$d {
             _patternDataResources?: {
                 [key: string]: components$d["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$d["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -7845,6 +7936,11 @@ interface components$d {
             _patternDataResources?: {
                 [key: string]: components$d["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$d["schemas"]["DataResourceDefinitions"];
             _patternError?: components$d["schemas"]["PatternError"];
             /**
@@ -7879,6 +7975,12 @@ interface components$d {
             _overridability?: components$d["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -8701,6 +8803,12 @@ interface components$b {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -8790,6 +8898,11 @@ interface components$b {
             _patternDataResources?: {
                 [key: string]: components$b["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$b["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -8953,6 +9066,11 @@ interface components$b {
             _patternDataResources?: {
                 [key: string]: components$b["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$b["schemas"]["DataResourceDefinitions"];
             _patternError?: components$b["schemas"]["PatternError"];
             /**
@@ -8987,6 +9105,12 @@ interface components$b {
             _overridability?: components$b["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -10141,6 +10265,12 @@ interface components$a {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -10230,6 +10360,11 @@ interface components$a {
             _patternDataResources?: {
                 [key: string]: components$a["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$a["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -10393,6 +10528,11 @@ interface components$a {
             _patternDataResources?: {
                 [key: string]: components$a["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$a["schemas"]["DataResourceDefinitions"];
             _patternError?: components$a["schemas"]["PatternError"];
             /**
@@ -10427,6 +10567,12 @@ interface components$a {
             _overridability?: components$a["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -15418,6 +15564,7 @@ declare const createUniformApiEnhancer: ({ apiUrl }: {
     _patternDataResources?: {
         [key: string]: components$q["schemas"]["DataResourceDefinition"];
     };
+    _patternOptedInQueryStrings?: string[];
     _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
     _patternError?: components$q["schemas"]["PatternError"];
     _overrides?: {
@@ -15428,6 +15575,7 @@ declare const createUniformApiEnhancer: ({ apiUrl }: {
     };
     _overridability?: components$q["schemas"]["ComponentOverridability"];
     _locales?: string[];
+    _optedInQueryStrings?: string[];
 }>;
 
 /**
@@ -15661,7 +15809,7 @@ declare function hasReferencedVariables(value: string | undefined): number;
  */
 declare function parseVariableExpression(serialized: string, onToken?: (token: string, type: 'text' | 'variable', offset: number) => void | false): number;
 
-declare const version = "20.78.0";
+declare const version = "20.79.1";
 
 /** API client to enable managing workflow definitions */
 declare class WorkflowClient extends ApiClient {

package/dist/index.d.ts

@@ -571,6 +571,11 @@ interface components$q {
             _patternDataResources?: {
                 [key: string]: components$q["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$q["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -644,6 +649,11 @@ interface components$q {
             _patternDataResources?: {
                 [key: string]: components$q["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
             _patternError?: components$q["schemas"]["PatternError"];
             /**
@@ -678,6 +688,12 @@ interface components$q {
             _overridability?: components$q["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /**
          * Defines how to override a specific component.
@@ -1145,6 +1161,12 @@ interface components$q {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -1610,6 +1632,11 @@ interface components$p {
             _patternDataResources?: {
                 [key: string]: components$p["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$p["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -2414,6 +2441,11 @@ interface components$o {
             _patternDataResources?: {
                 [key: string]: components$o["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$o["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -2685,17 +2717,24 @@ interface components$o {
         keyword: string;
         /**
          * Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
-         *     skipOverridesResolution, withComponentIDs) overrides this alias.
+         *     skipOverridesResolution, withComponentIDs, skipContentTypeResolution) overrides this alias.
          *       - `canonical`: PUT-safe structure — patterns and overrides left
          *         unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
          *         (skipPatternResolution=true, skipOverridesResolution=true,
-         *         withComponentIDs=true).
+         *         withComponentIDs=true, skipContentTypeResolution=false).
          *       - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
          *         the expanded pattern nodes.
-         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
-         *         and component `_id`s removed.
+         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved,
+         *         component `_id`s removed, and each entry returned as stored
+         *         (skipContentTypeResolution=true).
          */
         format: "canonical" | "editor" | "delivery";
+        /**
+         * Improves performance by skipping dynamic data revalidations; appropriate for content delivery.
+         *     Default: true when `format` is delivery. False otherwise.
+         *     Prefer selecting a `format` rather than using this option.
+         */
+        skipContentTypeResolution: boolean;
         /**
          * If true, any pattern references in the composition will be left unresolved.
          *     This is appropriate if you intend to serialize the composition without patterns
@@ -3336,6 +3375,12 @@ interface paths$k {
                      *     Prefer selecting a `format` rather than using this option.
                      */
                     skipOverridesResolution?: components$m["parameters"]["skipOverridesResolution"];
+                    /**
+                     * Improves performance by skipping dynamic data revalidations; appropriate for content delivery.
+                     *     Default: true when `format` is delivery. False otherwise.
+                     *     Prefer selecting a `format` rather than using this option.
+                     */
+                    skipContentTypeResolution?: components$m["parameters"]["skipContentTypeResolution"];
                     /**
                      * One or more locales to filter and localize by.
                      *     Only entries that enable one of the specified locales _or enable no locales_ will be returned.
@@ -3390,15 +3435,16 @@ interface paths$k {
                     editions?: components$m["parameters"]["editions"];
                     /**
                      * Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
-                     *     skipOverridesResolution, withComponentIDs) overrides this alias.
+                     *     skipOverridesResolution, withComponentIDs, skipContentTypeResolution) overrides this alias.
                      *       - `canonical`: PUT-safe structure — patterns and overrides left
                      *         unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
                      *         (skipPatternResolution=true, skipOverridesResolution=true,
-                     *         withComponentIDs=true).
+                     *         withComponentIDs=true, skipContentTypeResolution=false).
                      *       - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
                      *         the expanded pattern nodes.
-                     *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
-                     *         and component `_id`s removed.
+                     *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved,
+                     *         component `_id`s removed, and each entry returned as stored
+                     *         (skipContentTypeResolution=true).
                      */
                     format?: components$m["parameters"]["format"];
                     /**
@@ -3789,6 +3835,11 @@ interface components$m {
             _patternDataResources?: {
                 [key: string]: components$m["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$m["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -4353,6 +4404,12 @@ interface components$m {
          *     Prefer selecting a `format` rather than using this option.
          */
         skipOverridesResolution: boolean;
+        /**
+         * Improves performance by skipping dynamic data revalidations; appropriate for content delivery.
+         *     Default: true when `format` is delivery. False otherwise.
+         *     Prefer selecting a `format` rather than using this option.
+         */
+        skipContentTypeResolution: boolean;
         /**
          * One or more locales to filter and localize by.
          *     Only entries that enable one of the specified locales _or enable no locales_ will be returned.
@@ -4407,15 +4464,16 @@ interface components$m {
         editions: "auto" | "all" | "raw";
         /**
          * Specify a format you want the results in. Any explicit shaping flag (skipPatternResolution,
-         *     skipOverridesResolution, withComponentIDs) overrides this alias.
+         *     skipOverridesResolution, withComponentIDs, skipContentTypeResolution) overrides this alias.
          *       - `canonical`: PUT-safe structure — patterns and overrides left
          *         unresolved and component `_id`s included. This is the format the Uniform CLI uses when syncing.
          *         (skipPatternResolution=true, skipOverridesResolution=true,
-         *         withComponentIDs=true).
+         *         withComponentIDs=true, skipContentTypeResolution=false).
          *       - `editor`: For loading into a Uniform editor - same as canonical, but with patterns expanded (skipPatternResolution=false). Still PUT-safe — the PUT ignores
          *         the expanded pattern nodes.
-         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved
-         *         and component `_id`s removed.
+         *       - `delivery`: default structure for serving to a frontend — patterns and overrides resolved,
+         *         component `_id`s removed, and each entry returned as stored
+         *         (skipContentTypeResolution=true).
          */
         format: "canonical" | "editor" | "delivery";
         /**
@@ -6222,6 +6280,12 @@ interface components$e {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -6311,6 +6375,11 @@ interface components$e {
             _patternDataResources?: {
                 [key: string]: components$e["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$e["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -6474,6 +6543,11 @@ interface components$e {
             _patternDataResources?: {
                 [key: string]: components$e["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$e["schemas"]["DataResourceDefinitions"];
             _patternError?: components$e["schemas"]["PatternError"];
             /**
@@ -6508,6 +6582,12 @@ interface components$e {
             _overridability?: components$e["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -7593,6 +7673,12 @@ interface components$d {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -7682,6 +7768,11 @@ interface components$d {
             _patternDataResources?: {
                 [key: string]: components$d["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$d["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -7845,6 +7936,11 @@ interface components$d {
             _patternDataResources?: {
                 [key: string]: components$d["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$d["schemas"]["DataResourceDefinitions"];
             _patternError?: components$d["schemas"]["PatternError"];
             /**
@@ -7879,6 +7975,12 @@ interface components$d {
             _overridability?: components$d["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -8701,6 +8803,12 @@ interface components$b {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -8790,6 +8898,11 @@ interface components$b {
             _patternDataResources?: {
                 [key: string]: components$b["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$b["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -8953,6 +9066,11 @@ interface components$b {
             _patternDataResources?: {
                 [key: string]: components$b["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$b["schemas"]["DataResourceDefinitions"];
             _patternError?: components$b["schemas"]["PatternError"];
             /**
@@ -8987,6 +9105,12 @@ interface components$b {
             _overridability?: components$b["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -10141,6 +10265,12 @@ interface components$a {
             value?: string;
             /** Help text for authors who might be setting up a preview value for this query string */
             helpText?: string;
+            /**
+             * Controls whether a global query string is always shown in Canvas or must be opted into.
+             *     This property is ignored on node-level query strings. When omitted, the query string is always shown.
+
+             */
+            editorVisibility?: "opt-in";
             /** Configuration for providing a list of allowed values for this query string */
             optionsSource?: {
                 /**
@@ -10230,6 +10360,11 @@ interface components$a {
             _patternDataResources?: {
                 [key: string]: components$a["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _patternError?: components$a["schemas"]["PatternError"];
             /**
              * Defines patch overrides to component IDs that live in the composition.
@@ -10393,6 +10528,11 @@ interface components$a {
             _patternDataResources?: {
                 [key: string]: components$a["schemas"]["DataResourceDefinition"];
             };
+            /**
+             * Query-string opt-ins coming from a pattern resolved for this component.
+             *     Means nothing for PUTs; it will be ignored
+             */
+            _patternOptedInQueryStrings?: string[];
             _dataResources?: components$a["schemas"]["DataResourceDefinitions"];
             _patternError?: components$a["schemas"]["PatternError"];
             /**
@@ -10427,6 +10567,12 @@ interface components$a {
             _overridability?: components$a["schemas"]["ComponentOverridability"];
             /** Array of locales which have data defined on the composition. If empty, the current default locale implicitly has data */
             _locales?: string[];
+            /**
+             * Names of opt-in global query strings surfaced in the Canvas editor for this composition or pattern.
+             *     Opt-ins coming from a resolved pattern move to _patternOptedInQueryStrings, so this always
+             *     holds only what was authored here. Omitted whenever overrides are resolved.
+             */
+            _optedInQueryStrings?: string[];
         };
         /** Permissions for a workflow stage */
         WorkflowStagePermission: {
@@ -15418,6 +15564,7 @@ declare const createUniformApiEnhancer: ({ apiUrl }: {
     _patternDataResources?: {
         [key: string]: components$q["schemas"]["DataResourceDefinition"];
     };
+    _patternOptedInQueryStrings?: string[];
     _dataResources?: components$q["schemas"]["DataResourceDefinitions"];
     _patternError?: components$q["schemas"]["PatternError"];
     _overrides?: {
@@ -15428,6 +15575,7 @@ declare const createUniformApiEnhancer: ({ apiUrl }: {
     };
     _overridability?: components$q["schemas"]["ComponentOverridability"];
     _locales?: string[];
+    _optedInQueryStrings?: string[];
 }>;
 
 /**
@@ -15661,7 +15809,7 @@ declare function hasReferencedVariables(value: string | undefined): number;
  */
 declare function parseVariableExpression(serialized: string, onToken?: (token: string, type: 'text' | 'variable', offset: number) => void | false): number;
 
-declare const version = "20.78.0";
+declare const version = "20.79.1";
 
 /** API client to enable managing workflow definitions */
 declare class WorkflowClient extends ApiClient {

package/dist/index.esm.js

@@ -1469,7 +1469,8 @@ function walkNodeTree(node, visitor, options) {
               "_dataResources",
               "_overridability",
               "_overrides",
-              "_patternDataResources"
+              "_patternDataResources",
+              "_patternOptedInQueryStrings"
             ];
             propertiesToCheck.forEach((property) => {
               if (!replacementComponent[property]) {
@@ -4001,7 +4002,7 @@ function handleRichTextNodeBinding(object, options) {
 import { ApiClientError as ApiClientError5 } from "@uniformdev/context/api";
 
 // src/.version.ts
-var version = "20.78.0";
+var version = "20.79.1";
 
 // src/WorkflowClient.ts
 import { ApiClient as ApiClient18 } from "@uniformdev/context/api";

package/dist/index.js

@@ -1684,7 +1684,8 @@ function walkNodeTree(node, visitor, options) {
               "_dataResources",
               "_overridability",
               "_overrides",
-              "_patternDataResources"
+              "_patternDataResources",
+              "_patternOptedInQueryStrings"
             ];
             propertiesToCheck.forEach((property) => {
               if (!replacementComponent[property]) {
@@ -4216,7 +4217,7 @@ function handleRichTextNodeBinding(object, options) {
 var import_api27 = require("@uniformdev/context/api");
 
 // src/.version.ts
-var version = "20.78.0";
+var version = "20.79.1";
 
 // src/WorkflowClient.ts
 var import_api26 = require("@uniformdev/context/api");

package/dist/index.mjs

@@ -1469,7 +1469,8 @@ function walkNodeTree(node, visitor, options) {
               "_dataResources",
               "_overridability",
               "_overrides",
-              "_patternDataResources"
+              "_patternDataResources",
+              "_patternOptedInQueryStrings"
             ];
             propertiesToCheck.forEach((property) => {
               if (!replacementComponent[property]) {
@@ -4001,7 +4002,7 @@ function handleRichTextNodeBinding(object, options) {
 import { ApiClientError as ApiClientError5 } from "@uniformdev/context/api";
 
 // src/.version.ts
-var version = "20.78.0";
+var version = "20.79.1";
 
 // src/WorkflowClient.ts
 import { ApiClient as ApiClient18 } from "@uniformdev/context/api";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniformdev/canvas",
-  "version": "20.78.0",
+  "version": "20.79.1",
   "description": "Common functionality and types for Uniform Canvas",
   "license": "SEE LICENSE IN LICENSE.txt",
   "main": "./dist/index.js",
@@ -36,9 +36,9 @@
     "svix": "1.96.0"
   },
   "dependencies": {
-    "@uniformdev/assets": "20.78.0",
-    "@uniformdev/context": "20.78.0",
-    "@uniformdev/richtext": "20.78.0",
+    "@uniformdev/assets": "20.79.1",
+    "@uniformdev/context": "20.79.1",
+    "@uniformdev/richtext": "20.79.1",
     "immer": "10.2.0",
     "p-limit": "6.2.0",
     "p-retry": "6.2.1",
@@ -50,5 +50,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "22d94ee916bde5e32c96995da69cfe479f87a9c9"
+  "gitHead": "a9709918bf00f79101fcc46bda36105626931933"
 }