@sanity/runtime-cli 17.1.0 → 17.2.0-blueprinit.g62f8017

package/dist/cores/blueprinit/fresh.js

@@ -0,0 +1,88 @@
+import { STARTER_FUNCTION_NAME, slugify } from '../../actions/blueprinit/manifest.js';
+import { scaffoldWorkspace } from '../../actions/blueprinit/workspace.js';
+import { listDatasets } from '../../actions/sanity/datasets.js';
+import { groupProjectsByOrganization } from '../../actions/sanity/projects.js';
+import { check } from '../../utils/display/presenters.js';
+import { getLatestNpmVersion } from '../../utils/external/npmjs.js';
+import { isInteractive } from '../../utils/interactive.js';
+import { alignSteps, createStackAndFinish } from './finish.js';
+import { confirmUnlessSkipped, promptForStudioName } from './prompts.js';
+import { chooseDataset, chooseOrganization, chooseProject } from './selection.js';
+export async function freshFlow(options) {
+    const { bin, dir, flags, log, token } = options;
+    const grouped = await groupProjectsByOrganization({ token, logger: log });
+    if (!grouped.ok) {
+        return { success: false, error: `Could not list organizations: ${grouped.error}` };
+    }
+    const organizationResult = await chooseOrganization(grouped.organizations, flags.organizationId, isInteractive);
+    if (!organizationResult.ok) {
+        return {
+            success: false,
+            error: organizationResult.error.message,
+            suggestions: organizationResult.error.suggestions,
+        };
+    }
+    const { organization, projects = [] } = organizationResult.value;
+    const projectResult = await chooseProject(projects, flags.projectId, organization.name, isInteractive);
+    if (!projectResult.ok) {
+        return {
+            success: false,
+            error: projectResult.error.message,
+            suggestions: projectResult.error.suggestions,
+        };
+    }
+    const project = projectResult.value;
+    const datasets = await listDatasets({ token, projectId: project.id, logger: log });
+    if (!datasets.ok) {
+        return { success: false, error: `Could not list datasets: ${datasets.error}` };
+    }
+    const dataset = chooseDataset(datasets.datasets);
+    if (!dataset)
+        return { success: false, error: `No datasets found in ${project.displayName}.` };
+    log(check(`Org: ${organization.name} (${organization.id})`));
+    log(check(`Project: ${project.displayName} (${project.id}), dataset: ${dataset.name}`));
+    log('');
+    const confirmed = await confirmUnlessSkipped(flags, isInteractive, `Set up this directory as the workspace for "${project.displayName}"?`);
+    if (!confirmed)
+        return { success: false, error: 'Initialization cancelled.' };
+    const stackName = slugify(project.displayName) || project.id;
+    const studioName = await promptForStudioName(flags, isInteractive);
+    log('Files to write:');
+    log('  + sanity.blueprint.ts             project + dataset (attached), studio, function');
+    log(`  + ${`studios/${studioName}/`.padEnd(32)}Studio with a "post" type`);
+    log(`  + ${`functions/${STARTER_FUNCTION_NAME}/`.padEnd(32)}sets a post slug from its title`);
+    log(`  + .sanity/blueprint.config.json   org scope, stack ${stackName}`);
+    log('  + .gitignore');
+    log('  + package.json');
+    log('');
+    const scaffold = scaffoldWorkspace({
+        dir,
+        projectId: project.id,
+        displayName: project.displayName,
+        datasetName: dataset.name,
+        stackName,
+        studioName,
+        blueprintsVersion: await getLatestNpmVersion('@sanity/blueprints', log),
+    });
+    return await createStackAndFinish({
+        ...options,
+        organizationId: organization.id,
+        projectId: project.id,
+        datasetName: dataset.name,
+        stackName,
+        blueprintFilePath: scaffold.blueprintFilePath,
+        files: scaffold.files,
+        nextSteps: [
+            ...alignSteps([
+                ['npm install'],
+                [`npm run dev -w studios/${studioName}`, 'open the Studio and add a post'],
+                [`npx ${bin} blueprints plan`, 'preview the deployment'],
+                [`npx ${bin} blueprints deploy`, 'deploy the resources'],
+            ]),
+            '',
+            'Test the function on that post:',
+            `  npx ${bin} functions test ${STARTER_FUNCTION_NAME} --document-id <id>` +
+                ` --project-id ${project.id} --dataset ${dataset.name} --with-user-token`,
+        ],
+    });
+}

