fundus 0.16.0 → 0.17.0

package/build/server/chunks/chunks/{context.js-BXaBgcZT.js → context.js-Dh0ibRIF.js}

@@ -1,7 +1,7 @@
-import { c as compareCodeUnits, h as folderOfRawPath, j as rawFileNameOfPath, g as canonicalizeParameters, n as normalizeFolderPath, H as typesForFileName, J as proposeAssetId, k as parentFolderPath, u as portableFolderPathKey, B as isAssetReference } from './core.js-D1sYC_78.js';
-import { s as serverPluginsByType, i as isRecord, L as LibraryStore, d as descriptorsByType, m as manifestModuleFileName, l as locateGeneratedAssetDeclaration, a as serializeLibrary, b as serverPluginForType, S as SourceImportError, p as processAssets, g as generateManifestModules, r as readCurrentProxy, e as encodeRelativePathForUrl, f as flatLibraryIssues, c as manifestModuleCollisionIssues, h as invalidInput, j as parseLibrary, k as isRecord$1, n as assertSafeKey, o as parseManifestRecord, q as parseImportSource } from './contract.js-IY1F-HE_.js';
-import { c as collectAllReferences, a as assetIdError, b as computeLibraryMembership, d as allDeliveredAssetIds } from './manifest-membership.js-Cm_2fU-Z.js';
-import { v as verifyStableRawFile, c as classifyRawDirectory } from './raw-reconciliation2.js-CcO9li5n.js';
+import { c as compareCodeUnits, h as folderOfRawPath, j as rawFileNameOfPath, g as canonicalizeParameters, n as normalizeFolderPath, H as typesForFileName, k as parentFolderPath, u as portableFolderPathKey, B as isAssetReference } from './core.js-CTyKR4bu.js';
+import { s as serverPluginsByType, i as isRecord, L as LibraryStore, d as descriptorsByType, m as manifestModuleFileName, l as locateGeneratedAssetDeclaration, a as serializeLibrary, b as serverPluginForType, S as SourceImportError, p as processAssets, g as generateManifestModules, r as readCurrentProxy, e as encodeRelativePathForUrl, f as flatLibraryIssues, c as manifestModuleCollisionIssues, h as invalidInput, j as parseLibrary, k as isRecord$1, n as assertSafeKey, o as parseManifestRecord, q as parseImportSource } from './contract.js-_LTMZBo2.js';
+import { c as collectAllReferences, a as assetIdError, b as computeLibraryMembership, d as allDeliveredAssetIds, i as isValidAssetId } from './manifest-membership.js-at1ixQdW.js';
+import { v as verifyStableRawFile, c as classifyRawDirectory } from './raw-reconciliation2.js-z4xl5zw2.js';
 import { createRequire } from 'node:module';
 import { isAbsolute, resolve, join, dirname, extname, relative, sep } from 'node:path';
 import { existsSync, readFileSync } from 'node:fs';
@@ -234,6 +234,24 @@ function materializeLibrary(effective) {
 	};
 }
 //#endregion
