@sanity/runtime-cli 17.7.1 → 17.8.0-blueprinit.g0993fa5

package/README.md

@@ -90,7 +90,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.7.1/src/commands/blueprints/add.ts)_
+_See code: [src/commands/blueprints/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/add.ts)_
 
 ## `sanity-run blueprints config`
 
@@ -127,7 +127,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.7.1/src/commands/blueprints/config.ts)_
+_See code: [src/commands/blueprints/config.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/config.ts)_
 
 ## `sanity-run blueprints deploy`
 
@@ -183,7 +183,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.7.1/src/commands/blueprints/deploy.ts)_
+_See code: [src/commands/blueprints/deploy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/deploy.ts)_
 
 ## `sanity-run blueprints destroy`
 
@@ -221,7 +221,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.7.1/src/commands/blueprints/destroy.ts)_
+_See code: [src/commands/blueprints/destroy.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/destroy.ts)_
 
 ## `sanity-run blueprints doctor`
 
@@ -253,7 +253,7 @@ EXAMPLES
   $ sanity-run blueprints doctor --fix
 ```
 
-_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.7.1/src/commands/blueprints/doctor.ts)_
+_See code: [src/commands/blueprints/doctor.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/doctor.ts)_
 
 ## `sanity-run blueprints info`
 
@@ -291,7 +291,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.7.1/src/commands/blueprints/info.ts)_
+_See code: [src/commands/blueprints/info.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/info.ts)_
 
 ## `sanity-run blueprints init [DIR]`
 
@@ -355,7 +355,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.7.1/src/commands/blueprints/init.ts)_
+_See code: [src/commands/blueprints/init.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/init.ts)_
 
 ## `sanity-run blueprints logs`
 
@@ -401,7 +401,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.7.1/src/commands/blueprints/logs.ts)_
+_See code: [src/commands/blueprints/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/logs.ts)_
 
 ## `sanity-run blueprints mint-deploy-token`
 
@@ -446,7 +446,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.7.1/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.8.0-blueprinit.g0993fa5/src/commands/blueprints/mint-deploy-token.ts)_
 
 ## `sanity-run blueprints plan`
 
@@ -479,7 +479,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.7.1/src/commands/blueprints/plan.ts)_
+_See code: [src/commands/blueprints/plan.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/plan.ts)_
 
 ## `sanity-run blueprints promote`
 
@@ -515,7 +515,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.7.1/src/commands/blueprints/promote.ts)_
+_See code: [src/commands/blueprints/promote.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/promote.ts)_
 
 ## `sanity-run blueprints stacks`
 
@@ -523,9 +523,11 @@ List remote Stack deployments for your project or organization
 
 ```
 USAGE
-  $ sanity-run blueprints stacks [--json] [--project-id <value> | --organization-id <value> | --include-projects]
+  $ sanity-run blueprints stacks [--json] [--project-id <value> | --organization-id <value> | --include-projects |
+    --all]
 
 FLAGS
+  --all                      List Stacks from every organization and project you have access to
   --include-projects         Include Stacks from all projects within the organization. Requires --organization-id.
   --json                     Format output as json
   --organization-id=<value>  Sanity organization ID used to scope Blueprint and Stack
@@ -539,11 +541,14 @@ DESCRIPTION
   Use this to discover existing Stacks you can scope a local Blueprint to (using 'blueprints config --edit'), or to
   audit what's deployed across your project.
 
-  Use --include-projects with --organization-id to also list Stacks from all projects within the organization.
+  Without a scope, prompts for an organization or project. Use --all to list Stacks across every organization and
+  project you can access, or --include-projects with --organization-id for one organization and its projects.
 
 EXAMPLES
   $ sanity-run blueprints stacks
 
+  $ sanity-run blueprints stacks --all
+
   $ sanity-run blueprints stacks --project-id <projectId>
 
   $ sanity-run blueprints stacks --organization-id <organizationId>
@@ -551,7 +556,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.7.1/src/commands/blueprints/stacks.ts)_
+_See code: [src/commands/blueprints/stacks.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/blueprints/stacks.ts)_
 
 ## `sanity-run functions add`
 
@@ -603,7 +608,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.7.1/src/commands/functions/add.ts)_
+_See code: [src/commands/functions/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/add.ts)_
 
 ## `sanity-run functions dev`
 