package/dist/cores/blueprinit/prompts.d.ts

@@ -0,0 +1,4 @@
+import type { BlueprinitFlags } from './types.js';
+export declare const DEFAULT_STUDIO_NAME = "studio";
+export declare function confirmUnlessSkipped(flags: BlueprinitFlags, interactive: boolean, message: string): Promise<boolean>;
+export declare function promptForStudioName(flags: BlueprinitFlags, interactive: boolean): Promise<string>;

package/dist/cores/blueprinit/prompts.js

@@ -0,0 +1,14 @@
+import { confirm, input } from '@inquirer/prompts';
+import { slugify } from '../../actions/blueprinit/manifest.js';
+export const DEFAULT_STUDIO_NAME = 'studio';
+export async function confirmUnlessSkipped(flags, interactive, message) {
+    if (flags.yes || !interactive)
+        return true;
+    return await confirm({ message, default: true });
+}
+export async function promptForStudioName(flags, interactive) {
+    if (flags.yes || !interactive)
+        return DEFAULT_STUDIO_NAME;
+    const answer = await input({ message: 'Name your studio?', default: DEFAULT_STUDIO_NAME });
+    return slugify(answer) || DEFAULT_STUDIO_NAME;
+}

package/dist/cores/blueprinit/selection.d.ts

@@ -0,0 +1,15 @@
+import type { Dataset } from '../../actions/sanity/datasets.js';
+import type { GroupedProjects, Project } from '../../actions/sanity/projects.js';
+import type { Result } from '../../utils/types.js';
+interface SelectionError {
+    message: string;
+    suggestions?: string[];
+}
+export declare function chooseOrganization(groups: GroupedProjects[], organizationId: string | undefined, interactive: boolean): Promise<Result<GroupedProjects, SelectionError>>;
+export declare function chooseProject(projects: Project[], projectId: string | undefined, organizationName: string, interactive: boolean): Promise<Result<Project, SelectionError>>;
+export declare function chooseDataset(datasets: Dataset[]): Dataset | undefined;
+export declare function findProject(groups: GroupedProjects[], projectId: string): {
+    organization: GroupedProjects['organization'];
+    project: Project;
+} | undefined;
+export {};

package/dist/cores/blueprinit/selection.js

@@ -0,0 +1,63 @@
+import { select } from '@inquirer/prompts';
+export async function chooseOrganization(groups, organizationId, interactive) {
+    if (groups.length === 0) {
+        return failure('No organizations found for this account.');
+    }
+    if (organizationId) {
+        const organization = groups.find((group) => group.organization.id === organizationId);
+        return organization
+            ? { ok: true, value: organization }
+            : failure(`No organization "${organizationId}" found for this account.`);
+    }
+    if (groups.length === 1)
+        return { ok: true, value: groups[0] };
+    if (!interactive) {
+        return failure('Multiple organizations found.', ['Pass --organization-id <id> to choose one.']);
+    }
+    const selectedId = await select({
+        message: 'Choose a Sanity organization:',
+        choices: groups.map(({ organization, projects }) => ({
+            name: organization.name,
+            value: organization.id,
+            description: `${projects?.length ?? 0} projects`,
+        })),
+    });
+    const selected = groups.find(({ organization }) => organization.id === selectedId);
+    return selected ? { ok: true, value: selected } : failure('Organization not found.');
+}
+export async function chooseProject(projects, projectId, organizationName, interactive) {
+    if (projects.length === 0) {
+        return failure(`No projects found in ${organizationName}.`);
+    }
+    if (projectId) {
+        const project = projects.find(({ id }) => id === projectId);
+        return project
+            ? { ok: true, value: project }
+            : failure(`No project "${projectId}" found in ${organizationName}.`);
+    }
+    if (projects.length === 1)
+        return { ok: true, value: projects[0] };
+    if (!interactive) {
+        return failure('Multiple projects found.', ['Pass --project-id <id> to choose one.']);
+    }
+    const selectedId = await select({
+        message: 'Choose a Sanity project:',
+        choices: projects.map((project) => ({ name: project.displayName, value: project.id })),
+    });
+    const selected = projects.find(({ id }) => id === selectedId);
+    return selected ? { ok: true, value: selected } : failure('Project not found.');
+}
+export function chooseDataset(datasets) {
+    return datasets.find(({ name }) => name === 'production') ?? datasets[0];
+}
+export function findProject(groups, projectId) {
+    for (const { organization, projects = [] } of groups) {
+        const project = projects.find(({ id }) => id === projectId);
+        if (project)
+            return { organization, project };
+    }
+    return undefined;
+}
+function failure(message, suggestions) {
+    return { ok: false, error: { message, suggestions } };
+}