+//#region src/lib/core/propose-asset-id.ts
+/**
+* Propose a camelCase asset id from a file (or node) name: split on
+* non-alphanumeric runs and case boundaries, drop a `@2x`-style scale suffix,
+* lowercase the first word, capitalize the rest, strip leading digits.
+*
+* Pure and dependency-free so it can be shared everywhere — including the Figma
+* plugin bundle, which must not pull in the plugin registry that `ingest.ts`
+* imports.
+*/
+function proposeAssetId(fileName) {
+	const words = fileName.replace(/\.[^.]+$/, "").replace(/(?:@|[-_])\dx$/i, "").replace(/([a-z0-9])([A-Z])/g, "$1 $2").split(/[^a-zA-Z0-9]+/).filter(Boolean);
+	if (words.length === 0) return "asset";
+	const withoutLeadingDigits = words.map((word, index) => index === 0 ? word.toLowerCase() : word.charAt(0).toUpperCase() + word.slice(1).toLowerCase()).join("").replace(/^[0-9]+/, "");
+	if (!withoutLeadingDigits) return "asset";
+	return withoutLeadingDigits.charAt(0).toLowerCase() + withoutLeadingDigits.slice(1);
+}
+//#endregion
 //#region src/lib/server/config-loader.ts
 /**
 * Loads and resolves the host's `fundus.config.ts` through jiti, validates
@@ -338,6 +356,7 @@ function resolveConfig(projectRoot, value, registry = serverPluginsByType) {
 	const figma = importConfig.figma === void 0 ? {} : importConfig.figma;
 	if (!isRecord(figma)) throw new Error("fundus.config: \"import.figma\" must be an object.");
 	if (figma.token !== void 0 && (typeof figma.token !== "string" || figma.token.length === 0)) throw new Error("fundus.config: \"import.figma.token\" must be a non-empty string.");
+	if (figma.defaultFileKey !== void 0 && (typeof figma.defaultFileKey !== "string" || figma.defaultFileKey.length === 0)) throw new Error("fundus.config: \"import.figma.defaultFileKey\" must be a non-empty string.");
 	const defaults = figma.defaults === void 0 ? {} : figma.defaults;
 	if (!isRecord(defaults)) throw new Error("fundus.config: \"import.figma.defaults\" must be an object.");
 	const scale = defaults.scale === void 0 ? 2 : defaults.scale;
@@ -356,6 +375,7 @@ function resolveConfig(projectRoot, value, registry = serverPluginsByType) {
 		plugins: resolvedPlugins,
 		import: { figma: {
 			...figma.token !== void 0 ? { token: figma.token } : {},
+			...figma.defaultFileKey !== void 0 ? { defaultFileKey: figma.defaultFileKey } : {},
 			defaults: { scale }
 		} },
 		usage: usage === void 0 ? null : usage,
@@ -761,9 +781,22 @@ function validateScale(value) {
 }
 function validateInput(value) {
 	const input = record(value);
-	if (!input || typeof input.url !== "string") return invalidInput("Figma import requires a URL.");
+	if (!input) return invalidInput("Figma import requires a URL.");
 	if (input.format !== void 0 && input.format !== "png") return invalidInput("Figma import currently supports PNG only.");
+	if (input.mode === "tag") {
+		if (typeof input.tag !== "string" || !isValidAssetId(input.tag)) return invalidInput("Figma tag import requires a valid Fundus asset id as the tag.");
+		if (input.fileKey !== void 0 && (typeof input.fileKey !== "string" || input.fileKey.length === 0)) return invalidInput("Figma tag import fileKey must be a non-empty string.");
+		return {
+			mode: "tag",
+			tag: input.tag,
+			format: "png",
+			...input.fileKey !== void 0 ? { fileKey: input.fileKey } : {},
+			...input.scale !== void 0 ? { scale: validateScale(input.scale) } : {}
+		};
+	}
+	if (typeof input.url !== "string") return invalidInput("Figma import requires a URL.");
 	return {
+		mode: "node",
 		url: input.url,
 		format: "png",
 		...input.scale !== void 0 ? { scale: validateScale(input.scale) } : {}
@@ -772,6 +805,17 @@ function validateInput(value) {
 function validateFigmaSourceParameters(value) {
 	const source = record(value);
 	if (!source || typeof source.fileKey !== "string" || source.fileKey.length === 0 || typeof source.nodeId !== "string" || !/^\d+:\d+$/.test(source.nodeId) || source.format !== "png") return invalidInput("Stored Figma source parameters are invalid.");
+	if (source.mode === "tag") {
+		if (typeof source.fundusTag !== "string" || !isValidAssetId(source.fundusTag)) return invalidInput("Stored Figma source parameters are invalid.");
+		return {
+			mode: "tag",
+			fileKey: source.fileKey,
+			fundusTag: source.fundusTag,
+			nodeId: source.nodeId,
+			format: "png",
+			scale: validateScale(source.scale)
+		};
+	}
 	return {
 		fileKey: source.fileKey,
 		nodeId: source.nodeId,
@@ -963,6 +1007,37 @@ async function validatePng(bytes) {
 	if (!metadata.width || !metadata.height) throw new SourceImportError("invalid-response", "Figma export has invalid dimensions.");
 	if (metadata.width * metadata.height > MAX_PIXELS) throw new SourceImportError("image-too-large", "Figma export exceeds the 32 megapixel limit.");
 }
+function collectTaggedNodeIds(node, tag, matches) {
+	const current = record(node);
+	if (!current) return;
+	const shared = record(current.sharedPluginData);
+	const fundus = shared ? record(shared.fundus) : null;
+	if (fundus && fundus.assetId === tag && typeof current.id === "string") matches.push(current.id);
+	if (Array.isArray(current.children)) for (const child of current.children) collectTaggedNodeIds(child, tag, matches);
+}
+async function resolveTagToNode(fileKey, tag, context) {
+	const token = context.config.import.figma.token;
+	if (!token) throw new SourceImportError("not-configured", "Figma access is not configured.");
+	const endpoint = new URL(`https://api.figma.com/v1/files/${encodeURIComponent(fileKey)}`);
+	endpoint.searchParams.set("plugin_data", "shared");
+	const jsonBytes = await fetchWithDeadline(context.fetch, endpoint, {
+		redirect: "error",
+		headers: { "X-Figma-Token": token }
+	}, async (response) => new Uint8Array(await response.arrayBuffer()));
+	let payload;
+	try {
+		payload = JSON.parse(new TextDecoder().decode(jsonBytes));
+	} catch {
+		throw new SourceImportError("invalid-response", "Figma returned an invalid response.");
+	}
+	const body = record(payload);
+	if (!body || body.err || typeof body.status === "number" && body.status >= 400) throw new SourceImportError("invalid-response", "Figma returned an invalid response.");
+	const matches = [];
+	collectTaggedNodeIds(body.document, tag, matches);
+	if (matches.length === 0) throw new SourceImportError("not-found", `No Figma node is tagged "${tag}" in this file.`);
+	if (matches.length > 1) throw new SourceImportError("ambiguous-tag", `More than one Figma node is tagged "${tag}" in this file.`);
+	return matches[0];
+}
 async function materialize(source, context) {
 	const token = context.config.import.figma.token;
 	if (!token) throw new SourceImportError("not-configured", "Figma access is not configured.");
@@ -1002,6 +1077,19 @@ var figmaSourceImporter = {
 	label: "Figma",
 	validateInput,
 	async importRaw(input, context) {
+		if (input.mode === "tag") {
+			const fileKey = input.fileKey ?? context.config.import.figma.defaultFileKey;
+			if (!fileKey) throw new SourceImportError("not-configured", "Figma tag import needs a fileKey or import.figma.defaultFileKey in fundus.config.");
+			const nodeId = await resolveTagToNode(fileKey, input.tag, context);
+			return materialize({
+				mode: "tag",
+				fileKey,
+				fundusTag: input.tag,
+				nodeId,
+				format: "png",
+				scale: input.scale ?? context.config.import.figma.defaults.scale
+			}, context);
+		}
 		const parsed = parseFigmaSelectionUrl(input.url);
 		return materialize({
 			fileKey: parsed.fileKey,
@@ -1012,6 +1100,13 @@ var figmaSourceImporter = {
 	},
 	validateSourceParameters: validateFigmaSourceParameters,
 	async reimportRaw(source, context) {
+		if (source.mode === "tag") {
+			const nodeId = await resolveTagToNode(source.fileKey, source.fundusTag, context);
+			return materialize({
+				...source,
+				nodeId
+			}, context);
+		}
 		return materialize(source, context);
 	}
 };
@@ -1610,6 +1705,17 @@ function figmaSlicePixelRatio(raw, type) {
 	if (type !== "slice" || raw.importSource?.importer !== "figma") return void 0;
 	return validateFigmaSourceParameters(raw.importSource.parameters).scale;
 }
+/**
+* The Fundus tag of a Figma tag-mode import source, else null. In tag mode the
+* tag IS the asset id, so this is the single seam that ties provenance to
+* identity — used to assert id equality on import/reimport and to forbid
+* renaming a tag-referenced asset. Only Figma sources are inspected.
+*/
+function figmaTagOf(importSource) {
+	if (importSource?.importer !== "figma") return null;
+	const params = validateFigmaSourceParameters(importSource.parameters);
+	return params.mode === "tag" ? params.fundusTag : null;
+}
 var FundusOperations = class {
 	#config;
 	#registry;
@@ -1881,6 +1987,8 @@ var FundusOperations = class {
 		});
 		return this.#enqueueOperation(async () => {
 			this.#validateImportedRaw(raw, options.importer);
