@tileflow/dev 0.1.0-alpha.23 → 0.1.0-alpha.24

package/dist/{chunk-G5FUSWNN.js → chunk-XS5Q4IS2.js}

@@ -1,7 +1,7 @@
 import {
   createTileflowArtifactSession,
   tileflowArtifactSessionSchemaVersion
-} from "./chunk-XTRHREXO.js";
+} from "./chunk-XXVI42UZ.js";
 import {
   normalizeTileflowBasePath
 } from "./chunk-RSBV4L2Y.js";

package/dist/{chunk-XTRHREXO.js → chunk-XXVI42UZ.js}

@@ -10,7 +10,7 @@ import {
 import {
   getTileflowIconWatchPaths,
   prepareTileflowCatalogIcons
-} from "./chunk-CENQR5Q2.js";
+} from "./chunk-NUHSYLLS.js";
 import {
   TileflowStyleValidationError,
   normalizeTileflowStyleValidationIssues,

package/dist/fonts.d.ts

@@ -1,6 +1,6 @@
 import { TileflowFontBundleManifest, MapLibreStyle } from '@tileflow/core';
 import { TileflowEffectiveFontSourceIdentity, TileflowBuildStyles, TileflowBuildCatalog } from '@tileflow/core/build';
-import { TileflowBuildAsset } from './icons.js';
+import { e as TileflowBuildAsset } from './icons-CkLVtaP-.js';
 
 type TileflowFontCompilationTarget = 'hosted' | 'local';
 type TileflowFontCompilationIssue = {

package/dist/icons-CkLVtaP-.d.ts

@@ -0,0 +1,164 @@
+import { TileflowIconPackageFileName, TileflowIconPackageManifest, TileflowIconDirectory } from '@tileflow/core';
+import { TileflowBuildCatalog, TileflowPreparedMapAssets, TileflowEffectiveIconSourceIdentity } from '@tileflow/core/build';
+
+type TileflowRenderedIconCell = {
+    height: number;
+    width: number;
+    rgba: Uint8Array;
+};
+type TileflowRenderedIcon = {
+    id: string;
+    oneX: TileflowRenderedIconCell;
+    twoX: TileflowRenderedIconCell;
+};
+/** Pack independently rendered densities without scaling or re-rasterizing either input. */
+declare function packTileflowRenderedIcons(input: readonly TileflowRenderedIcon[]): Promise<CompiledTileflowIconPackage>;
+
+type TileflowBuildAsset = {
+    contentType: string;
+    fileName: string;
+    source: string | Uint8Array;
+};
+/** Executable authoring input before local sources have been resolved into runtime URLs. */
+type TileflowSourceCatalog = TileflowBuildCatalog;
+declare const preparedTileflowBuildCatalog: unique symbol;
+/** A validated catalog paired with build-owned portable assets. */
+type PreparedTileflowBuildCatalog = TileflowBuildCatalog & {
+    readonly [preparedTileflowBuildCatalog]: true;
+};
+type PreparedTileflowCatalog = {
+    assets: TileflowBuildAsset[];
+    baseDirectory: string;
+    cwd: string;
+    mapAssets: Record<string, TileflowPreparedMapAssets>;
+    mapIconSources: Record<string, readonly TileflowEffectiveIconSourceIdentity[]>;
+    project: PreparedTileflowBuildCatalog;
+    sourceProject: TileflowSourceCatalog;
+    watchPaths: string[];
+};
+type TileflowIconCompilationTarget = 'hosted' | 'local';
+type TileflowIconCompilationIssue = {
+    message: string;
+    path: string;
+};
+type CompiledTileflowIconPackageFile = {
+    contentType: 'application/json' | 'image/png';
+    fileName: TileflowIconPackageFileName;
+    source: Uint8Array;
+};
+type CompiledTileflowIconPackage = {
+    contentHash: string;
+    files: CompiledTileflowIconPackageFile[];
+    manifest: TileflowIconPackageManifest;
+};
+type TileflowMapIconPackageBinding = {
+    iconIds: readonly string[];
+    label: string;
+    mapName: string;
+    packageHash: string;
+};
+type CompileTileflowIconPackagesResult = {
+    bindings: TileflowMapIconPackageBinding[];
+    packages: CompiledTileflowIconPackage[];
+    sourceIdentities: Record<string, readonly TileflowEffectiveIconSourceIdentity[]>;
+    watchPaths: string[];
+};
+type InspectTileflowIconCatalogsOptions = {
+    baseDirectory?: string;
+    cwd: string;
+    mapNames?: readonly string[];
+};
+type TileflowIconCatalogSourceFormat = 'jpeg' | 'png' | 'svg' | 'webp';
+type TileflowIconCatalogAtlasRectangle = {
+    height: number;
+    width: number;
+    x: number;
+    y: number;
+};
+type TileflowIconCatalogRenderedDensity = {
+    atlas: TileflowIconCatalogAtlasRectangle;
+    height: number;
+    pixelRatio: 1 | 2;
+    pixelSha256: string;
+    width: number;
+};
+type TileflowIconCatalogIcon = {
+    id: string;
+    rendered: {
+        oneX: TileflowIconCatalogRenderedDensity;
+        twoX: TileflowIconCatalogRenderedDensity;
+    };
+    source: {
+        byteLength: number;
+        dimensions: {
+            height: number;
+            width: number;
+        } | null;
+        format: TileflowIconCatalogSourceFormat;
+        path: string;
+    };
+};
+type TileflowIconCatalog = {
+    compiledPackage: CompiledTileflowIconPackage;
+    directories: string[];
+    icons: TileflowIconCatalogIcon[];
+    insideWorkingTree: boolean;
+    replacements: TileflowIconReplacement[];
+};
+type TileflowIconReplacement = {
+    id: string;
+    replaced: string;
+    winner: string;
+};
+type TileflowIconCatalogMap = {
+    name: string;
+    icons: {
+        directories: string[];
+        iconIds: string[];
+        kind: 'directories';
+        label: string;
+        packageHash: string;
+    } | {
+        kind: 'none';
+    };
+};
+type TileflowIconCatalogInspection = {
+    catalogs: TileflowIconCatalog[];
+    maps: TileflowIconCatalogMap[];
+};
+declare class TileflowIconCompilationError extends Error {
+    readonly code: "ICON_INVALID";
+    readonly issues: TileflowIconCompilationIssue[];
+    readonly phase: "icon-compilation";
+    constructor(issues: TileflowIconCompilationIssue[]);
+}
+declare const iconFileExtensions: Set<string>;
+declare function compileTileflowIconPackages(project: TileflowBuildCatalog, options: {
+    baseDirectory?: string;
+    cwd: string;
+    target: TileflowIconCompilationTarget;
+}): Promise<CompileTileflowIconPackagesResult>;
+declare function inspectTileflowIconCatalogs(project: TileflowBuildCatalog, options: InspectTileflowIconCatalogsOptions): Promise<TileflowIconCatalogInspection>;
+declare function prepareTileflowCatalogIcons(project: TileflowBuildCatalog, options: {
+    assetBaseUrl: string;
+    baseDirectory?: string;
+    cwd: string;
+}): Promise<PreparedTileflowCatalog>;
+declare function getTileflowIconWatchPaths(project: TileflowBuildCatalog, cwd: string, baseDirectory?: string): Promise<string[]>;
+
+/** A bounded local source snapshot used by the explicit shared-composition build port. */
+declare function readTileflowIconDirectory(source: TileflowIconDirectory, options: {
+    cwd: string;
+    baseDirectory: string;
+    target: TileflowIconCompilationTarget;
+}): Promise<{
+    iconIds: string[];
+    watchPath?: string;
+    render: (ids: readonly string[]) => Promise<Array<{
+        icon: TileflowRenderedIcon;
+        identity: TileflowEffectiveIconSourceIdentity;
+        sourceBytes: number;
+    }>>;
+}>;
+
+export { type CompiledTileflowIconPackage as C, type InspectTileflowIconCatalogsOptions as I, type PreparedTileflowBuildCatalog as P, type TileflowRenderedIcon as T, type TileflowIconCompilationTarget as a, type CompileTileflowIconPackagesResult as b, type CompiledTileflowIconPackageFile as c, type PreparedTileflowCatalog as d, type TileflowBuildAsset as e, type TileflowIconCatalog as f, type TileflowIconCatalogAtlasRectangle as g, type TileflowIconCatalogIcon as h, type TileflowIconCatalogInspection as i, type TileflowIconCatalogMap as j, type TileflowIconCatalogRenderedDensity as k, type TileflowIconCatalogSourceFormat as l, TileflowIconCompilationError as m, type TileflowIconCompilationIssue as n, type TileflowIconReplacement as o, type TileflowMapIconPackageBinding as p, type TileflowRenderedIconCell as q, type TileflowSourceCatalog as r, compileTileflowIconPackages as s, getTileflowIconWatchPaths as t, iconFileExtensions as u, inspectTileflowIconCatalogs as v, packTileflowRenderedIcons as w, prepareTileflowCatalogIcons as x, readTileflowIconDirectory as y };

package/dist/icons.d.ts

@@ -1,136 +1,3 @@
-import { TileflowIconPackageFileName, TileflowIconPackageManifest } from '@tileflow/core';
-import { TileflowBuildCatalog, TileflowPreparedMapAssets, TileflowEffectiveIconSourceIdentity } from '@tileflow/core/build';
-
-type TileflowBuildAsset = {
-    contentType: string;
-    fileName: string;
-    source: string | Uint8Array;
-};
-/** Executable authoring input before local sources have been resolved into runtime URLs. */
-type TileflowSourceCatalog = TileflowBuildCatalog;
-declare const preparedTileflowBuildCatalog: unique symbol;
-/** A validated catalog paired with build-owned portable assets. */
-type PreparedTileflowBuildCatalog = TileflowBuildCatalog & {
-    readonly [preparedTileflowBuildCatalog]: true;
-};
-type PreparedTileflowCatalog = {
-    assets: TileflowBuildAsset[];
-    baseDirectory: string;
-    cwd: string;
-    mapAssets: Record<string, TileflowPreparedMapAssets>;
-    mapIconSources: Record<string, readonly TileflowEffectiveIconSourceIdentity[]>;
-    project: PreparedTileflowBuildCatalog;
-    sourceProject: TileflowSourceCatalog;
-    watchPaths: string[];
-};
-type TileflowIconCompilationTarget = 'hosted' | 'local';
-type TileflowIconCompilationIssue = {
-    message: string;
-    path: string;
-};
-type CompiledTileflowIconPackageFile = {
-    contentType: 'application/json' | 'image/png';
-    fileName: TileflowIconPackageFileName;
-    source: Uint8Array;
-};
-type CompiledTileflowIconPackage = {
-    contentHash: string;
-    files: CompiledTileflowIconPackageFile[];
-    manifest: TileflowIconPackageManifest;
-};
-type TileflowMapIconPackageBinding = {
-    iconIds: readonly string[];
-    label: string;
-    mapName: string;
-    packageHash: string;
-};
-type CompileTileflowIconPackagesResult = {
-    bindings: TileflowMapIconPackageBinding[];
-    packages: CompiledTileflowIconPackage[];
-    sourceIdentities: Record<string, readonly TileflowEffectiveIconSourceIdentity[]>;
-    watchPaths: string[];
-};
-type InspectTileflowIconCatalogsOptions = {
-    baseDirectory?: string;
-    cwd: string;
-    mapNames?: readonly string[];
-};
-type TileflowIconCatalogSourceFormat = 'jpeg' | 'png' | 'svg' | 'webp';
-type TileflowIconCatalogAtlasRectangle = {
-    height: number;
-    width: number;
-    x: number;
-    y: number;
-};
-type TileflowIconCatalogRenderedDensity = {
-    atlas: TileflowIconCatalogAtlasRectangle;
-    height: number;
-    pixelRatio: 1 | 2;
-    pixelSha256: string;
-    width: number;
-};
-type TileflowIconCatalogIcon = {
-    id: string;
-    rendered: {
-        oneX: TileflowIconCatalogRenderedDensity;
-        twoX: TileflowIconCatalogRenderedDensity;
-    };
-    source: {
-        byteLength: number;
-        dimensions: {
-            height: number;
-            width: number;
-        } | null;
-        format: TileflowIconCatalogSourceFormat;
-        path: string;
-    };
-};
-type TileflowIconCatalog = {
-    compiledPackage: CompiledTileflowIconPackage;
-    directories: string[];
-    icons: TileflowIconCatalogIcon[];
-    insideWorkingTree: boolean;
-    replacements: TileflowIconReplacement[];
-};
-type TileflowIconReplacement = {
-    id: string;
-    replaced: string;
-    winner: string;
-};
-type TileflowIconCatalogMap = {
-    name: string;
-    icons: {
-        directories: string[];
-        iconIds: string[];
-        kind: 'directories';
-        label: string;
-        packageHash: string;
-    } | {
-        kind: 'none';
-    };
-};
-type TileflowIconCatalogInspection = {
-    catalogs: TileflowIconCatalog[];
-    maps: TileflowIconCatalogMap[];
-};
-declare class TileflowIconCompilationError extends Error {
-    readonly code: "ICON_INVALID";
-    readonly issues: TileflowIconCompilationIssue[];
-    readonly phase: "icon-compilation";
-    constructor(issues: TileflowIconCompilationIssue[]);
-}
-declare const iconFileExtensions: Set<string>;
-declare function compileTileflowIconPackages(project: TileflowBuildCatalog, options: {
-    baseDirectory?: string;
-    cwd: string;
-    target: TileflowIconCompilationTarget;
-}): Promise<CompileTileflowIconPackagesResult>;
-declare function inspectTileflowIconCatalogs(project: TileflowBuildCatalog, options: InspectTileflowIconCatalogsOptions): Promise<TileflowIconCatalogInspection>;
-declare function prepareTileflowCatalogIcons(project: TileflowBuildCatalog, options: {
-    assetBaseUrl: string;
-    baseDirectory?: string;
-    cwd: string;
-}): Promise<PreparedTileflowCatalog>;
-declare function getTileflowIconWatchPaths(project: TileflowBuildCatalog, cwd: string, baseDirectory?: string): Promise<string[]>;
-
-export { type CompileTileflowIconPackagesResult, type CompiledTileflowIconPackage, type CompiledTileflowIconPackageFile, type InspectTileflowIconCatalogsOptions, type PreparedTileflowBuildCatalog, type PreparedTileflowCatalog, type TileflowBuildAsset, type TileflowIconCatalog, type TileflowIconCatalogAtlasRectangle, type TileflowIconCatalogIcon, type TileflowIconCatalogInspection, type TileflowIconCatalogMap, type TileflowIconCatalogRenderedDensity, type TileflowIconCatalogSourceFormat, TileflowIconCompilationError, type TileflowIconCompilationIssue, type TileflowIconCompilationTarget, type TileflowIconReplacement, type TileflowMapIconPackageBinding, type TileflowSourceCatalog, compileTileflowIconPackages, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, prepareTileflowCatalogIcons };
+import '@tileflow/core';
+export { b as CompileTileflowIconPackagesResult, C as CompiledTileflowIconPackage, c as CompiledTileflowIconPackageFile, I as InspectTileflowIconCatalogsOptions, P as PreparedTileflowBuildCatalog, d as PreparedTileflowCatalog, e as TileflowBuildAsset, f as TileflowIconCatalog, g as TileflowIconCatalogAtlasRectangle, h as TileflowIconCatalogIcon, i as TileflowIconCatalogInspection, j as TileflowIconCatalogMap, k as TileflowIconCatalogRenderedDensity, l as TileflowIconCatalogSourceFormat, m as TileflowIconCompilationError, n as TileflowIconCompilationIssue, a as TileflowIconCompilationTarget, o as TileflowIconReplacement, p as TileflowMapIconPackageBinding, r as TileflowSourceCatalog, s as compileTileflowIconPackages, t as getTileflowIconWatchPaths, u as iconFileExtensions, v as inspectTileflowIconCatalogs, x as prepareTileflowCatalogIcons, y as readTileflowIconDirectory } from './icons-CkLVtaP-.js';
+import '@tileflow/core/build';

package/dist/icons.js

@@ -4,8 +4,9 @@ import {
   getTileflowIconWatchPaths,
   iconFileExtensions,
   inspectTileflowIconCatalogs,
-  prepareTileflowCatalogIcons
-} from "./chunk-CENQR5Q2.js";
+  prepareTileflowCatalogIcons,
+  readTileflowIconDirectory
+} from "./chunk-NUHSYLLS.js";
 import "./chunk-BL3FK4GO.js";
 export {
   TileflowIconCompilationError,
@@ -13,5 +14,6 @@ export {
   getTileflowIconWatchPaths,
   iconFileExtensions,
   inspectTileflowIconCatalogs,
-  prepareTileflowCatalogIcons
+  prepareTileflowCatalogIcons,
+  readTileflowIconDirectory
 };

package/dist/index.d.ts

@@ -1,13 +1,62 @@
 export { CreateTileflowArtifactPlanOptions, TileflowArtifactAcquisition, TileflowArtifactDiagnostic, TileflowArtifactFile, TileflowArtifactInputGraph, TileflowArtifactPlan, TileflowArtifactSession, TileflowArtifactSessionOptions, TileflowArtifactSessionState, TileflowBuildArtifacts, TileflowBuildArtifactsOptions, TileflowBuildStyleInspections, TileflowHostedManifestOverwriteError, TileflowLocalTilesetFile, TileflowLocalTilesetProductionError, TileflowManifestOptions, WriteTileflowArtifactPlanOptions, WriteTileflowBuildArtifactsOptions, assertNoLocalTilesetsForProduction, assertTileflowSelfHostedManifestTarget, createTileflowArtifactDiagnostics, createTileflowArtifactPlan, createTileflowArtifactSession, createTileflowBuildArtifacts, createTileflowBuildProvenance, createTileflowManifest, createTileflowStyle, createTileflowStyles, disposeTileflowBuildArtifacts, getTileflowArtifactFiles, getTileflowAssetBasePath, getTileflowAssetFileName, getTileflowWatchPaths, isTileflowArtifactInputPath, joinTileflowPublicUrl, normalizeTileflowBasePath, prepareTileflowLocalTilesets, refreshTileflowArtifactSession, resolveTileflowArtifactPublicUrls, tileflowArtifactInventoryFileName, tileflowArtifactPlanSchemaVersion, tileflowArtifactSessionSchemaVersion, writeTileflowArtifactPlan, writeTileflowBuildArtifacts } from './artifacts.js';
 export { LoadTileflowConfigOptions, LoadedTileflowConfig, TileflowValidationError, assertValidTileflowConfig, defaultTileflowApiUrl, defaultTileflowConfigPath, defaultTileflowManifestPath, getFirstTileflowMapName, getTileflowMapNames, loadTileflowConfig, loadTileflowConfigWithInputs, loadValidTileflowConfig, loadValidTileflowConfigWithInputs } from './config.js';
 export { CompiledTileflowFontBundle, PrepareTileflowStyleFontsOptions, PreparedTileflowStyleFonts, TileflowFontCompilationError, TileflowFontCompilationIssue, TileflowFontCompilationTarget, bindTileflowStyleFontBundle, getTileflowFontWatchPaths, prepareTileflowStyleFonts, replaceTileflowStyleFontSources } from './fonts.js';
-export { CompileTileflowIconPackagesResult, CompiledTileflowIconPackage, CompiledTileflowIconPackageFile, InspectTileflowIconCatalogsOptions, PreparedTileflowBuildCatalog, PreparedTileflowCatalog, TileflowBuildAsset, TileflowIconCatalog, TileflowIconCatalogAtlasRectangle, TileflowIconCatalogIcon, TileflowIconCatalogInspection, TileflowIconCatalogMap, TileflowIconCatalogRenderedDensity, TileflowIconCatalogSourceFormat, TileflowIconCompilationError, TileflowIconCompilationIssue, TileflowIconCompilationTarget, TileflowIconReplacement, TileflowMapIconPackageBinding, TileflowSourceCatalog, compileTileflowIconPackages, getTileflowIconWatchPaths, iconFileExtensions, inspectTileflowIconCatalogs, prepareTileflowCatalogIcons } from './icons.js';
+import { C as CompiledTileflowIconPackage, T as TileflowRenderedIcon, a as TileflowIconCompilationTarget } from './icons-CkLVtaP-.js';
+export { b as CompileTileflowIconPackagesResult, c as CompiledTileflowIconPackageFile, I as InspectTileflowIconCatalogsOptions, P as PreparedTileflowBuildCatalog, d as PreparedTileflowCatalog, e as TileflowBuildAsset, f as TileflowIconCatalog, g as TileflowIconCatalogAtlasRectangle, h as TileflowIconCatalogIcon, i as TileflowIconCatalogInspection, j as TileflowIconCatalogMap, k as TileflowIconCatalogRenderedDensity, l as TileflowIconCatalogSourceFormat, m as TileflowIconCompilationError, n as TileflowIconCompilationIssue, o as TileflowIconReplacement, p as TileflowMapIconPackageBinding, q as TileflowRenderedIconCell, r as TileflowSourceCatalog, s as compileTileflowIconPackages, t as getTileflowIconWatchPaths, u as iconFileExtensions, v as inspectTileflowIconCatalogs, w as packTileflowRenderedIcons, x as prepareTileflowCatalogIcons, y as readTileflowIconDirectory } from './icons-CkLVtaP-.js';
 export { TileflowConfigInspection, TileflowConfigInspectionError, TileflowConfigInspectionOptions, TileflowFeatureInspection, TileflowFeatureInspectionOptions, TileflowInspectedFeature, TileflowInspectedProperty, TileflowMapLineageInspection, TileflowMapMergeProvenance, TileflowResolvedMapInspection, TileflowThemeContractInspection, TileflowThemeDifferenceInspection, TileflowThemeInspection, inspectLoadedTileflowConfig, inspectTileflowConfig, inspectTileflowFeatures, sanitizeTileflowInspectableValue } from './inspect.js';
 export { ResolvedTileflowPreview, TileflowLandmark, TileflowLandmarkArchive, TileflowLandmarkAxisConvention, TileflowLandmarkManifestV2, TileflowLandmarkModel, TileflowPreviewSelection, TileflowPreviewSelectionError, normalizeTileflowLandmarkManifest, readBoundedTileflowJsonResponse, readBoundedTileflowResponse, renderTileflowPreviewHtml, resolveTileflowPreview } from './preview.js';
 export { TileflowComparisonMode, TileflowComparisonOptions, TileflowComparisonRequestHandler, TileflowComparisonSide, TileflowDevRequestHandler, TileflowDevRequestHandlerOptions, createTileflowArtifactStatus, createTileflowComparisonRequestHandler, createTileflowDevRequestHandler, createTileflowNodeRequest, getTileflowRequestPath, getTileflowStyleInspectionSelection, getTileflowStyleSelection, isTileflowRequestUrl, tileflowComparisonSchemaVersion, writeTileflowNodeResponse } from './server.js';
 export { T as TileflowLocalTilesetInspection, a as TileflowTilesetInspectionV1, b as TileflowTilesetInspectionWarning, i as inspectTileflowPmtiles, c as inspectTileflowPmtilesForLocalUse } from './tilesets-C0tGeenP.js';
 export { TileflowCommandFailureDocument, TileflowCommandSummary, TileflowDiagnosticSeverity, TileflowStructuredDiagnostic, TileflowStyleValidationError, TileflowStyleValidationIssue, assertValidTileflowStyle, createTileflowCommandFailureDocument, createTileflowCommandSummary, createTileflowStructuredDiagnostics, sanitizeDiagnosticSecrets, serializeTileflowCommandDocument, tileflowCommandDocumentSchemaVersion, validateTileflowStyle } from './validation.js';
-import '@tileflow/core';
-import '@tileflow/core/build';
+import { TileflowIconSetPin, TileflowIconCompositionV1, TileflowIconSource, TileflowIconsLockfileV1 } from '@tileflow/core';
+import { TileflowEffectiveIconSourceIdentity } from '@tileflow/core/build';
 import '@tileflow/core/manifest';
 import 'node:http';
+
+type VerifiedTileflowIconArtifact = {
+    package: CompiledTileflowIconPackage;
+    icons: TileflowRenderedIcon[];
+};
+/** Verify exact compressed bytes and independently decode/hash every cell at both densities. */
+declare function verifyTileflowIconArtifact(input: CompiledTileflowIconPackage): Promise<VerifiedTileflowIconArtifact>;
+
+type TileflowIconCacheOptions = {
+    /** Parent of the versioned tileflow/icons/v1 cache, not a serialized lock setting. */
+    cacheRoot?: string;
+    offline?: boolean;
+    /** Trusted application configuration. A lock cannot extend this allowlist. */
+    deliveryOrigins?: readonly string[];
+    fetch?: typeof globalThis.fetch;
+    signal?: AbortSignal;
+};
+declare function getTileflowIconCacheDirectory(options?: Pick<TileflowIconCacheOptions, 'cacheRoot'>): string;
+/** Read and verify an exact pin; a cache miss never resolves a newer version. */
+declare function loadTileflowIconSetArtifact(input: TileflowIconSetPin, options?: TileflowIconCacheOptions): Promise<VerifiedTileflowIconArtifact>;
+/** Seed or repair a disposable cache using verified generated bytes, never original artwork. */
+declare function storeTileflowIconSetArtifact(input: TileflowIconSetPin, artifact: CompiledTileflowIconPackage, options?: Pick<TileflowIconCacheOptions, 'cacheRoot'>): Promise<VerifiedTileflowIconArtifact>;
+
+type ComposeTileflowIconSourcesOptions = TileflowIconCacheOptions & {
+    cwd: string;
+    baseDirectory?: string;
+    lock?: unknown;
+    target?: TileflowIconCompilationTarget;
+};
+type TileflowComposedIconSources = {
+    package: CompiledTileflowIconPackage | null;
+    composition: TileflowIconCompositionV1 | null;
+    sourceIdentities: TileflowEffectiveIconSourceIdentity[];
+    replacements: Array<{
+        id: string;
+        replaced: number;
+        winner: number;
+    }>;
+    watchPaths: string[];
+};
+/** Foundational build port. Registry and command integration are intentionally separate. */
+declare function composeTileflowIconSources(input: readonly TileflowIconSource[], options: ComposeTileflowIconSourcesOptions): Promise<TileflowComposedIconSources>;
+
+declare function readTileflowIconsLockfile(baseDirectory: string, sources?: readonly TileflowIconSource[]): Promise<TileflowIconsLockfileV1>;
+/** Compare-and-swap the whole lock. Never rewrite executable config or lose another writer's pin. */
+declare function writeTileflowIconsLockfile(baseDirectory: string, input: TileflowIconsLockfileV1, expectedContents: string | null): Promise<void>;
+
+export { CompiledTileflowIconPackage, type ComposeTileflowIconSourcesOptions, type TileflowComposedIconSources, type TileflowIconCacheOptions, TileflowIconCompilationTarget, TileflowRenderedIcon, type VerifiedTileflowIconArtifact, composeTileflowIconSources, getTileflowIconCacheDirectory, loadTileflowIconSetArtifact, readTileflowIconsLockfile, storeTileflowIconSetArtifact, verifyTileflowIconArtifact, writeTileflowIconsLockfile };