@webstudio-is/protocol 0.274.4 → 0.274.5

package/lib/index.js

@@ -5569,7 +5569,7 @@ var publicApiOperationDocumentation = [
     description: "Update page settings and metadata",
     requiredOptions: ["page", "json"],
     examples: [
-      'webstudio update-page --page page-id --title Pricing --description "Pricing plans" --json'
+      'webstudio update-page --page page-id --title "\\"Pricing\\"" --description "\\"Pricing plans\\"" --json'
     ]
   },
   {
@@ -5742,7 +5742,7 @@ var publicApiOperationDocumentation = [
   },
   {
     command: "update-props",
-    description: "Create or update element props; editor tokens are limited to content-mode props",
+    description: "Create or update direct element prop values; use this for fixed strings, numbers, booleans, JSON, assets, pages, parameters, and resources. Editor tokens are limited to content-mode props",
     requiredOptions: ["input", "json"],
     examples: ["webstudio update-props --input props.json --json"]
   },
@@ -5754,7 +5754,7 @@ var publicApiOperationDocumentation = [
   },
   {
     command: "bind-props",
-    description: "Bind element props to expressions, parameters, resources, or actions",
+    description: "Bind element props to dynamic expressions, parameters, resources, or actions. Do not use for fixed string values; use update-props instead",
     requiredOptions: ["input", "json"],
     examples: ["webstudio bind-props --input bindings.json --json"]
   },
@@ -6495,6 +6495,7 @@ var withDefaultPermit = (operation) => {
     permit: operation.permit ?? (operation.method === "query" ? "view" : "build"),
     description: documentation.description,
     inputFields: inputFieldsLookup[operation.command] ?? [],
+    inputFieldTypes: operation.inputFieldTypes ?? {},
     requiredOptions: documentation.requiredOptions,
     examples: documentation.examples,
     localCapable: runtimeOperation !== void 0,
@@ -6724,14 +6725,16 @@ var publicApiOperationInputs = [
     id: "instances.append",
     method: "mutation",
     path: "api.instances.append",
-    client: "appendInstance"
+    client: "appendInstance",
+    inputFieldTypes: { children: "array" }
   },
   {
     command: "move-instance",
     id: "instances.move",
     method: "mutation",
     path: "api.instances.move",
-    client: "moveInstance"
+    client: "moveInstance",
+    inputFieldTypes: { moves: "array" }
   },
   {
     command: "clone-instance",
@@ -6745,7 +6748,8 @@ var publicApiOperationInputs = [
     id: "instances.delete",
     method: "mutation",
     path: "api.instances.delete",
-    client: "deleteInstance"
+    client: "deleteInstance",
+    inputFieldTypes: { instanceIds: "array" }
   },
   {
     command: "update-props",
@@ -6753,7 +6757,8 @@ var publicApiOperationInputs = [
     method: "mutation",
     path: "api.instances.updateProps",
     client: "updateProps",
-    permit: "edit"
+    permit: "edit",
+    inputFieldTypes: { updates: "array" }
   },
   {
     command: "delete-props",
@@ -6761,14 +6766,16 @@ var publicApiOperationInputs = [
     method: "mutation",
     path: "api.instances.deleteProps",
     client: "deleteProps",
-    permit: "edit"
+    permit: "edit",
+    inputFieldTypes: { deletions: "array" }
   },
   {
     command: "bind-props",
     id: "instances.bindProps",
     method: "mutation",
     path: "api.instances.bindProps",
-    client: "bindProps"
+    client: "bindProps",
+    inputFieldTypes: { bindings: "array" }
   },
   {
     command: "list-texts",
@@ -6797,14 +6804,16 @@ var publicApiOperationInputs = [
     id: "styles.updateDeclarations",
     method: "mutation",
     path: "api.styles.updateDeclarations",
-    client: "updateStyleDeclarations"
+    client: "updateStyleDeclarations",
+    inputFieldTypes: { updates: "array" }
   },
   {
     command: "delete-styles",
     id: "styles.deleteDeclarations",
     method: "mutation",
     path: "api.styles.deleteDeclarations",
-    client: "deleteStyleDeclarations"
+    client: "deleteStyleDeclarations",
+    inputFieldTypes: { deletions: "array" }
   },
   {
     command: "replace-styles",
@@ -6825,42 +6834,48 @@ var publicApiOperationInputs = [
     id: "designTokens.create",
     method: "mutation",
     path: "api.designTokens.create",
-    client: "createDesignTokens"
+    client: "createDesignTokens",
+    inputFieldTypes: { tokens: "array" }
   },
   {
     command: "update-design-token-styles",
     id: "designTokens.updateStyles",
     method: "mutation",
     path: "api.designTokens.updateStyles",
-    client: "updateDesignTokenStyles"
+    client: "updateDesignTokenStyles",
+    inputFieldTypes: { updates: "array" }
   },
   {
     command: "delete-design-token-styles",
     id: "designTokens.deleteStyles",
     method: "mutation",
     path: "api.designTokens.deleteStyles",
-    client: "deleteDesignTokenStyles"
+    client: "deleteDesignTokenStyles",
+    inputFieldTypes: { deletions: "array" }
   },
   {
     command: "attach-design-token",
     id: "designTokens.attach",
     method: "mutation",
     path: "api.designTokens.attach",
-    client: "attachDesignToken"
+    client: "attachDesignToken",
+    inputFieldTypes: { instanceIds: "array" }
   },
   {
     command: "detach-design-token",
     id: "designTokens.detach",
     method: "mutation",
     path: "api.designTokens.detach",
-    client: "detachDesignToken"
+    client: "detachDesignToken",
+    inputFieldTypes: { instanceIds: "array" }
   },
   {
     command: "extract-design-token",
     id: "designTokens.extract",
     method: "mutation",
     path: "api.designTokens.extract",
-    client: "extractDesignToken"
+    client: "extractDesignToken",
+    inputFieldTypes: { instanceIds: "array", removeLocalProps: "array" }
   },
   {
     command: "list-css-variables",
@@ -6881,7 +6896,8 @@ var publicApiOperationInputs = [
     id: "cssVariables.delete",
     method: "mutation",
     path: "api.cssVariables.delete",
-    client: "deleteCssVariables"
+    client: "deleteCssVariables",
+    inputFieldTypes: { names: "array" }
   },
   {
     command: "rewrite-css-variable-refs",
@@ -7055,7 +7071,8 @@ var publicApiOperationInputs = [
     id: "assets.delete",
     method: "mutation",
     path: "api.assets.delete",
-    client: "deleteAssets"
+    client: "deleteAssets",
+    inputFieldTypes: { assetIdsOrPrefixes: "array" }
   }
 ];
 var publicApiOperations = publicApiOperationInputs.map(withDefaultPermit);

package/lib/types/builder-api/operations.d.ts

@@ -10,12 +10,14 @@ type PublicApiOperationInput = {
     client: string;
     permit?: PublicApiOperationPermit;
     invalidatesNamespaces?: readonly PublicApiOperationNamespace[];
+    inputFieldTypes?: Partial<Record<string, "array">>;
 };
 export type PublicApiOperation<Command extends string = string> = Omit<PublicApiOperationInput, "command" | "permit"> & {
     command: Command;
     permit: PublicApiOperationPermit;
     description: string;
     inputFields: readonly string[];
+    inputFieldTypes: Partial<Record<string, "array">>;
     requiredOptions?: readonly string[];
     examples: readonly string[];
     localCapable: boolean;
@@ -214,12 +216,18 @@ declare const publicApiOperationInputs: readonly [{
     readonly method: "mutation";
     readonly path: "api.instances.append";
     readonly client: "appendInstance";
+    readonly inputFieldTypes: {
+        readonly children: "array";
+    };
 }, {
     readonly command: "move-instance";
     readonly id: "instances.move";
     readonly method: "mutation";
     readonly path: "api.instances.move";
     readonly client: "moveInstance";
+    readonly inputFieldTypes: {
+        readonly moves: "array";
+    };
 }, {
     readonly command: "clone-instance";
     readonly id: "instances.clone";
@@ -232,6 +240,9 @@ declare const publicApiOperationInputs: readonly [{
     readonly method: "mutation";
     readonly path: "api.instances.delete";
     readonly client: "deleteInstance";
+    readonly inputFieldTypes: {
+        readonly instanceIds: "array";
+    };
 }, {
     readonly command: "update-props";
     readonly id: "instances.updateProps";
@@ -239,6 +250,9 @@ declare const publicApiOperationInputs: readonly [{
     readonly path: "api.instances.updateProps";
     readonly client: "updateProps";
     readonly permit: "edit";
+    readonly inputFieldTypes: {
+        readonly updates: "array";
+    };
 }, {
     readonly command: "delete-props";
     readonly id: "instances.deleteProps";
@@ -246,12 +260,18 @@ declare const publicApiOperationInputs: readonly [{
     readonly path: "api.instances.deleteProps";
     readonly client: "deleteProps";
     readonly permit: "edit";
+    readonly inputFieldTypes: {
+        readonly deletions: "array";
+    };
 }, {
     readonly command: "bind-props";
     readonly id: "instances.bindProps";
     readonly method: "mutation";
     readonly path: "api.instances.bindProps";
     readonly client: "bindProps";
+    readonly inputFieldTypes: {
+        readonly bindings: "array";
+    };
 }, {
     readonly command: "list-texts";
     readonly id: "instances.listTexts";
@@ -277,12 +297,18 @@ declare const publicApiOperationInputs: readonly [{
     readonly method: "mutation";
     readonly path: "api.styles.updateDeclarations";
     readonly client: "updateStyleDeclarations";
+    readonly inputFieldTypes: {
+        readonly updates: "array";
+    };
 }, {
     readonly command: "delete-styles";
     readonly id: "styles.deleteDeclarations";
     readonly method: "mutation";
     readonly path: "api.styles.deleteDeclarations";
     readonly client: "deleteStyleDeclarations";
+    readonly inputFieldTypes: {
+        readonly deletions: "array";
+    };
 }, {
     readonly command: "replace-styles";
     readonly id: "styles.replaceValues";
@@ -301,36 +327,55 @@ declare const publicApiOperationInputs: readonly [{
     readonly method: "mutation";
     readonly path: "api.designTokens.create";
     readonly client: "createDesignTokens";
+    readonly inputFieldTypes: {
+        readonly tokens: "array";
+    };
 }, {
     readonly command: "update-design-token-styles";
     readonly id: "designTokens.updateStyles";
     readonly method: "mutation";
     readonly path: "api.designTokens.updateStyles";
     readonly client: "updateDesignTokenStyles";
+    readonly inputFieldTypes: {
+        readonly updates: "array";
+    };
 }, {
     readonly command: "delete-design-token-styles";
     readonly id: "designTokens.deleteStyles";
     readonly method: "mutation";
     readonly path: "api.designTokens.deleteStyles";
     readonly client: "deleteDesignTokenStyles";
+    readonly inputFieldTypes: {
+        readonly deletions: "array";
+    };
 }, {
     readonly command: "attach-design-token";
     readonly id: "designTokens.attach";
     readonly method: "mutation";
     readonly path: "api.designTokens.attach";
     readonly client: "attachDesignToken";
+    readonly inputFieldTypes: {
+        readonly instanceIds: "array";
+    };
 }, {
     readonly command: "detach-design-token";
     readonly id: "designTokens.detach";
     readonly method: "mutation";
     readonly path: "api.designTokens.detach";
     readonly client: "detachDesignToken";
+    readonly inputFieldTypes: {
+        readonly instanceIds: "array";
+    };
 }, {
     readonly command: "extract-design-token";
     readonly id: "designTokens.extract";
     readonly method: "mutation";
     readonly path: "api.designTokens.extract";
     readonly client: "extractDesignToken";
+    readonly inputFieldTypes: {
+        readonly instanceIds: "array";
+        readonly removeLocalProps: "array";
+    };
 }, {
     readonly command: "list-css-variables";
     readonly id: "cssVariables.list";
@@ -349,6 +394,9 @@ declare const publicApiOperationInputs: readonly [{
     readonly method: "mutation";
     readonly path: "api.cssVariables.delete";
     readonly client: "deleteCssVariables";
+    readonly inputFieldTypes: {
+        readonly names: "array";
+    };
 }, {
     readonly command: "rewrite-css-variable-refs";
     readonly id: "cssVariables.rewriteRefs";
@@ -499,6 +547,9 @@ declare const publicApiOperationInputs: readonly [{
     readonly method: "mutation";
     readonly path: "api.assets.delete";
     readonly client: "deleteAssets";
+    readonly inputFieldTypes: {
+        readonly assetIdsOrPrefixes: "array";
+    };
 }];
 export declare const publicApiOperations: PublicApiOperation<"whoami" | "permissions" | "inspect" | "snapshot" | "apply-patch" | "list-pages" | "get-page" | "get-page-by-path" | "create-page" | "update-page" | "get-project-settings" | "update-project-settings" | "list-redirects" | "create-redirect" | "update-redirect" | "delete-redirect" | "list-breakpoints" | "create-breakpoint" | "update-breakpoint" | "delete-breakpoint" | "delete-page" | "duplicate-page" | "list-page-templates" | "create-page-from-template" | "list-folders" | "create-folder" | "update-folder" | "delete-folder" | "list-instances" | "inspect-instance" | "append-instance" | "move-instance" | "clone-instance" | "delete-instance" | "update-props" | "delete-props" | "bind-props" | "list-texts" | "update-text" | "get-styles" | "update-styles" | "delete-styles" | "replace-styles" | "list-design-tokens" | "create-design-token" | "update-design-token-styles" | "delete-design-token-styles" | "attach-design-token" | "detach-design-token" | "extract-design-token" | "list-css-variables" | "define-css-variable" | "delete-css-variable" | "rewrite-css-variable-refs" | "list-variables" | "create-variable" | "update-variable" | "delete-variable" | "list-resources" | "create-resource" | "update-resource" | "delete-resource" | "publish" | "list-publishes" | "get-publish-job" | "unpublish" | "list-domains" | "create-domain" | "update-domain" | "delete-domain" | "verify-domain" | "list-assets" | "upload-asset" | "upload-assets" | "find-asset-usage" | "replace-asset" | "delete-asset">[];
 export type PublicApiCommand = (typeof publicApiOperationInputs)[number]["command"];

package/package.json

@@ -1,19 +1,19 @@
 {
   "name": "@webstudio-is/protocol",
-  "version": "0.274.4",
+  "version": "0.274.5",
   "description": "Webstudio data exchange protocol contracts",
   "author": "Webstudio <github@webstudio.is>",
   "homepage": "https://webstudio.is",
   "type": "module",
   "dependencies": {
     "zod": "^3.24.2",
-    "@webstudio-is/sdk": "0.274.4"
+    "@webstudio-is/sdk": "0.274.5"
   },
   "devDependencies": {
     "vitest": "^3.1.2",
-    "@webstudio-is/tsconfig": "1.0.7",
-    "@webstudio-is/wsauth": "0.274.4",
-    "@webstudio-is/project-build": "0.0.0"
+    "@webstudio-is/project-build": "0.0.0",
+    "@webstudio-is/wsauth": "0.274.5",
+    "@webstudio-is/tsconfig": "1.0.7"
   },
   "exports": {
     ".": {