@@ -638,7 +643,7 @@ EXAMPLES
   $ sanity-run functions dev --timeout 60
 ```
 
-_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.7.1/src/commands/functions/dev.ts)_
+_See code: [src/commands/functions/dev.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/dev.ts)_
 
 ## `sanity-run functions env add NAME KEY VALUE`
 
@@ -671,7 +676,7 @@ EXAMPLES
   $ 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.7.1/src/commands/functions/env/add.ts)_
+_See code: [src/commands/functions/env/add.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/env/add.ts)_
 
 ## `sanity-run functions env list NAME`
 
@@ -701,7 +706,7 @@ EXAMPLES
   $ 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.7.1/src/commands/functions/env/list.ts)_
+_See code: [src/commands/functions/env/list.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/env/list.ts)_
 
 ## `sanity-run functions env remove NAME KEY`
 
@@ -733,7 +738,7 @@ EXAMPLES
   $ 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.7.1/src/commands/functions/env/remove.ts)_
+_See code: [src/commands/functions/env/remove.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/env/remove.ts)_
 
 ## `sanity-run functions logs [NAME]`
 
@@ -773,7 +778,7 @@ EXAMPLES
   $ sanity-run functions logs <name> --delete
 ```
 
-_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.7.1/src/commands/functions/logs.ts)_
+_See code: [src/commands/functions/logs.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/logs.ts)_
 
 ## `sanity-run functions test [NAME]`
 