package/dist/cores/blueprinit/types.d.ts

@@ -0,0 +1,13 @@
+import type { Logger } from '../../utils/logger.js';
+export interface BlueprinitFlags {
+    yes?: boolean;
+    organizationId?: string;
+    projectId?: string;
+}
+export interface BlueprinitFlowOptions {
+    bin: string;
+    dir: string;
+    flags: BlueprinitFlags;
+    log: Logger;
+    token: string;
+}

package/dist/cores/blueprinit/types.js

@@ -0,0 +1 @@
+export {};

package/dist/cores/blueprinit.d.ts

@@ -0,0 +1,7 @@
+import type { BlueprinitFlags } from './blueprinit/types.js';
+import type { CoreConfig, CoreResult } from './index.js';
+export interface BlueprinitOptions extends CoreConfig {
+    dir?: string;
+    flags?: BlueprinitFlags;
+}
+export declare function blueprinitCore(options: BlueprinitOptions): Promise<CoreResult>;

package/dist/cores/blueprinit.js

@@ -0,0 +1,39 @@
+import { cwd } from 'node:process';
+import { detectStudio } from '../actions/blueprinit/studio.js';
+import { findBlueprintFile } from '../actions/blueprints/blueprint.js';
+import { validTokenOrErrorMessage } from '../utils/validated-token.js';
+import { adoptFlow } from './blueprinit/adopt.js';
+import { freshFlow } from './blueprinit/fresh.js';
+export async function blueprinitCore(options) {
+    const { bin, log, flags = {}, dir = cwd() } = options;
+    try {
+        const existingBlueprint = findBlueprintFile(dir);
+        if (existingBlueprint) {
+            log(`A blueprint already exists here (${existingBlueprint.fileName}).`);
+            log('');
+            log('Use these instead:');
+            log(`  npx ${bin} blueprints config --edit`);
+            log(`  npx ${bin} blueprints doctor`);
+            return {
+                success: true,
+                json: { alreadyInitialized: true, blueprintFile: existingBlueprint.fileName },
+            };
+        }
+        const tokenCheck = await validTokenOrErrorMessage(log);
+        if (!tokenCheck.ok) {
+            return {
+                success: false,
+                error: 'No Sanity session found.',
+                suggestions: ['Sign in first: npx sanity login', 'Then run blueprinit again.'],
+            };
+        }
+        log('Setting up your Sanity workspace.');
+        log('');
+        const flowOptions = { bin, dir, flags, log, token: tokenCheck.value };
+        const studio = detectStudio(dir);
+        return studio ? await adoptFlow({ ...flowOptions, studio }) : await freshFlow(flowOptions);
+    }
+    catch (error) {
+        return { success: false, error: error instanceof Error ? error.message : String(error) };
+    }
+}

package/dist/cores/blueprints/deploy.js

@@ -1,5 +1,5 @@
 import { dirname } from 'node:path';
