handoff-app 2.0.0-8 → 2.0.0

package/dist/config/loader.js

@@ -5,8 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.initConfig = exports.initConfigWithMetadata = exports.resolveProfileSelection = exports.HandoffConfigError = exports.CONFIG_FILE_PREFERENCE = void 0;
 const esbuild_1 = __importDefault(require("esbuild"));
+const build_1 = require("../transformers/utils/build");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const mergeWith_1 = __importDefault(require("lodash/mergeWith"));
+const omit_1 = __importDefault(require("lodash/omit"));
 const module_1 = require("module");
 const path_1 = __importDefault(require("path"));
 const logger_1 = require("../utils/logger");
@@ -37,9 +39,10 @@ const evaluateTypeScriptConfig = (filePath, handoffModulePath) => {
         write: false,
         platform: 'node',
         format: 'cjs',
-        target: 'node16',
+        target: 'node22',
         logLevel: 'silent',
         external: ['handoff-app'],
+        loader: build_1.STYLE_IMPORT_LOADERS,
     });
     const code = (_b = (_a = buildResult.outputFiles) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.text;
     if (!code) {
@@ -170,6 +173,29 @@ const replaceValues = (destination, source) => {
         return undefined;
     return Array.isArray(source) || (0, from_env_1.isEnvReference)(source) || (0, from_env_1.isEnvReference)(destination) ? source : undefined;
 };
+/**
+ * A layer that changes `runtime.registry.email.provider` starts from fresh `options` and `module`, so
+ * the deep merge never mixes the settings of two providers.
+ */
+const resetEmailOnProviderChange = (layers) => {
+    let provider;
+    let start = 0;
+    layers.forEach((layer, index) => {
+        var _a, _b, _c;
+        const next = (_c = (_b = (_a = layer.runtime) === null || _a === void 0 ? void 0 : _a.registry) === null || _b === void 0 ? void 0 : _b.email) === null || _c === void 0 ? void 0 : _c.provider;
+        if (next !== undefined && next !== provider) {
+            provider = next;
+            start = index;
+        }
+    });
+    return layers.map((layer, index) => {
+        var _a, _b;
+        const email = (_b = (_a = layer.runtime) === null || _a === void 0 ? void 0 : _a.registry) === null || _b === void 0 ? void 0 : _b.email;
+        if (index >= start || !email)
+            return layer;
+        return Object.assign(Object.assign({}, layer), { runtime: Object.assign(Object.assign({}, layer.runtime), { registry: Object.assign(Object.assign({}, layer.runtime.registry), { email: (0, omit_1.default)(email, ['options', 'module']) }) }) });
+    });
+};
 /**
  * Loads the handoff configuration for the given working directory and returns metadata.
  */
@@ -197,7 +223,7 @@ const initConfigWithMetadata = (configOverride, context) => {
         : 'none selected';
     logger_1.Logger.debug(`Config profile: ${profileLabel}`);
     logger_1.Logger.debug(`Config files loaded: ${[configPath, profileConfigPath].filter(Boolean).join(', ') || 'none, using defaults'}`);
-    const merged = (0, mergeWith_1.default)({}, ...layers, replaceValues);
+    const merged = (0, mergeWith_1.default)({}, ...resetEmailOnProviderChange(layers), replaceValues);
     const config = (0, resolve_env_1.resolveConfigEnv)(merged, profileSelection === null || profileSelection === void 0 ? void 0 : profileSelection.name, layers[0]);
     // Guards run on the resolved config so a profile cannot slip a removed setting past them.
     const entries = config.entries;

package/dist/config/resolve-env.d.ts

@@ -1,5 +1,6 @@
 import type { Config, ResolvedConfig } from '../types/config';
-export declare const DEFERRED_PATHS: Set<string>;
+/** Paths whose value the deployed app reads at request time, so only the variable name is stored. */
+export declare const DEFERRED_PATHS: string[];
 export declare const configEnvName: (config: ResolvedConfig | null | undefined, path: string) => string | undefined;
 /** Resolve only the merged winner. Functions and non-plain objects retain their identity. */
 export declare const resolveConfigEnv: (config: Config, profile?: string, defaults?: Config) => ResolvedConfig;

package/dist/config/resolve-env.js

@@ -8,11 +8,32 @@ const isPlainObject_1 = __importDefault(require("lodash/isPlainObject"));
 const logger_1 = require("../utils/logger");
 const from_env_1 = require("./from-env");
 const errors_1 = require("./errors");
-exports.DEFERRED_PATHS = new Set(['runtime.registry.databaseUrl', 'runtime.registry.assetStorage.token']);
-const SECRET_PATHS = new Set(['dev_access_token', 'devAccessToken', 'runtime.registryConnection.accessToken']);
-/** Path prefixes whose resolved contents are JSON-baked into the bundle, so a reference would bake its value. */
-const BAKED_PATHS = ['runtime.registry.assetStorage.options'];
-const isBaked = (path) => BAKED_PATHS.some((baked) => path === baked || path.startsWith(`${baked}.`));
+/**
+ * Match a dot path against a pattern. A `*` segment matches exactly one segment, so one pattern
+ * covers every element of a list. With `prefix`, the pattern also matches anything nested under it.
+ */
+const pathMatches = (pattern, path, prefix = false) => {
+    const expected = pattern.split('.');
+    const actual = path.split('.');
+    if (prefix ? expected.length > actual.length : expected.length !== actual.length)
+        return false;
+    return expected.every((segment, index) => segment === '*' || segment === actual[index]);
+};
+/** Paths whose value the deployed app reads at request time, so only the variable name is stored. */
+exports.DEFERRED_PATHS = [
+    'runtime.registry.database.url',
+    'runtime.registry.email.options.apiKey',
+    'runtime.registry.email.options.password',
+    'runtime.ai.connections.*.apiKey',
+];
+/**
+ * Path prefixes whose nested references the deployed app reads at request time. Literals below them
+ * are baked. `DEFERRED_PATHS` entries below them still reject literals.
+ */
+const DEFERRED_PREFIXES = ['runtime.registry.email.options', 'runtime.registry.assetStorage.options', 'runtime.ai.connections.*.options'];
+const SECRET_PATHS = new Set(['integrations.figma.accessToken', 'runtime.registryConnection.accessToken']);
+const isDeferred = (path) => exports.DEFERRED_PATHS.some((deferred) => pathMatches(deferred, path));
+const isUnderDeferredPrefix = (path) => DEFERRED_PREFIXES.some((prefix) => pathMatches(`${prefix}.*`, path, true));
 const ENV_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
 const ALIASES = {
     HANDOFF_REGISTRY_URL: 'HANDOFF_CLOUD_URL',
@@ -44,17 +65,12 @@ const resolveConfigEnv = (config, profile, defaults) => {
     };
     const walk = (value, path, seed) => {
         var _a;
-        const deferred = exports.DEFERRED_PATHS.has(path);
+        const deferred = isDeferred(path);
         const secret = SECRET_PATHS.has(path);
         if ((secret || deferred) && value !== undefined && !(0, from_env_1.isEnvReference)(value)) {
             fail(path, 'Expected an environment reference, such as { $env: "VARIABLE_NAME" }. Literal values are not allowed.');
         }
         if ((0, from_env_1.isEnvReference)(value)) {
-            // Checked before the name, so the message names the supported pattern instead of the reference shape.
-            if (isBaked(path)) {
-                fail(path, 'Environment references are not allowed here because the resolved value is baked into the build. ' +
-                    "Put the variable name in options and read it through the adapter factory's `env` argument.");
-            }
             if (typeof value.$env !== 'string' || !ENV_NAME.test(value.$env)) {
                 fail(path, 'Invalid environment variable name. Use letters, digits, and underscores, starting with a letter or underscore.');
             }
@@ -63,7 +79,7 @@ const resolveConfigEnv = (config, profile, defaults) => {
             if (Object.keys(value).some((key) => key !== '$env' && key !== 'default')) {
                 fail(path, `Environment variable "${name}" has an invalid reference shape.`);
             }
-            if (deferred) {
+            if (deferred || isUnderDeferredPrefix(path)) {
                 if ('default' in value)
                     fail(path, `Environment variable "${name}" cannot have a default because it is read by the deployed app.`);
                 return { $env: name };

package/dist/config/runtime.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toLowerCaseKeysAndValues = exports.getComponentsForPath = exports.isComponentDirectory = exports.initRuntimeConfig = exports.getCatalogItemDirectories = exports.resolveComponentDeclaration = void 0;
 const esbuild_1 = __importDefault(require("esbuild"));
+const build_1 = require("../transformers/utils/build");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const module_1 = require("module");
 const path_1 = __importDefault(require("path"));
@@ -17,7 +18,8 @@ const markdown_1 = require("../utils/markdown");
 const pages_1 = require("../utils/pages");
 const path_2 = require("../utils/path");
 const page_1 = require("./normalizers/page");
-const DECLARATION_EXTENSIONS = ['ts', 'js', 'cjs'];
+/** `.tsx`/`.jsx` are accepted so a preview can write its `render` as JSX. */
+const DECLARATION_EXTENSIONS = ['tsx', 'ts', 'jsx', 'js', 'cjs'];
 const getDeclarationFiles = (componentBaseName) => DECLARATION_EXTENSIONS.map((ext) => `${componentBaseName}.handoff.${ext}`);
 const findPreferredDeclaration = (componentDir, componentBaseName) => {
     const exactCandidates = getDeclarationFiles(componentBaseName);
@@ -25,7 +27,7 @@ const findPreferredDeclaration = (componentDir, componentBaseName) => {
     if (exactMatch)
         return exactMatch;
     const allFiles = fs_extra_1.default.existsSync(componentDir) ? fs_extra_1.default.readdirSync(componentDir) : [];
-    const declarationFiles = allFiles.filter((file) => /\.handoff\.(ts|js|cjs)$/.test(file)).sort((a, b) => a.localeCompare(b));
+    const declarationFiles = allFiles.filter((file) => /\.handoff\.(tsx|ts|jsx|js|cjs)$/.test(file)).sort((a, b) => a.localeCompare(b));
     if (!declarationFiles.length)
         return undefined;
     for (const ext of DECLARATION_EXTENSIONS) {
@@ -48,10 +50,11 @@ const evaluateDeclaration = (filePath, handoffModulePath) => {
         write: false,
         platform: 'node',
         format: 'cjs',
-        target: 'node16',
+        target: 'node22',
         logLevel: 'silent',
         jsx: 'automatic',
         external: ['react', 'react-dom', 'handoff-app'],
+        loader: build_1.STYLE_IMPORT_LOADERS,
     });
     const code = (_b = (_a = buildResult.outputFiles) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.text;
     if (!code) {
@@ -178,7 +181,7 @@ const initRuntimeConfig = (handoff) => {
         const declaration = (0, exports.resolveComponentDeclaration)(itemPath, itemBaseName);
         if (!declaration) {
             const declarationFiles = getDeclarationFiles(itemBaseName);
-            logger_1.Logger.warn(`Missing catalog declaration (use .handoff.ts, .handoff.js, or .handoff.cjs; see UPGRADE.md#catalog-items): ${path_1.default.resolve(itemPath, declarationFiles.join(' or '))}`);
+            logger_1.Logger.warn(`Missing catalog declaration (use .handoff.tsx, .handoff.ts, .handoff.jsx, .handoff.js, or .handoff.cjs; see UPGRADE.md#catalog-items): ${path_1.default.resolve(itemPath, declarationFiles.join(' or '))}`);
             continue;
         }
         const declarationPath = path_1.default.resolve(itemPath, declaration.fileName);
@@ -361,8 +364,8 @@ const injectPatternPreviews = (result) => {
             }
             // Case 3: args present (with or without preview base) -> create synthetic preview
             let resolvedValues = {};
+            const basePreview = ref.preview ? (_b = component.previews) === null || _b === void 0 ? void 0 : _b[ref.preview] : undefined;
             if (ref.preview) {
-                const basePreview = (_b = component.previews) === null || _b === void 0 ? void 0 : _b[ref.preview];
                 if (basePreview) {
                     resolvedValues = Object.assign({}, basePreview.values);
                 }
@@ -374,12 +377,7 @@ const injectPatternPreviews = (result) => {
             resolvedValues = Object.assign(Object.assign({}, resolvedValues), ref.args);
             const syntheticKey = `__pattern_${patternId}_${i}`;
             component.internalPatternPreviews = component.internalPatternPreviews || {};
-            component.internalPatternPreviews[syntheticKey] = {
-                title: syntheticKey,
-                values: resolvedValues,
-                url: '',
-                sourcePreview: ref.preview,
-            };
+            component.internalPatternPreviews[syntheticKey] = Object.assign({ title: syntheticKey, values: resolvedValues, url: '', sourcePreview: ref.preview }, ((basePreview === null || basePreview === void 0 ? void 0 : basePreview.render) ? { render: basePreview.render } : {}));
             ref.resolvedPreview = syntheticKey;
             if (ref.resolved === undefined) {
                 ref.resolved = true;

package/dist/handlebars.d.ts

@@ -1,5 +1,13 @@
-import type { CatalogItem, CatalogItemMeta } from './catalog/types';
-export type { CatalogItem, CatalogItemMeta, CatalogPreview, CompositionRef, Preview, SourceDescriptor } from './catalog/types';
+import type { CatalogItem, CatalogItemMeta, CatalogPreview as RendererPreview } from './catalog/types';
+export type { CatalogItem, CatalogItemMeta, CompositionRef, SourceDescriptor } from './catalog/types';
+/** A template renderer never calls a preview `render`, so declaring one is an error, not a no-op. */
+export type CatalogPreview<TArgs = Record<string, unknown>> = Omit<RendererPreview<TArgs>, 'render'> & {
+    render?: never;
+};
+/** Preview type for a Handlebars catalog item, with its argument type applied. */
+export type Preview<TItem> = TItem extends {
+    readonly __args?: infer TArgs;
+} ? CatalogPreview<Partial<NonNullable<TArgs>>> : never;
 /**
  * Declares a Handlebars catalog item. `implementation` is the path to its `.hbs` template. The
  * renderer comes from this module, so the build fails an item whose file does not match it.

package/dist/index.d.ts

@@ -83,7 +83,7 @@ declare class Handoff {
     private profilesWithoutConfig;
     init(configOverride?: Partial<Config>): Handoff;
     reload(): Handoff;
-    preRunner(validate?: boolean): Handoff;
+    preRunner(): Handoff;
     fetch(): Promise<Handoff>;
     component(name: string | null): Promise<Handoff>;
     pattern(): Promise<Handoff>;
@@ -186,10 +186,7 @@ declare class Handoff {
      */
     getDocumentationObject(): Promise<CoreTypes.IDocumentationObject | undefined>;
     getRunner(): Promise<ReturnType<typeof HandoffRunner>>;
-    /**
-     * Gets the project ID, falling back to filesystem-safe working path if figma_project_id is missing
-     * @returns {string} The project ID to use for path construction
-     */
+    /** Keys `.handoff/<projectId>`, so workspaces that share one installed package stage apart. */
     getProjectId(): string;
     /**
      * Gets the output path for the current project
@@ -236,6 +233,10 @@ declare class Handoff {
      * Gets the selected main config file path if one exists.
      */
     getMainConfigFilePath(): string | undefined;
+    /**
+     * Gets the selected profile config file path if one exists.
+     */
+    getProfileConfigFilePath(): string | undefined;
     getProfile(): string | undefined;
     /**
      * True for the base config file and for the profile file merged onto it. Both carry project-wide
@@ -260,7 +261,11 @@ export { defineConfig } from './config';
 export { fromEnv } from './config/from-env';
 export type { EnvValue, EnvSecret, RuntimeEnvReference } from './config/from-env';
 export type { CatalogItem, CatalogItemEntries, CatalogItemInput, CatalogItemMeta, CatalogPreview, CompositionRef, Preview, SourceDescriptor, SourceFormat, RendererKind, } from './catalog';
-export { defineAssetStorage } from './registry/asset-storage/define';
-export type { AssetStorage, AssetStorageContext, AssetStorageFactory, AssetStorageInput, AssetStorageReadResult, } from './registry/asset-storage/types';
+export { defineStorageProvider } from './registry/asset-storage/define';
+export type { StorageProvider, StorageProviderContext, StorageProviderFactory, StorageInput, StorageReadResult, AssetUpload, AssetUploadInput, } from './registry/asset-storage/types';
+export { defineEmailProvider } from './registry/email/define';
+export type { EmailMessage, EmailProvider, EmailProviderContext, EmailProviderFactory } from './registry/email/types';
+export { defineAiProvider } from './ai/define';
+export type { AiProvider, AiProviderContext, AiProviderFactory } from './ai/types';
 export { Transformers as CoreTransformers, TransformerUtils as CoreTransformerUtils, Types as CoreTypes } from 'handoff-core';
 export default Handoff;

package/dist/index.js

@@ -35,7 +35,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CoreTypes = exports.CoreTransformerUtils = exports.CoreTransformers = exports.defineAssetStorage = exports.fromEnv = exports.defineConfig = void 0;
+exports.CoreTypes = exports.CoreTransformerUtils = exports.CoreTransformers = exports.defineAiProvider = exports.defineEmailProvider = exports.defineStorageProvider = exports.fromEnv = exports.defineConfig = void 0;
 require("./config/env");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const handoff_core_1 = require("handoff-core");
@@ -46,6 +46,7 @@ const make_1 = require("./cli/make");
 const store_1 = require("./cli/auth/store");
 const config_1 = require("./config");
 const pipeline_1 = __importStar(require("./pipeline"));
+const figma_1 = require("./pipeline/figma");
 const content_kinds_1 = require("./registry/content-kinds");
 const store_2 = require("./store");
 const builder_1 = __importStar(require("./transformers/preview/component/builder"));
@@ -193,13 +194,10 @@ class Handoff {
         this.construct(this._options);
         return this;
     }
-    preRunner(validate) {
+    preRunner() {
         if (!this.config) {
             throw Error('Handoff not initialized');
         }
-        if (validate) {
-            this.config = (0, config_1.validateConfig)(this.config);
-        }
         return this;
     }
     fetch() {
@@ -504,12 +502,8 @@ class Handoff {
             if (!!this._handoffRunner) {
                 return this._handoffRunner;
             }
-            const apiCredentials = {
-                projectId: this.config.figma_project_id,
-                accessToken: this.config.dev_access_token,
-            };
-            // Initialize the provider
-            const provider = handoff_core_1.Providers.RestApiProvider(apiCredentials);
+            const { projectId, accessToken } = (0, figma_1.resolveFigmaConnection)(this.config);
+            const provider = handoff_core_1.Providers.RestApiProvider({ projectId, accessToken });
             this._handoffRunner = (0, handoff_core_1.Handoff)(provider, {
                 options: {
                     transformer: this.runtimeConfig.options,
@@ -531,16 +525,8 @@ class Handoff {
             return this._handoffRunner;
         });
     }
-    /**
-     * Gets the project ID, falling back to filesystem-safe working path if figma_project_id is missing
-     * @returns {string} The project ID to use for path construction
-     */
+    /** Keys `.handoff/<projectId>`, so workspaces that share one installed package stage apart. */
     getProjectId() {
-        var _a;
-        if ((_a = this.config) === null || _a === void 0 ? void 0 : _a.figma_project_id) {
-            return this.config.figma_project_id;
-        }
-        // Fallback to filesystem-safe transformation of working path
         return (0, path_3.generateFilesystemSafeId)(this.workingPath);
     }
     /**
@@ -548,7 +534,7 @@ class Handoff {
      * @returns {string} The absolute path to the output directory
      */
     getOutputPath() {
-        return path_1.default.resolve(this.workingPath, this.exportsDirectory, this.getProjectId());
+        return path_1.default.resolve(this.workingPath, this.exportsDirectory);
     }
     /**
      * Gets the path to the tokens.json file
@@ -607,6 +593,12 @@ class Handoff {
     getMainConfigFilePath() {
         return this._mainConfigFilePath;
     }
+    /**
+     * Gets the selected profile config file path if one exists.
+     */
+    getProfileConfigFilePath() {
+        return this._profileConfigFilePath;
+    }
     getProfile() {
         return this._profile;
     }
@@ -651,7 +643,11 @@ Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function
 var from_env_1 = require("./config/from-env");
 Object.defineProperty(exports, "fromEnv", { enumerable: true, get: function () { return from_env_1.fromEnv; } });
 var define_1 = require("./registry/asset-storage/define");
-Object.defineProperty(exports, "defineAssetStorage", { enumerable: true, get: function () { return define_1.defineAssetStorage; } });
+Object.defineProperty(exports, "defineStorageProvider", { enumerable: true, get: function () { return define_1.defineStorageProvider; } });
+var define_2 = require("./registry/email/define");
+Object.defineProperty(exports, "defineEmailProvider", { enumerable: true, get: function () { return define_2.defineEmailProvider; } });
+var define_3 = require("./ai/define");
+Object.defineProperty(exports, "defineAiProvider", { enumerable: true, get: function () { return define_3.defineAiProvider; } });
 // Export transformers and types from handoff-core
 var handoff_core_2 = require("handoff-core");
 Object.defineProperty(exports, "CoreTransformers", { enumerable: true, get: function () { return handoff_core_2.Transformers; } });

package/dist/nav/index.d.ts

@@ -78,6 +78,6 @@ export interface NavData {
 export { getNavData } from './resolver';
 export type { GetNavDataInput } from './resolver';
 export { getWorkspaceNavData } from './workspace';
-export type { WorkspaceNavAdapterOptions, WorkspaceNavLoaders } from './workspace';
+export type { WorkspaceNavOptions, WorkspaceNavLoaders } from './workspace';
 export { getRegistryNavData } from './registry';
-export type { RegistryNavAdapterOptions, RegistryNavRecords } from './registry';
+export type { RegistryNavOptions, RegistryNavRecords } from './registry';

package/dist/nav/registry.d.ts

@@ -5,11 +5,11 @@ export interface RegistryNavRecords {
     pages: NavPageRecord[];
     tokenSets: NavTokenSet[];
 }
-export interface RegistryNavAdapterOptions {
+export interface RegistryNavOptions {
     shell: SectionLink[];
     load: NavLoad;
     basePath?: string;
     fetchRecords: () => Promise<RegistryNavRecords>;
 }
-/** Registry adapter: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
-export declare const getRegistryNavData: (options: RegistryNavAdapterOptions) => Promise<NavData>;
+/** Registry nav data: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
+export declare const getRegistryNavData: (options: RegistryNavOptions) => Promise<NavData>;

package/dist/nav/registry.js

@@ -13,7 +13,7 @@ exports.getRegistryNavData = void 0;
 const menu_shell_1 = require("../utils/menu-shell");
 const resolver_1 = require("./resolver");
 const emptyRecords = () => ({ components: [], patterns: [], pages: [], tokenSets: [] });
-/** Registry adapter: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
+/** Registry nav data: shell-only initial load, or one best-effort runtime-record fetch on refresh. */
 const getRegistryNavData = (options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     let records = emptyRecords();

package/dist/nav/workspace.d.ts

@@ -6,13 +6,13 @@ export interface WorkspaceNavLoaders {
     pages: () => Awaitable<NavPageRecord[]>;
     tokenSets: () => Awaitable<NavTokenSet[]>;
 }
-export interface WorkspaceNavAdapterOptions {
+export interface WorkspaceNavOptions {
     docRoot: string;
     workingPagesDir?: string;
     basePath?: string;
     load?: NavLoad;
     loaders: WorkspaceNavLoaders;
 }
-/** Workspace/static adapter: live filesystem shell plus best-effort local snapshot loaders. */
-export declare const getWorkspaceNavData: (options: WorkspaceNavAdapterOptions) => Promise<NavData>;
+/** Workspace/static nav data: live filesystem shell plus best-effort local snapshot loaders. */
+export declare const getWorkspaceNavData: (options: WorkspaceNavOptions) => Promise<NavData>;
 export {};

package/dist/nav/workspace.js

@@ -64,7 +64,7 @@ const markdownTitle = (id, docRoot, workingPagesDir) => {
     }
     return undefined;
 };
-/** Workspace/static adapter: live filesystem shell plus best-effort local snapshot loaders. */
+/** Workspace/static nav data: live filesystem shell plus best-effort local snapshot loaders. */
 const getWorkspaceNavData = (options) => __awaiter(void 0, void 0, void 0, function* () {
     var _a;
     const [loadedComponents, patterns, pages, loadedTokenSets] = yield Promise.all([

package/dist/pipeline/figma.d.ts

@@ -1,8 +1,19 @@
 import { Types as HandoffTypes } from 'handoff-core';
 import Handoff from '..';
+import type { ResolvedConfig } from '../types/config';
+/** Figma values resolved at config load, with the variable names they come from. */
+export type FigmaConnection = {
+    projectId: string;
+    accessToken: string;
+    /** Unset when the config gives a literal file ID. */
+    projectIdEnv?: string;
+    accessTokenEnv?: string;
+};
+export declare const resolveFigmaConnection: (config: ResolvedConfig | null | undefined) => FigmaConnection;
 /**
- * Validate the figma auth tokens.
- * Prompts the user interactively if credentials are missing.
+ * Makes sure that `fetch` has a Figma file ID and access token. In a terminal, it asks for an empty
+ * value and can save it to the env file of the selected profile. Without a terminal, it throws
+ * `HandoffConfigError`.
  */
 export declare const validateFigmaAuth: (handoff: Handoff) => Promise<void>;
 /**