@sanity/runtime-cli 17.2.0 → 17.3.0-blueprinit.g6a63623

package/README.md

@@ -20,7 +20,7 @@ $ npm install -g @sanity/runtime-cli
 $ sanity-run COMMAND
 running command...
 $ sanity-run (--version)
-@sanity/runtime-cli/17.2.0 linux-x64 node-v24.18.0
+@sanity/runtime-cli/17.3.0-blueprinit.g6a63623 linux-x64 node-v24.18.0
 $ sanity-run --help [COMMAND]
 USAGE
   $ sanity-run COMMAND
@@ -103,7 +103,7 @@ EXAMPLES
   $ sanity-run blueprints add function --name my-function --fn-type document-create --fn-type document-update --lang js
 ```
 
-_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -140,7 +140,7 @@ EXAMPLES
   $ sanity-run blueprints config --edit --project-id <projectId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -194,7 +194,7 @@ EXAMPLES
   $ sanity-run blueprints deploy --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -232,7 +232,7 @@ EXAMPLES
   $ sanity-run blueprints destroy --stack <name-or-id> --project-id <projectId> --force --no-wait
 ```
 
-_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -264,7 +264,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -301,7 +301,7 @@ EXAMPLES
   $ sanity-run blueprints info --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -365,7 +365,7 @@ EXAMPLES
   $ sanity-run blueprints init old-stack --type <json|js|ts> --project-id <projectId> --stack-id <existingStackId>
 ```
 
-_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -411,7 +411,7 @@ EXAMPLES
   $ sanity-run blueprints logs --before 2026-05-01T00:00:00Z
 ```
 
-_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -456,7 +456,7 @@ EXAMPLES
   $ sanity-run blueprints mint-deploy-token --organization-id <orgId>
 ```
 
-_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/mint-deploy-token.ts)_
+_See code: [src/commands/blueprints/mint-deploy-token.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -489,7 +489,7 @@ EXAMPLES
   $ sanity-run blueprints plan --organization-id <orgId> --stack <name-or-id>
 ```
 
-_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -525,7 +525,7 @@ EXAMPLES
   $ sanity-run blueprints promote --new-stack-name <new-name>
 ```
 
-_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -561,7 +561,7 @@ EXAMPLES
   $ sanity-run blueprints stacks --organization-id <organizationId> --include-projects
 ```
 
-_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -613,7 +613,7 @@ EXAMPLES
   $ sanity-run functions add --name my-function --type document-create --type document-update --lang js
 ```
 
-_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -648,7 +648,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -656,7 +656,7 @@ Add or set an environment variable for a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env add NAME KEY VALUE [--json]
+  $ sanity-run functions env add NAME KEY VALUE [--json] [--stack <value>]
 
 ARGUMENTS
   NAME   The name of the Sanity Function
@@ -664,7 +664,8 @@ ARGUMENTS
   VALUE  The value of the environment variable
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   Add or set an environment variable for a deployed function
@@ -676,9 +677,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env add MyFunction API_URL https://api.example.com/
+
+  $ sanity-run functions env add --stack <name-or-id> MyFunction API_URL https://api.example.com/
 ```
 
-_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -686,13 +689,14 @@ List environment variables for a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env list NAME [--json]
+  $ sanity-run functions env list NAME [--json] [--stack <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   List environment variables for a deployed function
@@ -703,9 +707,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env list MyFunction
+
+  $ sanity-run functions env list --stack <name-or-id> MyFunction
 ```
 
-_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -713,14 +719,15 @@ Remove an environment variable from a deployed function
 
 ```
 USAGE
-  $ sanity-run functions env remove NAME KEY [--json]
+  $ sanity-run functions env remove NAME KEY [--json] [--stack <value>]
 
 ARGUMENTS
   NAME  The name of the Sanity Function
   KEY   The name of the environment variable
 
 FLAGS
-  --json  Format output as json
+  --json           Format output as json
+  --stack=<value>  Stack name or ID to use instead of the locally configured Stack
 
 DESCRIPTION
   Remove an environment variable from a deployed function
@@ -732,9 +739,11 @@ DESCRIPTION
 
 EXAMPLES
   $ sanity-run functions env remove MyFunction API_URL
+
+  $ sanity-run functions env remove --stack <name-or-id> MyFunction API_URL
 ```
 
-_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -774,7 +783,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -831,7 +840,7 @@ EXAMPLES
   $ sanity-run functions test <name> --event update --data-before '{ "title": "before" }' --data-after '{ "title": "after" }'
 ```
 
-_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.2.0/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.3.0-blueprinit.g6a63623/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 
@@ -851,5 +860,5 @@ DESCRIPTION
   Display help for sanity-run.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.53/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/6.2.55/src/commands/help.ts)_
 <!-- commandsstop -->