+			const tag = figmaTagOf(raw.importSource);
+			if (tag !== null && tag !== options.id) throw new SourceImportError("invalid-input", `A Figma tag import must use its tag as the asset id: the tag is "${tag}", not "${options.id}".`);
 			return this.#createImportedAsset(raw, options);
 		});
 	}
@@ -1917,6 +2025,8 @@ var FundusOperations = class {
 		if (snapshot.input !== void 0 && !raw.importSource) throw new SourceImportError("invalid-response", "The source importer did not return provenance for the updated source.");
 		return this.#enqueueOperation(async () => {
 			this.#validateImportedRaw(raw, snapshot.importer.kind);
+			const tag = figmaTagOf(raw.importSource);
+			if (tag !== null && tag !== id) throw new SourceImportError("invalid-input", `A Figma tag reimport may not retarget asset "${id}" to a different tag "${tag}".`);
 			const plugin = serverPluginForType(snapshot.expected.type, this.#registry);
 			if (!plugin.descriptor.accepts.includes(raw.extension)) throw new SourceImportError("invalid-response", `The ${snapshot.expected.type} type does not accept ".${raw.extension}" files.`);
 			const pixelRatio = snapshot.input === void 0 ? void 0 : figmaSlicePixelRatio(raw, snapshot.expected.type);
@@ -1963,6 +2073,8 @@ var FundusOperations = class {
 		const importSource = raw.importSource;
 		return this.#enqueueOperation(async () => {
 			this.#validateImportedRaw(raw, preflight.importer.kind);
+			const tag = figmaTagOf(importSource);
+			if (tag !== null && tag !== id) throw new SourceImportError("invalid-input", `A Figma tag replacement must use its own tag as the asset id: the tag is "${tag}", not "${id}".`);
 			const plugin = serverPluginForType(preflight.expected.type, this.#registry);
 			if (!plugin.descriptor.accepts.includes(raw.extension)) throw new SourceImportError("invalid-response", `The ${preflight.expected.type} type does not accept ".${raw.extension}" files.`);
 			const previousName = rawFileNameOfPath(preflight.expected.raw);
@@ -1984,6 +2096,79 @@ var FundusOperations = class {
 			}
 		});
 	}
+	/**
+	* Edit a Figma tag asset's tag, fileKey, and/or scale in place. Because in tag
+	* mode the tag IS the asset id, changing the tag renames the asset (moves the
+	* library key); changing only fileKey/scale is an in-place re-point. Mirrors
+	* `reimportAsset`'s three phases: preflight in the queue, materialize outside
+	* it, then commit atomically through `store.repointTagAsset`.
+	*/
+	async retagFigmaAsset(id, input) {
+		const snapshot = await this.#enqueueOperation(async () => {
+			const library = await this.#store.read();
+			this.#requireAsset(library, id);
+			const record = library.assets[id];
+			const currentTag = figmaTagOf(record.importSource);
+			if (currentTag === null || !record.importSource) throw new SourceImportError("invalid-input", `Asset "${id}" is not a Figma tag import.`);
+			const current = validateFigmaSourceParameters(record.importSource.parameters);
+			const newTag = input.tag ?? currentTag;
+			const fileKey = input.fileKey ?? current.fileKey;
+			const scale = input.scale ?? current.scale;
+			if (newTag !== id) {
+				const problem = assetIdError(newTag);
+				if (problem) throw new SourceImportError("invalid-input", problem);
+				if (Object.hasOwn(library.assets, newTag)) throw new SourceImportError("invalid-input", `An asset with id "${newTag}" already exists.`);
+				const candidate = structuredClone(library);
+				candidate.assets[newTag] = candidate.assets[id];
+				delete candidate.assets[id];
+				await this.#assertNoIntroducedIssues(library, candidate);
+			}
+			try {
+				await verifyStableRawFile(join(this.#config.rawDir, record.raw), record.rawHash);
+			} catch {
+				throw new SourceImportError("stale-import", "The local raw file changed. Apply or discard that edit before retagging.");
+			}
+			const importer = this.#importers.require("figma");
+			return {
+				importer,
+				input: importer.validateInput({
+					mode: "tag",
+					tag: newTag,
+					fileKey,
+					scale,
+					format: "png"
+				}),
+				newTag,
+				expected: {
+					raw: record.raw,
+					rawHash: record.rawHash,
+					type: record.type,
+					canonicalSource: canonicalizeParameters(record.importSource)
+				}
+			};
+		});
+		const raw = await snapshot.importer.importRaw(snapshot.input, {
+			config: this.#config,
+			fetch: globalThis.fetch
+		});
+		if (!raw.importSource) throw new SourceImportError("invalid-response", "The Figma importer did not return provenance for the retagged source.");
+		const importSource = raw.importSource;
+		return this.#enqueueOperation(async () => {
+			this.#validateImportedRaw(raw, snapshot.importer.kind);
+			if (figmaTagOf(importSource) !== snapshot.newTag) throw new SourceImportError("invalid-response", `The Figma importer resolved a different tag than "${snapshot.newTag}".`);
+			const plugin = serverPluginForType(snapshot.expected.type, this.#registry);
+			if (!plugin.descriptor.accepts.includes(raw.extension)) throw new SourceImportError("invalid-response", `The ${snapshot.expected.type} type does not accept ".${raw.extension}" files.`);
+			const pixelRatio = figmaSlicePixelRatio(raw, snapshot.expected.type);
+			let library;
+			try {
+				library = await this.#store.repointTagAsset(id, snapshot.newTag, raw.bytes, snapshot.expected, importSource, pixelRatio === void 0 ? void 0 : (parameters) => plugin.descriptor.validateParameters(mergeParameterPatch(parameters, { pixelRatio })));
+			} catch (cause) {
+				if (cause instanceof Error && cause.message === "stale-import") throw new SourceImportError("stale-import", "The asset or local raw file changed while Figma was exporting. Nothing was changed.");
+				throw cause;
+			}
+			return this.#afterMutation(library);
+		});
+	}
 	async #createImportedAsset(raw, options) {
 		this.#validateImportedRaw(raw);
 		const fileName = raw.suggestedFileName ?? `${options.id}.${raw.extension}`;
