@nodii/dev 0.6.13 → 0.6.14

package/dist/figma.js

@@ -242,6 +242,41 @@ export async function figmaScopeAdd(id, scopes, { request = devRequest } = {}) {
   return changeSetCall(id, request)("POST", `/api/v1/design/change-sets/${encode(id)}/scopes`, { scopes });
 }
 
+/**
+ * Narrows a held set to exactly these scopes (Dev issue 104,
+ * setDesignChangeSetScopes); the rest is released for other sets. Each must
+ * sit inside what the set holds: the whole file holds everything, a page its
+ * components and creates.
+ */
+export async function figmaScopeSet(id, scopes, { request = devRequest } = {}) {
+  if (!id || !scopes.length) throw new CliError("USAGE", `figma scope set CHANGE_SET ${SCOPE_USAGE} [--scope ...]`, 2);
+  try {
+    return await request("PUT", `/api/v1/design/change-sets/${encode(id)}/scopes`, { scopes });
+  } catch (error) {
+    if (error?.code === "SCOPE_NOT_NARROWER")
+      throw new CliError(error.code, `${error.message}\nscope set only narrows; to claim more, run nodii-dev figma scope add ${id} --scope ...`, error.exitCode ?? 1, error.details);
+    if (error?.code === "WRITE_OUT_OF_SCOPE")
+      throw new CliError(
+        error.code,
+        [
+          error.message,
+          ...(error.details?.nodeIds?.length ? [`Would fall outside: ${error.details.nodeIds.join(", ")}`] : []),
+          `Keep a scope that holds them (styles and variables need --scope foundations), or revert those nodes to how they were at ${id}'s base version.`,
+        ].join("\n"),
+        error.exitCode ?? 1,
+        error.details,
+      );
+    throw scopeRefusal(error, id) ?? error;
+  }
+}
+
+/** What a narrowing left the set holding, and what it released. */
+export const figmaScopeSetText = (id, data) =>
+  [
+    `${id} holds ${data?.scopes?.length ?? 0} scope(s): ${(data?.scopes ?? []).map(scopeText).join(", ") || "none"}`,
+    ...(data?.released?.length ? [`Released for other sets: ${data.released.map(scopeText).join(", ")}`] : []),
+  ].join("\n");
+
 export const figmaSubmit = (id, payload, { request = devRequest } = {}) =>
   changeSetCall(id, request)("POST", `/api/v1/design/change-sets/${encode(id)}/submit`, payload);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodii/dev",
-  "version": "0.6.13",
+  "version": "0.6.14",
   "description": "Agent CLI for Nodii Dev, reached through the platform edge",
   "type": "module",
   "bin": {