package/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: runtime-cli
+description: Use the Sanity Runtime CLI for Blueprints and Functions workflows. Use when an agent needs to run or explain sanity-run commands, especially unattended command flows, local Blueprint management, Stack operations, Function development, or the experimental blueprinit command.
+---
+
+# Sanity Runtime CLI
+
+Use `sanity-run <command> --help` for flags and arguments. Use
+`sanity-run <command> --llms` (or `--skill`) for the agent-oriented workflow and examples for that
+command.
+
+Read only the command skill relevant to the task:
+
+- `blueprinit` → `skills/blueprinit.md`
+- `blueprints deploy` → `skills/blueprints-deploy.md`
+- `functions test` → `skills/functions-test.md`
+
+Derive other filenames by joining the command words with hyphens.
+
+Command skills are added incrementally. If one is absent, inspect the command's `--help` output and
+the repository implementation before acting.

package/dist/actions/blueprinit/manifest.d.ts

@@ -0,0 +1,13 @@
+export declare const STARTER_DOCUMENT_TYPE = "post";
+export declare const STARTER_FUNCTION_NAME = "set-slug";
+export interface BlueprintManifestOptions {
+    projectName: string;
+    displayName: string;
+    projectId: string;
+    datasetName: string;
+    studioName: string;
+    studioSrc: string;
+    withFunction: boolean;
+}
+export declare function renderBlueprint(options: BlueprintManifestOptions): string;
+export declare function slugify(value: string): string;

package/dist/actions/blueprinit/manifest.js