@@ -2164,6 +2349,7 @@ var FundusOperations = class {
 	async #renameAsset(id, newId) {
 		const library = await this.#store.read();
 		this.#requireAsset(library, id);
+		if (figmaTagOf(library.assets[id].importSource) !== null) throw new SourceImportError("invalid-input", "This asset is referenced by a Figma tag and cannot be renamed; re-import with a new tag instead.");
 		if (newId !== id && !Object.hasOwn(library.assets, newId)) {
 			const candidate = structuredClone(library);
 			candidate.assets[newId] = candidate.assets[id];
@@ -2381,7 +2567,10 @@ var FundusOperations = class {
 			gitBranch,
 			library,
 			assets,
-			importDefaults: { figma: { scale: this.#config.import.figma.defaults.scale } },
+			importDefaults: { figma: {
+				scale: this.#config.import.figma.defaults.scale,
+				...this.#config.import.figma.defaultFileKey !== void 0 ? { defaultFileKey: this.#config.import.figma.defaultFileKey } : {}
+			} },
 			issues,
 			presetNames,
 			presetCapabilities,
@@ -2605,4 +2794,4 @@ async function createFundusContext() {
 }
 
 export { getFundusContext as g, initializeFundusContext as i };
-//# sourceMappingURL=context.js-BXaBgcZT.js.map
+//# sourceMappingURL=context.js-Dh0ibRIF.js.map