@@ -830,7 +835,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.7.1/src/commands/functions/test.ts)_
+_See code: [src/commands/functions/test.ts](https://github.com/sanity-io/runtime-cli/blob/v17.8.0-blueprinit.g0993fa5/src/commands/functions/test.ts)_
 
 ## `sanity-run help [COMMAND]`
 

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

@@ -0,0 +1,34 @@
+export declare const STARTER_DOCUMENT_TYPE = "post";
+export declare const STARTER_FUNCTION_NAME = "set-slug";
+export declare const DEFAULT_STUDIO_NAME = "studio";
+export interface BlueprintManifestOptions {
+    projectName: string;
+    displayName: string;
+    projectId: string;
+    datasetName: string;
+    studioName: string;
+    studioSlug: string;
+    studioSrc: string;
+    studioOrigin: string;
+    withFunction: boolean;
+}
+export declare function renderBlueprint(options: BlueprintManifestOptions): string;
+export declare function hostedStudioOrigin(studioName: string, sanityEnv?: string): string;
+/**
+ * The Blueprint-local name for the attached project.
+ *
+ * Kept apart from the Stack name so a default Stack name can never collide with a
+ * resource name, and suffixed so a reference states which resource it reads.
+ */
+export declare function projectResourceName(baseName: string): string;
+/**
+ * The default name for the new Stack, which is also the hosted Studio slug.
+ *
+ * A Studio slug must be unique across every Sanity organization and no API can report
+ * whether one is free, so the default carries both the project and the dataset to make
+ * an accidental match unlikely.
+ */
+export declare function defaultStackName(baseName: string, datasetName: string): string;
+/** The slug form of a project display name, falling back to its ID. */
+export declare function projectBaseName(displayName: string, projectId: string): string;
+export declare function slugify(value: string): string;

package/dist/actions/blueprinit/manifest.js

@@ -0,0 +1,107 @@
+const quote = (value) => `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+export const STARTER_DOCUMENT_TYPE = 'post';
+export const STARTER_FUNCTION_NAME = 'set-slug';
+export const DEFAULT_STUDIO_NAME = 'studio';
+export function renderBlueprint(options) {
+    const { projectName, displayName, projectId, datasetName, studioName, studioSlug, studioSrc, studioOrigin, withFunction, } = options;
+    const definers = [
+        'defineBlueprint',
+        'defineCorsOrigin',
+        'defineDataset',
+        'defineProject',
+        'defineStudio',
+    ];
+    if (withFunction)
+        definers.splice(3, 0, 'defineDocumentFunction');
+    const project = quote(`$.resources.${projectName}.id`);
+    const inlineImport = `import {${definers.join(', ')}} from '@sanity/blueprints'`;
+    const imports = inlineImport.length > 100
+        ? `import {\n${definers.map((definer) => `  ${definer},`).join('\n')}\n} from '@sanity/blueprints'`
+        : inlineImport;
+    const functionResource = withFunction
+        ? `    defineDocumentFunction({
+      name: ${quote(STARTER_FUNCTION_NAME)},
+      displayName: 'Set slug',
+      project: ${project},
+      event: {
+        on: ['create', 'update'],
+        filter: "_type == '${STARTER_DOCUMENT_TYPE}' && !defined(slug.current)",
+        projection: '{_id, title, slug}',
+      },
+    }),
+`
+        : '';
+    return `${imports}
+
+export default defineBlueprint({
+  resources: [
+    defineProject({
+      name: ${quote(projectName)},
+      displayName: ${quote(displayName)},
+      lifecycle: {
+        deletionPolicy: 'retain',
+        ownershipAction: {type: 'attach', id: ${quote(projectId)}},
+      },
+    }),
+    defineDataset({
+      project: ${project},
+      name: ${quote(datasetName)},
+      lifecycle: {
+        deletionPolicy: 'retain',
+        ownershipAction: {
+          type: 'attach',
+          id: ${quote(datasetName)},
+          projectId: ${project},
+        },
+      },
+    }),
+    defineCorsOrigin({
+      project: ${project},
+      name: ${quote(`${studioName}-cors`)},
+      origin: ${quote(studioOrigin)},
+      allowCredentials: true,
+    }),
+    defineStudio({
+      project: ${project},
+      name: ${quote(studioName)},
+      slug: ${quote(studioSlug)},
+      title: ${quote(displayName)},
+      src: ${quote(studioSrc)},
+    }),
+${functionResource}  ],
+})
+`;
+}
+export function hostedStudioOrigin(studioName, sanityEnv) {
+    const hostname = sanityEnv?.toLowerCase() === 'staging' ? 'studio.sanity.work' : 'sanity.studio';
+    return `https://${studioName}.${hostname}`;
+}
+/**
+ * The Blueprint-local name for the attached project.
+ *
+ * Kept apart from the Stack name so a default Stack name can never collide with a
+ * resource name, and suffixed so a reference states which resource it reads.
+ */
+export function projectResourceName(baseName) {
+    return `${baseName}-project`;
+}
+/**
+ * The default name for the new Stack, which is also the hosted Studio slug.
+ *
+ * A Studio slug must be unique across every Sanity organization and no API can report
+ * whether one is free, so the default carries both the project and the dataset to make
+ * an accidental match unlikely.
+ */
+export function defaultStackName(baseName, datasetName) {
+    return `${baseName}-${datasetName}`;
+}
+/** The slug form of a project display name, falling back to its ID. */
+export function projectBaseName(displayName, projectId) {
+    return slugify(displayName) || projectId;
+}
+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,73 @@
+export declare function renderStudioConfig(options: {
+    displayName: string;
+    projectId: string;
+    datasetName: string;
+}): string;
+/**
+ * `sanity dev` and `sanity build` read the project and dataset from here, not from
+ * `sanity.config.ts`, and fail with `No CLI config found` when the file is absent.
+ *
+ * `sanity init` also writes a `deployment.autoUpdates` block. It is left out because it only
+ * affects `sanity deploy`, and the Blueprint's `defineStudio` already declares auto-updates.
+ */
+export declare function renderStudioCliConfig(options: {
+    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 interface StudioVersions {
+    sanity: string;
+    vision: string;
+}
+export declare const studioPackageJson: (name: string, versions: StudioVersions) => {
+    name: string;
+    version: string;
+    private: boolean;
+    license: string;
+    keywords: string[];
+    scripts: {
+        dev: string;
+        build: string;
+    };
+    dependencies: {
+        '@sanity/vision': string;
+        react: string;
+        'react-dom': string;
+        sanity: string;
+        'styled-components': string;
+    };
+    devDependencies: {
+        '@types/react': string;
+        typescript: string;
+    };
+};
+/** Copied from `templates/shared/tsconfig.json` in `@sanity/cli`. */
+export declare const STUDIO_TSCONFIG: {
+    compilerOptions: {
+        target: string;
+        lib: string[];
+        allowJs: boolean;
+        skipLibCheck: boolean;
+        strict: boolean;
+        forceConsistentCasingInFileNames: boolean;
+        module: string;
+        moduleDetection: string;
+        isolatedModules: boolean;
+        jsx: string;
+        incremental: boolean;
+    };
+    include: string[];
+    exclude: 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,138 @@
+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 {visionTool} from '@sanity/vision'
+import {schemaTypes} from './schemaTypes'
+
+export default defineConfig({
+  name: 'default',
+  title: ${quote(options.displayName)},
+  projectId: ${quote(options.projectId)},
+  dataset: ${quote(options.datasetName)},
+  plugins: [structureTool(), visionTool()],
+  schema: {types: schemaTypes},
+})
+`;
+}
+/**
+ * `sanity dev` and `sanity build` read the project and dataset from here, not from
+ * `sanity.config.ts`, and fail with `No CLI config found` when the file is absent.
+ *
+ * `sanity init` also writes a `deployment.autoUpdates` block. It is left out because it only
+ * affects `sanity deploy`, and the Blueprint's `defineStudio` already declares auto-updates.
+ */
+export function renderStudioCliConfig(options) {
+    return `import {defineCliConfig} from 'sanity/cli'
+
+export default defineCliConfig({
+  api: {
+    projectId: ${quote(options.projectId)},
+    dataset: ${quote(options.datasetName)},
+  },
+})
+`;
+}
+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}\`)
+})
+`;
+/**
+ * Versions `sanity init` pins itself, in `studioDependencies` in `@sanity/cli`.
+ *
+ * `sanity` and `@sanity/vision` are resolved at scaffold time instead, the way that command
+ * resolves them, so a Studio here matches the one `sanity init` would have written.
+ */
+const REACT_VERSION = '^19.2.4';
+const STYLED_COMPONENTS_VERSION = '^6.1.18';
+const TYPES_REACT_VERSION = '^19.2.14';
+const TYPESCRIPT_VERSION = '^5.8';
+export const studioPackageJson = (name, versions) => ({
+    name,
+    version: '1.0.0',
+    private: true,
+    license: 'UNLICENSED',
+    keywords: ['sanity'],
+    // The Blueprint deploys this Studio, so there is no `sanity deploy` script.
+    // Running one would create a second hosted Studio that the Stack does not own.
+    scripts: {
+        dev: 'sanity dev',
+        build: 'sanity build',
+    },
+    dependencies: {
+        '@sanity/vision': versions.vision,
+        react: REACT_VERSION,
+        'react-dom': REACT_VERSION,
+        sanity: versions.sanity,
+        'styled-components': STYLED_COMPONENTS_VERSION,
+    },
+    devDependencies: {
+        '@types/react': TYPES_REACT_VERSION,
+        typescript: TYPESCRIPT_VERSION,
+    },
+});
+/** Copied from `templates/shared/tsconfig.json` in `@sanity/cli`. */
+export const STUDIO_TSCONFIG = {
+    compilerOptions: {
+        target: 'ES2017',
+        lib: ['dom', 'dom.iterable', 'esnext'],
+        allowJs: true,
+        skipLibCheck: true,
+        strict: true,
+        forceConsistentCasingInFileNames: true,
+        module: 'Preserve',
+        moduleDetection: 'force',
+        isolatedModules: true,
+        jsx: 'preserve',
+        incremental: true,
+    },
+    include: ['**/*.ts', '**/*.tsx'],
+    exclude: ['node_modules'],
+};
+export const functionPackageJson = (name) => ({
+    name,
+    version: '0.1.0',
+    private: true,
+    type: 'module',
+    dependencies: {
+        '@sanity/client': '^8',
+        '@sanity/functions': '^1',
+    },
+});

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

@@ -0,0 +1,24 @@
+import { type StudioVersions } from './templates.js';
+export interface WorkspaceOptions {
+    dir: string;
+    projectId: string;
+    displayName: string;
+    datasetName: string;
+    stackName: string;
+    /** Blueprint-local name for the attached project resource. */
+    projectName: string;
+    studioName: string;
+    studioSlug: string;
+    studioOrigin: string;
+    blueprintsVersion: string;
+}
+export interface ScaffoldOptions extends WorkspaceOptions {
+    /** Resolved at scaffold time, the way `sanity init` resolves its own Studio versions. */
+    studioVersions: StudioVersions;
+}
+export interface WorkspaceResult {
+    blueprintFilePath: string;
+    files: string[];
+}
+export declare function scaffoldWorkspace(options: ScaffoldOptions): WorkspaceResult;
+export declare function adoptWorkspace(options: WorkspaceOptions): WorkspaceResult;