@@ -0,0 +1,57 @@
+const quote = (value) => `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+export const STARTER_DOCUMENT_TYPE = 'post';
+export const STARTER_FUNCTION_NAME = 'set-slug';
+export function renderBlueprint(options) {
+    const { projectName, displayName, projectId, datasetName, studioName, studioSrc, withFunction } = options;
+    const definers = ['defineBlueprint', 'defineDataset', 'defineProject', 'defineStudio'];
+    if (withFunction)
+        definers.splice(2, 0, 'defineDocumentFunction');
+    const functionResource = withFunction
+        ? `    defineDocumentFunction({
+      name: ${quote(STARTER_FUNCTION_NAME)},
+      project: ${quote(projectId)},
+      event: {
+        on: ['create', 'update'],
+        filter: "_type == '${STARTER_DOCUMENT_TYPE}' && !defined(slug.current)",
+        projection: '{_id, title, slug}',
+      },
+    }),
+`
+        : '';
+    // Project references stay literal until the deploy API can resolve resource references here.
+    return `import {${definers.join(', ')}} from '@sanity/blueprints'
+
+export default defineBlueprint({
+  resources: [
+    defineProject({
+      name: ${quote(projectName)},
+      displayName: ${quote(displayName)},
+      lifecycle: {
+        deletionPolicy: 'retain',
+        ownershipAction: {type: 'attach', id: ${quote(projectId)}},
+      },
+    }),
+    defineDataset({
+      name: ${quote(datasetName)},
+      project: ${quote(projectId)},
+      lifecycle: {
+        deletionPolicy: 'retain',
+        ownershipAction: {type: 'attach', id: ${quote(datasetName)}, projectId: ${quote(projectId)}},
+      },
+    }),
+    defineStudio({
+      name: ${quote(studioName)},
+      src: ${quote(studioSrc)},
+      autoUpdates: {enabled: true},
+      project: ${quote(projectId)},
+    }),
+${functionResource}  ],
+})
+`;
+}
+export function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}

package/dist/actions/blueprinit/studio.d.ts

@@ -0,0 +1,6 @@
+export interface DetectedStudio {
+    configFile: string;
+    projectId?: string;
+    dataset?: string;
+}
+export declare function detectStudio(dir: string): DetectedStudio | undefined;

package/dist/actions/blueprinit/studio.js

@@ -0,0 +1,43 @@
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+const STUDIO_CONFIG_PATTERN = /^sanity\.config\.[cm]?[jt]sx?$/;
+const STUDIO_CLI_PATTERN = /^sanity\.cli\.[cm]?[jt]sx?$/;
+export function detectStudio(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true })
+            .filter((entry) => entry.isFile())
+            .map((entry) => entry.name);
+    }
+    catch {
+        return undefined;
+    }
+    const configFile = entries.find((name) => STUDIO_CONFIG_PATTERN.test(name));
+    if (!configFile)
+        return undefined;
+    const detected = { configFile };
+    const cliFile = entries.find((name) => STUDIO_CLI_PATTERN.test(name));
+    for (const file of [configFile, cliFile]) {
+        if (!file)
+            continue;
+        const source = readSource(join(dir, file));
+        if (!source)
+            continue;
+        detected.projectId ??= extractLiteral(source, 'projectId');
+        detected.dataset ??= extractLiteral(source, 'dataset');
+        if (detected.projectId && detected.dataset)
+            break;
+    }
+    return detected;
+}
+function readSource(filePath) {
+    try {
+        return readFileSync(filePath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function extractLiteral(source, key) {
+    return source.match(new RegExp(`\\b${key}\\s*:\\s*(['"\`])([^'"\`\\\\]+)\\1`))?.[2];
+}

package/dist/actions/blueprinit/templates.d.ts

@@ -0,0 +1,34 @@
+export declare function renderStudioConfig(options: {
+    displayName: string;
+    projectId: string;
+    datasetName: string;
+}): string;
+export declare const STUDIO_SCHEMA_TYPES = "import {post} from './post'\n\nexport const schemaTypes = [post]\n";
+export declare const STUDIO_POST_TYPE = "import {defineField, defineType} from 'sanity'\n\nexport const post = defineType({\n  name: 'post',\n  title: 'Post',\n  type: 'document',\n  fields: [\n    defineField({name: 'title', type: 'string', validation: (rule) => rule.required()}),\n    // The set-slug function fills this when it is empty.\n    defineField({name: 'slug', type: 'slug', options: {source: 'title'}}),\n    defineField({name: 'publishedAt', title: 'Published at', type: 'datetime'}),\n    defineField({name: 'body', type: 'text'}),\n  ],\n})\n";
+export declare const FUNCTION_SET_SLUG = "import {createClient} from '@sanity/client'\nimport {documentEventHandler} from '@sanity/functions'\n\nconst slugify = (title: string) =>\n  title\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .slice(0, 96)\n\nexport const handler = documentEventHandler(async ({context, event}) => {\n  const {_id, title, slug} = event.data\n  if (!title || slug?.current) return\n\n  const client = createClient({apiVersion: '2025-05-01', ...context.clientOptions})\n  const current = slugify(title)\n  await client.patch(_id).set({slug: {_type: 'slug', current}}).commit()\n\n  console.log(`Set slug for ${_id}: ${current}`)\n})\n";
+export declare const studioPackageJson: (name: string) => {
+    name: string;
+    version: string;
+    private: boolean;
+    scripts: {
+        dev: string;
+        build: string;
+        deploy: string;
+    };
+    dependencies: {
+        react: string;
+        'react-dom': string;
+        sanity: string;
+        'styled-components': string;
+    };
+};
+export declare const functionPackageJson: (name: string) => {
+    name: string;
+    version: string;
+    private: boolean;
+    type: string;
+    dependencies: {
+        '@sanity/client': string;
+        '@sanity/functions': string;
+    };
+};

package/dist/actions/blueprinit/templates.js

@@ -0,0 +1,83 @@
+import { STARTER_DOCUMENT_TYPE, STARTER_FUNCTION_NAME } from './manifest.js';
+const quote = (value) => `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+export function renderStudioConfig(options) {
+    return `import {defineConfig} from 'sanity'
+import {structureTool} from 'sanity/structure'
+import {schemaTypes} from './schemaTypes'
+
+export default defineConfig({
+  name: 'default',
+  title: ${quote(options.displayName)},
+  projectId: ${quote(options.projectId)},
+  dataset: ${quote(options.datasetName)},
+  plugins: [structureTool()],
+  schema: {types: schemaTypes},
+})
+`;
+}
+export const STUDIO_SCHEMA_TYPES = `import {post} from './post'
+
+export const schemaTypes = [post]
+`;
+export const STUDIO_POST_TYPE = `import {defineField, defineType} from 'sanity'
+
+export const post = defineType({
+  name: '${STARTER_DOCUMENT_TYPE}',
+  title: 'Post',
+  type: 'document',
+  fields: [
+    defineField({name: 'title', type: 'string', validation: (rule) => rule.required()}),
+    // The ${STARTER_FUNCTION_NAME} function fills this when it is empty.
+    defineField({name: 'slug', type: 'slug', options: {source: 'title'}}),
+    defineField({name: 'publishedAt', title: 'Published at', type: 'datetime'}),
+    defineField({name: 'body', type: 'text'}),
+  ],
+})
+`;
+export const FUNCTION_SET_SLUG = `import {createClient} from '@sanity/client'
+import {documentEventHandler} from '@sanity/functions'
+
+const slugify = (title: string) =>
+  title
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '')
+    .slice(0, 96)
+
+export const handler = documentEventHandler(async ({context, event}) => {
+  const {_id, title, slug} = event.data
+  if (!title || slug?.current) return
+
+  const client = createClient({apiVersion: '2025-05-01', ...context.clientOptions})
+  const current = slugify(title)
+  await client.patch(_id).set({slug: {_type: 'slug', current}}).commit()
+
+  console.log(\`Set slug for \${_id}: \${current}\`)
+})
+`;
+export const studioPackageJson = (name) => ({
+    name,
+    version: '0.1.0',
+    private: true,
+    scripts: {
+        dev: 'sanity dev',
+        build: 'sanity build',
+        deploy: 'sanity deploy',
+    },
+    dependencies: {
+        react: '^19',
+        'react-dom': '^19',
+        sanity: '^4',
+        'styled-components': '^6',
+    },
+});
+export const functionPackageJson = (name) => ({
+    name,
+    version: '0.1.0',
+    private: true,
+    type: 'module',
+    dependencies: {
+        '@sanity/client': '^7',
+        '@sanity/functions': '^1',
+    },
+});

package/dist/actions/blueprinit/workspace.d.ts

@@ -0,0 +1,15 @@
+export interface WorkspaceOptions {
+    dir: string;
+    projectId: string;
+    displayName: string;
+    datasetName: string;
+    stackName: string;
+    studioName: string;
+    blueprintsVersion: string;
+}
+export interface WorkspaceResult {
+    blueprintFilePath: string;
+    files: string[];
+}
+export declare function scaffoldWorkspace(options: WorkspaceOptions): WorkspaceResult;
+export declare function adoptWorkspace(options: WorkspaceOptions): WorkspaceResult;

package/dist/actions/blueprinit/workspace.js

@@ -0,0 +1,142 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, posix } from 'node:path';
+import { renderBlueprint, STARTER_FUNCTION_NAME } from './manifest.js';
+import { FUNCTION_SET_SLUG, functionPackageJson, renderStudioConfig, STUDIO_POST_TYPE, STUDIO_SCHEMA_TYPES, studioPackageJson, } from './templates.js';
+const GITIGNORE_ENTRY = '# Sanity Blueprints\n.sanity/';
+const DEFAULT_GITIGNORE = `node_modules
+.env
+
+${GITIGNORE_ENTRY}
+`;
+export function scaffoldWorkspace(options) {
+    const { dir, studioName } = options;
+    assertTargetsAvailable(dir, [
+        posix.join('studios', studioName),
+        posix.join('functions', STARTER_FUNCTION_NAME),
+    ]);
+    const packageJson = preparePackageJson(options, ['studios/*', 'functions/*']);
+    const files = [];
+    const write = createWriter(dir, files);
+    const blueprintFilePath = write('sanity.blueprint.ts', renderBlueprint({
+        ...manifestOptions(options),
+        studioSrc: `./studios/${studioName}`,
+        withFunction: true,
+    }));
+    write(posix.join('studios', studioName, 'package.json'), formatJson(studioPackageJson(studioName)));
+    write(posix.join('studios', studioName, 'sanity.config.ts'), renderStudioConfig(options));
+    write(posix.join('studios', studioName, 'schemaTypes', 'index.ts'), STUDIO_SCHEMA_TYPES);
+    write(posix.join('studios', studioName, 'schemaTypes', 'post.ts'), STUDIO_POST_TYPE);
+    write(posix.join('studios', studioName, 'static', '.gitkeep'), '');
+    write(posix.join('functions', STARTER_FUNCTION_NAME, 'package.json'), formatJson(functionPackageJson(STARTER_FUNCTION_NAME)));
+    write(posix.join('functions', STARTER_FUNCTION_NAME, 'index.ts'), FUNCTION_SET_SLUG);
+    writePreparedRootFiles(dir, packageJson, files);
+    return { blueprintFilePath, files };
+}
+export function adoptWorkspace(options) {
+    const { dir } = options;
+    const packageJson = preparePackageJson(options, []);
+    const files = [];
+    const write = createWriter(dir, files);
+    const blueprintFilePath = write('sanity.blueprint.ts', renderBlueprint({ ...manifestOptions(options), studioSrc: '.', withFunction: false }));
+    writePreparedRootFiles(dir, packageJson, files);
+    return { blueprintFilePath, files };
+}
+function manifestOptions(options) {
+    return {
+        projectName: options.stackName,
+        displayName: options.displayName,
+        projectId: options.projectId,
+        datasetName: options.datasetName,
+        studioName: options.studioName,
+    };
+}
+function assertTargetsAvailable(dir, paths) {
+    const conflicts = paths.filter((path) => existsSync(join(dir, path)));
+    if (conflicts.length > 0) {
+        throw new Error(`Refusing to overwrite existing paths: ${conflicts.join(', ')}`);
+    }
+}
+function createWriter(dir, files) {
+    return (relativePath, content) => {
+        const filePath = join(dir, relativePath);
+        mkdirSync(dirname(filePath), { recursive: true });
+        writeFileSync(filePath, content);
+        files.push(relativePath);
+        return filePath;
+    };
+}
+function writePreparedRootFiles(dir, packageJson, files) {
+    if (writeGitignore(dir))
+        files.push('.gitignore');
+    writeFileSync(join(dir, 'package.json'), formatJson(packageJson));
+    files.push('package.json');
+}
+function writeGitignore(dir) {
+    const filePath = join(dir, '.gitignore');
+    if (!existsSync(filePath)) {
+        writeFileSync(filePath, DEFAULT_GITIGNORE);
+        return true;
+    }
+    const existing = readFileSync(filePath, 'utf8');
+    if (existing.split(/\r?\n/).some((line) => line.trim() === '.sanity/'))
+        return false;
+    writeFileSync(filePath, `${existing.trimEnd()}\n\n${GITIGNORE_ENTRY}\n`);
+    return true;
+}
+function preparePackageJson(options, requiredWorkspaces) {
+    const filePath = join(options.dir, 'package.json');
+    const parsed = existsSync(filePath)
+        ? JSON.parse(readFileSync(filePath, 'utf8'))
+        : {
+            name: options.stackName,
+            version: '0.1.0',
+            private: true,
+            type: 'module',
+        };
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('The existing package.json must contain a JSON object.');
+    }
+    const packageJson = parsed;
+    addWorkspaces(packageJson, requiredWorkspaces);
+    addBlueprintsDependency(packageJson, options.blueprintsVersion);
+    return packageJson;
+}
+function addWorkspaces(packageJson, required) {
+    if (required.length === 0)
+        return;
+    if (!packageJson.workspaces) {
+        packageJson.workspaces = required;
+        return;
+    }
+    if (Array.isArray(packageJson.workspaces)) {
+        packageJson.workspaces = [...new Set([...packageJson.workspaces, ...required])];
+        return;
+    }
+    if (!packageJson.workspaces || typeof packageJson.workspaces !== 'object') {
+        throw new Error('Cannot add generated packages to the existing package.json workspaces.');
+    }
+    const workspaces = packageJson.workspaces;
+    if (Array.isArray(workspaces.packages)) {
+        workspaces.packages = [...new Set([...workspaces.packages, ...required])];
+        return;
+    }
+    throw new Error('Cannot add generated packages to the existing package.json workspaces.');
+}
+function addBlueprintsDependency(packageJson, blueprintsVersion) {
+    const dependencies = recordOrEmpty(packageJson.dependencies);
+    const devDependencies = recordOrEmpty(packageJson.devDependencies);
+    if (dependencies['@sanity/blueprints'] || devDependencies['@sanity/blueprints'])
+        return;
+    packageJson.devDependencies = {
+        ...devDependencies,
+        '@sanity/blueprints': blueprintsVersion,
+    };
+}
+function recordOrEmpty(value) {
+    return value && typeof value === 'object' && !Array.isArray(value)
+        ? value
+        : {};
+}
+function formatJson(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}