-import { stashAsset } from '../../actions/blueprints/assets.js';
+import { preDeploy } from '../../actions/blueprints/pre-deploy.js';
 import { getStack, updateStack } from '../../actions/blueprints/stacks.js';
 import { waitForOperation } from '../../actions/blueprints/wait-for-operation.js';
 import { checkUserPermission } from '../../actions/sanity/access.js';
@@ -7,19 +7,15 @@ import { createHintCollector } from '../../utils/blueprints/hints.js';
 import { niceId } from '../../utils/display/presenters.js';
 import { CODE_OPERATION_UNCONFIRMED, EXIT_OPERATION_UNCONFIRMED } from '../../utils/exit-codes.js';
 import { styleText } from '../../utils/style-text.js';
-import { isAssetResource } from '../../utils/types.js';
 import { getWarnings } from '../../utils/warnings.js';
-const DEFAULT_ASSET_TIMEOUT = 60;
-const assetTimeoutS = Number(process.env.SANITY_ASSET_TIMEOUT) || DEFAULT_ASSET_TIMEOUT;
-const assetTimeoutMs = assetTimeoutS * 1000;
-const warnTimeoutMs = assetTimeoutMs / 2;
 export async function blueprintDeployCore(options) {
     const { bin = 'sanity', log, auth, stackId, scopeType, scopeId, deployedStack, blueprint, flags, } = options;
     const { verbose } = flags;
     const noWait = flags['no-wait'] || false;
     const stackName = flags['new-stack-name'] ?? deployedStack.name;
     const installer = flags['fn-installer'] || undefined;
-    const workspaceWarnings = getWarnings({ dir: dirname(blueprint.fileInfo.blueprintFilePath) });
+    const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
+    const workspaceWarnings = getWarnings({ dir: blueprintFileDir });
     log(`Deploying "${stackName}" ${niceId(deployedStack.id)}...`);
     try {
         const { ok: checkOk, stack: currentStack } = await getStack({ stackId, auth, logger: log });
@@ -38,17 +34,21 @@ export async function blueprintDeployCore(options) {
             };
         }
         const resources = [...blueprint.resources];
-        const assetResources = resources.filter(isAssetResource);
-        if (assetResources.length > 0) {
-            log('Processing assets...');
-            for (const resource of assetResources) {
-                const preDeployResult = await preDeploy(resource, { auth, installer, log });
-                if (!preDeployResult.success)
-                    return preDeployResult;
-                const idx = resources.indexOf(resource);
-                if (idx !== -1)
-                    resources[idx] = preDeployResult.resource;
-            }
+        const preDeployResult = await preDeploy({
+            scopeType,
+            scopeId,
+            resources,
+            stackId,
+            stackName,
+            auth,
+            blueprintFileDir,
+            installer,
+            log,
+            bin,
+            verbose,
+        });
+        if (!preDeployResult?.success) {
+            return preDeployResult;
         }
         const spinner = log.ora('Deploying...').start();
         const { ok: deployOk, stack, error: deployError, } = await updateStack({
@@ -151,53 +151,6 @@ export async function blueprintDeployCore(options) {
         return { success: false, error: errorMessage };
     }
 }
-async function preDeploy(resource, options) {
-    const { auth, installer, log } = options;
-    const fnSpinner = log.ora({ text: `Processing ${resource.name}...`, prefixText: ' ' }).start();
-    const warnTimer = setTimeout(() => {
-        fnSpinner.text = `Still processing ${resource.name}, this can take a moment...`;
-    }, warnTimeoutMs);
-    let assetTimeoutTimer;
-    let result;
-    try {
-        result = await Promise.race([
-            stashAsset({ resource, auth, logger: log, installer }),
-            new Promise((_, reject) => {
-                assetTimeoutTimer = setTimeout(() => {
-                    reject(new Error(`Processing ${resource.name} timed out after ${assetTimeoutS}s`));
-                }, assetTimeoutMs);
-            }),
-        ]);
-    }
-    catch (err) {
-        const msg = err instanceof Error ? err.message : String(err);
-        fnSpinner.fail(msg);
-        return { success: false, error: msg };
-    }
-    finally {
-        clearTimeout(warnTimer);
-        clearTimeout(assetTimeoutTimer);
-    }
-    if (result.success && result.assetId) {
-        const updatedResource = { ...resource, src: result.assetId };
-        fnSpinner.succeed(`${updatedResource.name} ${niceId(result.assetId)}`);
-        log(`   Source: ${updatedResource.src}`);
-        if (result.hash) {
-            if (result.hash.length > 24) {
-                log.verbose(`   Hash: ${result.hash.slice(0, 8)}...${result.hash.slice(-12)}`);
-            }
-            else {
-                log.verbose(`   Hash: ${result.hash}`);
-            }
-        }
-        if (result.exists)
-            log.verbose('   Asset unchanged');
-        return { success: true, resource: updatedResource };
-    }
-    const errorMsg = `Failed uploading ${resource.name} asset, deploy has stopped`;
-    fnSpinner.fail(errorMsg);
-    return { success: false, error: result.error || 'Failed to process asset' };
-}
 const CHECK_LEGACY_DEPLOY_PERMISSION = false;
 const BLUEPRINTS_PERMISSION_ENFORCEMENT_DATE = 'July 1, 2026';
 async function checkLegacyDeployPermission({ auth, scopeType, scopeId, log, }) {

package/dist/cores/blueprints/doctor.js

@@ -2,13 +2,13 @@ import { readFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { arch, cwd, env, version as nodeVersion, platform } from 'node:process';
 import * as resolve from 'empathic/resolve';
-import ora from 'ora';
 import { loadAndParseBlueprint, } from '../../actions/blueprints/blueprint.js';
 import { readConfigFile } from '../../actions/blueprints/config.js';
 import { resolveIds } from '../../actions/blueprints/resolve.js';
 import { getStack } from '../../actions/blueprints/stacks.js';
 import config, { RUNTIME_CLI_VERSION } from '../../config.js';
 import { formatDateTime } from '../../utils/display/dates.js';
+import { presentBlueprintParserErrors } from '../../utils/display/errors.js';
 import { advise, check, filePathRelativeToCwd, niceId, renderSection, severe, unsure, } from '../../utils/display/presenters.js';
 import { styleText } from '../../utils/style-text.js';
 import { createTracedFetch } from '../../utils/traced-fetch.js';
@@ -55,7 +55,7 @@ export async function blueprintDoctorCore(options) {
         envRows.push(['CLI', bin]);
     const configRows = [];
     const stackRows = [];
-    const spinner = ora('Running diagnostics...').start();
+    const spinner = log.ora('Running diagnostics...').start();
     // --- ONLINE ---
     const fetchFn = createTracedFetch(log);
     try {
@@ -109,6 +109,7 @@ export async function blueprintDoctorCore(options) {
                 status: false,
                 detail: `${blueprint.errors.length} error(s)`,
             };
+            log.verbose(presentBlueprintParserErrors(blueprint.errors));
         }
     }
     catch {
@@ -186,6 +187,8 @@ export async function blueprintDoctorCore(options) {
                         stackRows.push(['Operation', `${op.status}${timestamp}`]);
                         if (op.userMessage)
                             stackRows.push(['  Message', `"${op.userMessage}"`]);
+                        if (v && op.systemMessage)
+                            stackRows.push(['  System', `"${op.systemMessage}"`]);
                     }
                     if (stack.resources) {
                         stackRows.push(['Resources', `${stack.resources.length}`]);
@@ -275,20 +278,20 @@ export async function blueprintDoctorCore(options) {
     }
     // --- RENDER REPORT ---
     spinner.stop();
-    // Environment (verbose)
-    log.verbose(renderSection('Environment', envRows));
-    log.verbose('');
-    // Configuration (verbose)
+    // Environment
+    log(renderSection('Environment', envRows));
+    log('');
+    // Configuration
     if (configRows.length > 0) {
-        log.verbose(renderSection('Configuration', configRows));
-        log.verbose('');
+        log(renderSection('Configuration', configRows));
+        log('');
     }
-    // Deployment (verbose)
+    // Deployment
     if (stackRows.length > 0) {
-        log.verbose(renderSection('Deployment', stackRows));
-        log.verbose('');
+        log(renderSection('Deployment', stackRows));
+        log('');
     }
-    // Checks (always visible)
+    // Checks
     const maxLabel = Math.max(...Object.values(diagLookup).map((l) => l.length));
     log(styleText('bold', 'Checks'));
     let allGood = true;

package/dist/cores/functions/build.js

@@ -18,13 +18,14 @@ export async function functionBuildCore(options) {
         functions = allFunctions;
     }
     const installer = flags['fn-installer'] || undefined;
-    const outDir = flags['out-dir'] || path.join(path.dirname(blueprint.fileInfo.blueprintFilePath), '.build');
+    const blueprintFileDir = path.dirname(blueprint.fileInfo.blueprintFilePath);
+    const outDir = flags['out-dir'] || path.join(blueprintFileDir, '.build');
     await fs.promises.mkdir(outDir, { recursive: true });
     const errors = [];
     const built = [];
     for (const resource of functions) {
         const spinner = log.ora(`Building ${resource.name}...`).start();
-        const prepResult = await prepareAsset({ resource }, { installer });
+        const prepResult = await prepareAsset({ resource, blueprintFileDir, installer });
         if (prepResult.success === false) {
             spinner.fail(`Failed to build ${resource.name}`);
             errors.push({ name: resource.name, error: prepResult.error ?? 'Unknown error' });

package/dist/cores/functions/test.js

@@ -1,5 +1,5 @@
 import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
+import { dirname, join } from 'node:path';
 import { cwd } from 'node:process';
 import { testAction } from '../../actions/functions/test.js';
 import config from '../../config.js';
@@ -50,6 +50,7 @@ export async function functionTestCore(options) {
                 : undefined,
             logger: log,
         });
+        const blueprintFileDir = dirname(blueprint.fileInfo.blueprintFilePath);
         const contextOptions = docFunction || mediaFunction
             ? {
                 clientOptions: {
@@ -63,8 +64,9 @@ export async function functionTestCore(options) {
                 functionResourceType: 'project',
                 functionResourceId: projectId || '',
                 resources: resolvedResources,
+                blueprintFileDir,
             }
-            : { clientOptions: {}, resources: resolvedResources };
+            : { clientOptions: {}, resources: resolvedResources, blueprintFileDir };
         // If the user sets the flag to use the real token set it in our options
         if (withUserToken) {
             contextOptions.clientOptions.token = config.token || undefined;

package/dist/server/app.js

@@ -1,5 +1,6 @@
 import { existsSync, readFileSync, watchFile } from 'node:fs';
 import * as http from 'node:http';
+import { dirname } from 'node:path';
 import { default as mime } from 'mime-types';
 import { WebSocket, WebSocketServer } from 'ws';
 import { findBlueprintFile, loadAndParseBlueprint } from '../actions/blueprints/blueprint.js';
@@ -68,7 +69,11 @@ const app = (host, port, validateResources, executionOptions) => {
                     req.on('end', async () => {
                         res.setHeader('Content-Type', 'application/json');
                         try {
-                            const { data, func: functionName, metadata } = parseInvokeRequest(Buffer.concat(body));
+                            const fileInfo = findBlueprintFile();
+                            if (!fileInfo) {
+                                throw Error('Could not find a Blueprint manifest (sanity.blueprint.ts, .js, or .json). Run `blueprints init` to create one.');
+                            }
+                            const { data, func: functionName, metadata, } = parseInvokeRequest(Buffer.concat(body), dirname(fileInfo.blueprintFilePath));
                             const { context, event } = data;
                             // replace user token if required
                             if (isGroqContextOptions(context)) {
@@ -312,7 +317,7 @@ function buildApiUrl(projectId, dataset, docId, apiUrl) {
 function buildAssetUrl(mediaLibraryId, docId, apiUrl) {
     return `${apiUrl}/v2025-03-24/media-libraries/${mediaLibraryId}/doc/${docId}`;
 }
-function parseInvokeRequest(body) {
+function parseInvokeRequest(body, blueprintFileDir) {
     let json;
     try {
         json = JSON.parse(body.toString('utf8'));
@@ -404,6 +409,7 @@ function parseInvokeRequest(body) {
             context: {
                 ...context,
                 clientOptions,
+                blueprintFileDir,
                 // Provide default values for required properties if not present
                 eventResourceType: typeof context.eventResourceType === 'string' ? context.eventResourceType : '',
                 eventResourceId: typeof context.eventResourceId === 'string' ? context.eventResourceId : '',

package/dist/server/static/favicon-dark.svg

@@ -1,4 +1,5 @@
 <svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <title>Sanity.io logo</title>
   <g clip-path="url(#clip0_2_1533)">
     <rect width="32" height="32" fill="#FFFFFF"/>
     <rect width="32" height="32" fill="#FFFFFF"/>

package/dist/server/static/favicon.svg

@@ -1,4 +1,5 @@
 <svg width="32" height="32" viewBox="0 0 32 32" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <title>Sanity.io logo</title>
   <g clip-path="url(#clip0_2_1533)">
     <rect width="32" height="32" fill="#0B0B0B"/>
     <rect width="32" height="32" fill="#0B0B0B"/>

package/dist/server/static/index.html

@@ -33,7 +33,7 @@
         <filters-component></filters-component>
         <input type="checkbox" id="nav-toggle" class="hidden">
         <nav id="sidebar" class="relative y-scroll max-h-100 pad-t-5 border-right overflow-auto nav-min-width">
-          <label for="nav-toggle" id="nav-toggle-label" title="Toggle Functions list" class="z-10 nav-label"></label>
+          <label for="nav-toggle" id="nav-toggle-label" aria-label="Toggle Functions list" title="Toggle Functions list" class="z-10 nav-label"></label>
           <h4 class="config-label mar-t-0 mar-b-3 pad-l-3">Functions</h4>
           <function-list></function-list>
         </nav>

package/dist/server/static/vendor/vendor.bundle.js

@@ -6203,6 +6203,7 @@ class FacetProvider {
             }
         };
     }
+    get extension() { return this; }
 }
 function compareArray(a, b, compare) {
     if (a.length != b.length)
@@ -6400,6 +6401,7 @@ class PrecExtension {
         this.inner = inner;
         this.prec = prec;
     }
+    get extension() { return this; }
 }
 /**
 Extension compartments can be used to make a configuration
@@ -6434,6 +6436,7 @@ class CompartmentInstance {
         this.compartment = compartment;
         this.inner = inner;
     }
+    get extension() { return this; }
 }
 class Configuration {
     constructor(base, compartments, dynamicSlots, address, staticValues, facets) {
@@ -6543,6 +6546,8 @@ function flatten(extension, compartments, newCompartments) {
         else {
             let content = ext.extension;
             if (!content)
+                throw new Error(`Unrecognized extension value in extension set (${ext}).`);
+            if (content == ext)
                 throw new Error(`Unrecognized extension value in extension set (${ext}). This sometimes happens because multiple instances of @codemirror/state are loaded, breaking instanceof checks.`);
             inner(content, prec);
         }

package/dist/utils/command-skills.d.ts

@@ -0,0 +1,2 @@
+export declare function commandSkillFilename(commandId: string): string;
+export declare function readCommandSkill(commandId: string, skillsDirectory?: string): Promise<string | undefined>;

package/dist/utils/command-skills.js

@@ -0,0 +1,17 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const SKILLS_DIRECTORY = fileURLToPath(new URL('../../skills/', import.meta.url));
+export function commandSkillFilename(commandId) {
+    return `${commandId.replaceAll(':', '-')}.md`;
+}
+export async function readCommandSkill(commandId, skillsDirectory = SKILLS_DIRECTORY) {
+    try {
+        return await readFile(join(skillsDirectory, commandSkillFilename(commandId)), 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return;
+        throw error;
+    }
+}