@utdk/figma 0.37.0-20260408.5-dev.646adf4

package/docs/comments.md

@@ -0,0 +1,114 @@
+# Comments
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getComments`
+
+- **HTTP**: `GET /v1/files/{file_key}/comments`
+- **What it does**: Get comments in a file
+- **OpenAPI operationId**: `getComments`
+- **Path params**: `file_key`
+- **Query params**: `as_md`
+- **Response codes**: `200`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; as_md?: boolean }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ comments: ({ id: string; client_meta: { x: number; y: number } | { node_id: string; node_offset: { x: number; y: number } } | { x: number; y: number; region_height: number; region_width: number; comment_pin_corner?: "...`
+- OpenAPI response codes: `200`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetCommentsInput = Parameters<typeof figma.getComments> extends [infer T, ...unknown[]] ? T : undefined;
+type GetCommentsOutput = Awaited<ReturnType<typeof figma.getComments>>;
+
+const input: GetCommentsInput = {} as { file_key: string; as_md?: boolean };
+const result: GetCommentsOutput = await figma.getComments(input);
+
+// Result shape (from schema): { comments: ({ id: string; client_meta: { x: number; y: number } | { node_id: string; node_offset: { x: number; y: number } } | { x: number; y: number; region_height: number; region_width: number; comment_pin_corner?: "...
+```
+
+### `figma.postComment`
+
+- **HTTP**: `POST /v1/files/{file_key}/comments`
+- **What it does**: Add a comment to a file
+- **OpenAPI operationId**: `postComment`
+- **Path params**: `file_key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ message: string; comment_id?: string; client_meta?: { x: number; y: number } | { node_id: string; node_offset: { x: number; y: number } } | { x: number; y: number; region_height: number; region_width: number; comment_pin_corner?: "top-left" | "top-right" | "bottom-left" | "bottom-right" } | { node_id: string; node_offset: { x: number; y: number }; region_height: number; region_width: number; comment_pin_corner?: "top-left" | "top-right" | "bottom-left" | "bottom-right" }; file_key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ id: string; client_meta: { x: number; y: number } | { node_id: string; node_offset: { x: number; y: number } } | { x: number; y: number; region_height: number; region_width: number; comment_pin_corner?: "top-left" | "...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type PostCommentInput = Parameters<typeof figma.postComment> extends [infer T, ...unknown[]] ? T : undefined;
+type PostCommentOutput = Awaited<ReturnType<typeof figma.postComment>>;
+
+const input: PostCommentInput = {} as { message: string; comment_id?: string; client_meta?: { x: number; y: number } | { node_id: string; node_offset: { x: number; y: number } } | { x: number; y: number; region_height: number; region_width: number; comment_pin_corner?: "top-left" | "top-right" | "bottom-left" | "bottom-right" } | { node_id: string; node_offset: { x: number; y: number }; region_height: number; region_width: number; comment_pin_corner?: "top-left" | "top-right" | "bottom-left" | "bottom-right" }; file_key: string };
+const result: PostCommentOutput = await figma.postComment(input);
+
+// Result shape (from schema): { id: string; client_meta: { x: number; y: number } | { node_id: string; node_offset: { x: number; y: number } } | { x: number; y: number; region_height: number; region_width: number; comment_pin_corner?: "top-left" | "...
+```
+
+### `figma.deleteComment`
+
+- **HTTP**: `DELETE /v1/files/{file_key}/comments/{comment_id}`
+- **What it does**: Delete a comment
+- **OpenAPI operationId**: `deleteComment`
+- **Path params**: `file_key`, `comment_id`
+- **Query params**: None
+- **Response codes**: `200`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; comment_id: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false }`
+- OpenAPI response codes: `200`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type DeleteCommentInput = Parameters<typeof figma.deleteComment> extends [infer T, ...unknown[]] ? T : undefined;
+type DeleteCommentOutput = Awaited<ReturnType<typeof figma.deleteComment>>;
+
+const input: DeleteCommentInput = {} as { file_key: string; comment_id: string };
+const result: DeleteCommentOutput = await figma.deleteComment(input);
+
+// Result shape (from schema): { status: 200; error: false }
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/component-sets.md

@@ -0,0 +1,114 @@
+# Component Sets
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getComponentSet`
+
+- **HTTP**: `GET /v1/component_sets/{key}`
+- **What it does**: Get component set
+- **OpenAPI operationId**: `getComponentSet`
+- **Path params**: `key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; handle: string;...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetComponentSetInput = Parameters<typeof figma.getComponentSet> extends [infer T, ...unknown[]] ? T : undefined;
+type GetComponentSetOutput = Awaited<ReturnType<typeof figma.getComponentSet>>;
+
+const input: GetComponentSetInput = {} as { key: string };
+const result: GetComponentSetOutput = await figma.getComponentSet(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; handle: string;...
+```
+
+### `figma.getFileComponentSets`
+
+- **HTTP**: `GET /v1/files/{file_key}/component_sets`
+- **What it does**: Get file component sets
+- **OpenAPI operationId**: `getFileComponentSets`
+- **Path params**: `file_key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { component_sets: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: stri...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetFileComponentSetsInput = Parameters<typeof figma.getFileComponentSets> extends [infer T, ...unknown[]] ? T : undefined;
+type GetFileComponentSetsOutput = Awaited<ReturnType<typeof figma.getFileComponentSets>>;
+
+const input: GetFileComponentSetsInput = {} as { file_key: string };
+const result: GetFileComponentSetsOutput = await figma.getFileComponentSets(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { component_sets: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: stri...
+```
+
+### `figma.getTeamComponentSets`
+
+- **HTTP**: `GET /v1/teams/{team_id}/component_sets`
+- **What it does**: Get team component sets
+- **OpenAPI operationId**: `getTeamComponentSets`
+- **Path params**: `team_id`
+- **Query params**: `page_size`, `after`, `before`
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ team_id: string; page_size?: number; after?: number; before?: number }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { component_sets: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: stri...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetTeamComponentSetsInput = Parameters<typeof figma.getTeamComponentSets> extends [infer T, ...unknown[]] ? T : undefined;
+type GetTeamComponentSetsOutput = Awaited<ReturnType<typeof figma.getTeamComponentSets>>;
+
+const input: GetTeamComponentSetsInput = {} as { team_id: string; page_size?: number; after?: number; before?: number };
+const result: GetTeamComponentSetsOutput = await figma.getTeamComponentSets(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { component_sets: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: stri...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/components.md

@@ -0,0 +1,114 @@
+# Components
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.getComponent`
+
+- **HTTP**: `GET /v1/components/{key}`
+- **What it does**: Get component
+- **OpenAPI operationId**: `getComponent`
+- **Path params**: `key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; handle: string;...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetComponentInput = Parameters<typeof figma.getComponent> extends [infer T, ...unknown[]] ? T : undefined;
+type GetComponentOutput = Awaited<ReturnType<typeof figma.getComponent>>;
+
+const input: GetComponentInput = {} as { key: string };
+const result: GetComponentOutput = await figma.getComponent(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; handle: string;...
+```
+
+### `figma.getFileComponents`
+
+- **HTTP**: `GET /v1/files/{file_key}/components`
+- **What it does**: Get file components
+- **OpenAPI operationId**: `getFileComponents`
+- **Path params**: `file_key`
+- **Query params**: None
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { components: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; ...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetFileComponentsInput = Parameters<typeof figma.getFileComponents> extends [infer T, ...unknown[]] ? T : undefined;
+type GetFileComponentsOutput = Awaited<ReturnType<typeof figma.getFileComponents>>;
+
+const input: GetFileComponentsInput = {} as { file_key: string };
+const result: GetFileComponentsOutput = await figma.getFileComponents(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { components: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; ...
+```
+
+### `figma.getTeamComponents`
+
+- **HTTP**: `GET /v1/teams/{team_id}/components`
+- **What it does**: Get team components
+- **OpenAPI operationId**: `getTeamComponents`
+- **Path params**: `team_id`
+- **Query params**: `page_size`, `after`, `before`
+- **Response codes**: `200`, `400`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ team_id: string; page_size?: number; after?: number; before?: number }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ status: 200; error: false; meta: { components: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; ...`
+- OpenAPI response codes: `200`, `400`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetTeamComponentsInput = Parameters<typeof figma.getTeamComponents> extends [infer T, ...unknown[]] ? T : undefined;
+type GetTeamComponentsOutput = Awaited<ReturnType<typeof figma.getTeamComponents>>;
+
+const input: GetTeamComponentsInput = {} as { team_id: string; page_size?: number; after?: number; before?: number };
+const result: GetTeamComponentsOutput = await figma.getTeamComponents(input);
+
+// Result shape (from schema): { status: 200; error: false; meta: { components: ({ key: string; file_key: string; node_id: string; thumbnail_url?: string; name: string; description: string; created_at: string; updated_at: string; user: { id: string; ...
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->

package/docs/dev-resources.md

@@ -0,0 +1,148 @@
+# Dev Resources
+
+Use these operations through the generated client (not direct HTTP calls).
+
+Import path: `@utdk/figma`
+
+## Operations
+
+### `figma.postDevResources`
+
+- **HTTP**: `POST /v1/dev_resources`
+- **What it does**: Create dev resources
+- **OpenAPI operationId**: `postDevResources`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ dev_resources: ({ name: string; url: string; file_key: string; node_id: string })[] }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ links_created: ({ id: string; name: string; url: string; file_key: string; node_id: string })[]; errors?: ({ file_key?: string | null; node_id?: string | null; error: string })[] }`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type PostDevResourcesInput = Parameters<typeof figma.postDevResources> extends [infer T, ...unknown[]] ? T : undefined;
+type PostDevResourcesOutput = Awaited<ReturnType<typeof figma.postDevResources>>;
+
+const input: PostDevResourcesInput = {} as { dev_resources: ({ name: string; url: string; file_key: string; node_id: string })[] };
+const result: PostDevResourcesOutput = await figma.postDevResources(input);
+
+// Result shape (from schema): { links_created: ({ id: string; name: string; url: string; file_key: string; node_id: string })[]; errors?: ({ file_key?: string | null; node_id?: string | null; error: string })[] }
+```
+
+### `figma.putDevResources`
+
+- **HTTP**: `PUT /v1/dev_resources`
+- **What it does**: Update dev resources
+- **OpenAPI operationId**: `putDevResources`
+- **Path params**: None
+- **Query params**: None
+- **Response codes**: `200`, `400`, `401`, `403`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ dev_resources: ({ id: string; name?: string; url?: string })[] }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ links_updated?: ({ id: string; name: string; url: string; file_key: string; node_id: string })[]; errors?: ({ id?: string; error: string })[] }`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type PutDevResourcesInput = Parameters<typeof figma.putDevResources> extends [infer T, ...unknown[]] ? T : undefined;
+type PutDevResourcesOutput = Awaited<ReturnType<typeof figma.putDevResources>>;
+
+const input: PutDevResourcesInput = {} as { dev_resources: ({ id: string; name?: string; url?: string })[] };
+const result: PutDevResourcesOutput = await figma.putDevResources(input);
+
+// Result shape (from schema): { links_updated?: ({ id: string; name: string; url: string; file_key: string; node_id: string })[]; errors?: ({ id?: string; error: string })[] }
+```
+
+### `figma.getDevResources`
+
+- **HTTP**: `GET /v1/files/{file_key}/dev_resources`
+- **What it does**: Get dev resources
+- **OpenAPI operationId**: `getDevResources`
+- **Path params**: `file_key`
+- **Query params**: `node_ids`
+- **Response codes**: `200`, `400`, `401`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; node_ids?: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `{ dev_resources: ({ id: string; name: string; url: string; file_key: string; node_id: string })[] }`
+- OpenAPI response codes: `200`, `400`, `401`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type GetDevResourcesInput = Parameters<typeof figma.getDevResources> extends [infer T, ...unknown[]] ? T : undefined;
+type GetDevResourcesOutput = Awaited<ReturnType<typeof figma.getDevResources>>;
+
+const input: GetDevResourcesInput = {} as { file_key: string; node_ids?: string };
+const result: GetDevResourcesOutput = await figma.getDevResources(input);
+
+// Result shape (from schema): { dev_resources: ({ id: string; name: string; url: string; file_key: string; node_id: string })[] }
+```
+
+### `figma.deleteDevResource`
+
+- **HTTP**: `DELETE /v1/files/{file_key}/dev_resources/{dev_resource_id}`
+- **What it does**: Delete dev resource
+- **OpenAPI operationId**: `deleteDevResource`
+- **Path params**: `file_key`, `dev_resource_id`
+- **Query params**: None
+- **Response codes**: `200`, `401`, `403`, `404`, `429`, `500`
+- **Transport options**: None
+- **Source**: [OpenAPI reference](https://www.figma.com/developers/api)
+- **TypeScript**: [Client interface](../types.ts)
+
+**Inputs**
+
+- Client input type: `{ file_key: string; dev_resource_id: string }`
+- Client transport options: None
+
+**Outputs**
+
+- Client return type: `unknown`
+- OpenAPI response codes: `200`, `401`, `403`, `404`, `429`, `500`
+
+```ts
+import figma from "@utdk/figma";
+
+type DeleteDevResourceInput = Parameters<typeof figma.deleteDevResource> extends [infer T, ...unknown[]] ? T : undefined;
+type DeleteDevResourceOutput = Awaited<ReturnType<typeof figma.deleteDevResource>>;
+
+const input: DeleteDevResourceInput = {} as { file_key: string; dev_resource_id: string };
+const result: DeleteDevResourceOutput = await figma.deleteDevResource(input);
+
+// Result shape (from schema): unknown
+```
+
+
+<!-- prompt-hash:
+8c3694991a4c289225f05a4e8f1e098cc74d085a088d7dffd82f00d93797b7f8
+-->