@kitschpatrol/unplugin-tldraw 1.0.0

package/dist/api.d.ts

@@ -0,0 +1,50 @@
+import { n as Options, r as resolveOptions, t as ImportOverrides } from "./options-OhkbiFS8.js";
+
+//#region src/core/tldraw.d.ts
+declare class TldrawExport {
+  /**
+   * Pattern matching `.tldr` file imports. The `resolveId` hook filters on
+   * this.
+   */
+  get identifierPattern(): RegExp;
+  private readonly convertLimit;
+  private readonly options;
+  private readonly pathsSeen;
+  private readonly pendingRequests;
+  private persistentCacheDirty;
+  private readonly resolvedCache;
+  private get cacheFilePath();
+  constructor(options?: Options);
+  /**
+   * Converts a `.tldr` file to an image and returns the absolute path of the
+   * cached image. Uses caching, request deduplication, and concurrency
+   * limiting.
+   *
+   * @param tldrPath - Absolute or relative path to the `.tldr` file.
+   * @param overrides - Per-import option overrides (from query params).
+   */
+  convert(tldrPath: string, overrides?: ImportOverrides): Promise<string>;
+  /**
+   * Initialize the cache directory and load persistent cache from disk.
+   */
+  initialize(): Promise<void>;
+  /**
+   * Delete cached files that were not used during this build.
+   */
+  pruneCache(): Promise<void>;
+  /**
+   * Persist the in-memory cache to disk.
+   */
+  savePersistentCache(): Promise<void>;
+  private doConvert;
+  private fromRelativeCacheKey;
+  /**
+   * Checks if a cached result still matches the source file's content hash.
+   */
+  private isFileHashCurrent;
+  private loadPersistentCache;
+  private relativePath;
+  private toRelativeCacheKey;
+}
+//#endregion
+export { TldrawExport, resolveOptions };

package/dist/api.js

@@ -0,0 +1,2 @@
+import { r as resolveOptions, t as TldrawExport } from "./tldraw-ZdwazU9j.js";
+export { TldrawExport, resolveOptions };

package/dist/bun.d.ts

@@ -0,0 +1,12 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$unplugin from "unplugin";
+
+//#region src/bun.d.ts
+/**
+ * This entry file is for Bun plugin.
+ *
+ * @module
+ */
+declare const _default: _$unplugin.UnpluginFactory<Options | undefined, boolean>;
+//#endregion
+export { _default as default };

package/dist/bun.js

@@ -0,0 +1,5 @@
+import { unpluginFactory } from "./index.js";
+import { createUnplugin } from "unplugin";
+var bun_default = createUnplugin(unpluginFactory).raw;
+//#endregion
+export { bun_default as default };

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+declare module '*.tldr' {
+	const content: string
+	export default content
+}
+
+// Workarounds for https://github.com/microsoft/TypeScript/issues/38638
+// Required when using query params on .tldr imports (e.g. `import x from './sketch.tldr?format=png&tldr'`)
+
+declare module '*&tldr' {
+	const content: string
+	export default content
+}
+
+declare module '*&tldraw' {
+	const content: string
+	export default content
+}

package/dist/esbuild.d.ts

@@ -0,0 +1,21 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$esbuild from "esbuild";
+
+//#region src/esbuild.d.ts
+/**
+ * This entry file is for esbuild plugin.
+ *
+ * @module
+ */
+/**
+ * Esbuild plugin
+ *
+ * @example
+ * 	import { build } from 'esbuild'
+ * 	import tldraw from '@kitschpatrol/unplugin-tldraw/esbuild'
+ *
+ * 	build({ plugins: [tldraw()] })
+ */
+declare const _default: (options?: Options | undefined) => _$esbuild.Plugin;
+//#endregion
+export { _default as default };

package/dist/esbuild.js

@@ -0,0 +1,20 @@
+import { unpluginFactory } from "./index.js";
+import { createEsbuildPlugin } from "unplugin";
+//#region src/esbuild.ts
+/**
+* This entry file is for esbuild plugin.
+*
+* @module
+*/
+/**
+* Esbuild plugin
+*
+* @example
+* 	import { build } from 'esbuild'
+* 	import tldraw from '@kitschpatrol/unplugin-tldraw/esbuild'
+*
+* 	build({ plugins: [tldraw()] })
+*/
+var esbuild_default = createEsbuildPlugin(unpluginFactory);
+//#endregion
+export { esbuild_default as default };

package/dist/farm.d.ts

@@ -0,0 +1,23 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$_farmfe_core0 from "@farmfe/core";
+
+//#region src/farm.d.ts
+/**
+ * This entry file is for Farm plugin.
+ *
+ * @module
+ */
+/**
+ * Farm plugin
+ *
+ * @example
+ * 	// farm.config.js
+ * 	import tldraw from '@kitschpatrol/unplugin-tldraw/farm'
+ *
+ * 	export default {
+ * 		plugins: [tldraw()],
+ * 	}
+ */
+declare const _default: (options?: Options | undefined) => _$_farmfe_core0.JsPlugin;
+//#endregion
+export { _default as default };

package/dist/farm.js

@@ -0,0 +1,22 @@
+import { unpluginFactory } from "./index.js";
+import { createFarmPlugin } from "unplugin";
+//#region src/farm.ts
+/**
+* This entry file is for Farm plugin.
+*
+* @module
+*/
+/**
+* Farm plugin
+*
+* @example
+* 	// farm.config.js
+* 	import tldraw from '@kitschpatrol/unplugin-tldraw/farm'
+*
+* 	export default {
+* 		plugins: [tldraw()],
+* 	}
+*/
+var farm_default = createFarmPlugin(unpluginFactory);
+//#endregion
+export { farm_default as default };

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$unplugin from "unplugin";
+import { UnpluginFactory } from "unplugin";
+
+//#region src/index.d.ts
+declare const unpluginFactory: UnpluginFactory<Options | undefined>;
+declare const unplugin: _$unplugin.UnpluginInstance<Options | undefined, boolean>;
+//#endregion
+export { unplugin as default, unplugin, unpluginFactory };

package/dist/index.js

@@ -0,0 +1,34 @@
+import { n as parseImportOverrides, t as TldrawExport } from "./tldraw-ZdwazU9j.js";
+import path from "node:path";
+import { createUnplugin } from "unplugin";
+//#region src/index.ts
+const unpluginFactory = (options) => {
+	const tldrawExport = new TldrawExport(options);
+	return {
+		async buildEnd() {
+			await tldrawExport.savePersistentCache();
+		},
+		async buildStart() {
+			await tldrawExport.initialize();
+		},
+		enforce: "pre",
+		name: "unplugin-tldraw",
+		resolveId: {
+			filter: { id: tldrawExport.identifierPattern },
+			async handler(id, importer) {
+				const queryIndex = id.indexOf("?");
+				const cleanId = queryIndex === -1 ? id : id.slice(0, queryIndex);
+				const queryString = queryIndex === -1 ? "" : id.slice(queryIndex + 1);
+				const resolvedPath = importer && (cleanId.startsWith("./") || cleanId.startsWith("../")) ? path.resolve(path.dirname(importer), cleanId) : cleanId;
+				const overrides = queryString ? parseImportOverrides(queryString) : void 0;
+				return tldrawExport.convert(resolvedPath, overrides);
+			}
+		},
+		async writeBundle() {
+			await tldrawExport.pruneCache();
+		}
+	};
+};
+const unplugin = /* @__PURE__ */ createUnplugin(unpluginFactory);
+//#endregion
+export { unplugin as default, unplugin, unpluginFactory };

package/dist/nuxt.d.ts

@@ -0,0 +1,17 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$_nuxt_schema0 from "@nuxt/schema";
+
+//#region src/nuxt.d.ts
+type ModuleOptions = Options;
+/**
+ * Nuxt module
+ *
+ * @example
+ * 	// nuxt.config.ts
+ * 	export default defineNuxtConfig({
+ * 		modules: ['@kitschpatrol/unplugin-tldraw/nuxt'],
+ * 	})
+ */
+declare const _default: _$_nuxt_schema0.NuxtModule<Options, Options, false>;
+//#endregion
+export { ModuleOptions, _default as default };

package/dist/nuxt.js

@@ -0,0 +1,30 @@
+import vite_default from "./vite.js";
+import webpack_default from "./webpack.js";
+import { addVitePlugin, addWebpackPlugin, defineNuxtModule } from "@nuxt/kit";
+//#region src/nuxt.ts
+/**
+* This entry file is for Nuxt module.
+*
+* @module
+*/
+/**
+* Nuxt module
+*
+* @example
+* 	// nuxt.config.ts
+* 	export default defineNuxtConfig({
+* 		modules: ['@kitschpatrol/unplugin-tldraw/nuxt'],
+* 	})
+*/
+var nuxt_default = defineNuxtModule({
+	meta: {
+		configKey: "tldraw",
+		name: "@kitschpatrol/unplugin-tldraw"
+	},
+	setup(options) {
+		addVitePlugin(() => vite_default(options));
+		addWebpackPlugin(() => webpack_default(options));
+	}
+});
+//#endregion
+export { nuxt_default as default };

package/dist/options-OhkbiFS8.d.ts

@@ -0,0 +1,61 @@
+import { TldrawToImageOptions } from "@kitschpatrol/tldraw-cli";
+
+//#region src/core/options.d.ts
+/**
+ * Image conversion options for `.tldr` exports.
+ * Subset of `@kitschpatrol/tldraw-cli` options relevant to image output.
+ */
+type TldrawImageOptions = Pick<TldrawToImageOptions, 'dark' | 'format' | 'padding' | 'scale' | 'stripStyle' | 'transparent'>;
+/**
+ * Per-import overrides parsed from query params on `.tldr` import paths.
+ * Extends TldrawImageOptions with frame/page selection.
+ */
+type ImportOverrides = TldrawImageOptions & {
+  /** Export a specific frame by name or ID. */frame?: string; /** Export a specific page by name, ID, or index. */
+  page?: string;
+};
+type Options = {
+  /**
+   * Directory to store converted images.
+   * Resolved relative to Vite's `cacheDir` at runtime if not absolute.
+   * @default './node_modules/.cache/tldraw'
+   */
+  cacheDirectory?: string;
+  /**
+   * Enable caching of generated image files.
+   * Cache keys include a hash of the `.tldr` file content and image options,
+   * so cached files are automatically invalidated when the source changes.
+   * @default true
+   */
+  cacheEnabled?: boolean;
+  /**
+   * Default image conversion options for all `.tldr` imports.
+   */
+  defaultImageOptions?: TldrawImageOptions;
+  /**
+   * Maximum number of concurrent `.tldr` conversions.
+   * Lower values reduce system load (each conversion spawns a headless browser).
+   * @default 2
+   */
+  maxConcurrentConversions?: number;
+  /**
+   * Delete all files in `cacheDirectory` that are not in the converted
+   * image set at the end of a full build.
+   * @default false
+   */
+  pruneCacheOnBuild?: boolean;
+  /**
+   * Log conversion details and performance information to the console.
+   * @default false
+   */
+  verbose?: boolean;
+};
+type ResolvedOptions = Required<Options> & {
+  defaultImageOptions: Required<TldrawImageOptions>;
+};
+/**
+ * Resolve and normalize user options.
+ */
+declare function resolveOptions(options?: Options): ResolvedOptions;
+//#endregion
+export { Options as n, resolveOptions as r, ImportOverrides as t };

package/dist/rolldown.d.ts

@@ -0,0 +1,23 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$unplugin from "unplugin";
+
+//#region src/rolldown.d.ts
+/**
+ * This entry file is for Rolldown plugin.
+ *
+ * @module
+ */
+/**
+ * Rolldown plugin
+ *
+ * @example
+ * 	// rolldown.config.js
+ * 	import tldraw from '@kitschpatrol/unplugin-tldraw/rolldown'
+ *
+ * 	export default {
+ * 		plugins: [tldraw()],
+ * 	}
+ */
+declare const _default: (options?: Options | undefined) => _$unplugin.RolldownPlugin<any> | _$unplugin.RolldownPlugin<any>[];
+//#endregion
+export { _default as default };

package/dist/rolldown.js

@@ -0,0 +1,22 @@
+import { unpluginFactory } from "./index.js";
+import { createRolldownPlugin } from "unplugin";
+//#region src/rolldown.ts
+/**
+* This entry file is for Rolldown plugin.
+*
+* @module
+*/
+/**
+* Rolldown plugin
+*
+* @example
+* 	// rolldown.config.js
+* 	import tldraw from '@kitschpatrol/unplugin-tldraw/rolldown'
+*
+* 	export default {
+* 		plugins: [tldraw()],
+* 	}
+*/
+var rolldown_default = createRolldownPlugin(unpluginFactory);
+//#endregion
+export { rolldown_default as default };

package/dist/rollup.d.ts

@@ -0,0 +1,23 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+import * as _$rollup from "rollup";
+
+//#region src/rollup.d.ts
+/**
+ * This entry file is for Rollup plugin.
+ *
+ * @module
+ */
+/**
+ * Rollup plugin
+ *
+ * @example
+ * 	// rollup.config.js
+ * 	import tldraw from '@kitschpatrol/unplugin-tldraw/rollup'
+ *
+ * 	export default {
+ * 		plugins: [tldraw()],
+ * 	}
+ */
+declare const _default: (options?: Options | undefined) => _$rollup.Plugin<any> | _$rollup.Plugin<any>[];
+//#endregion
+export { _default as default };

package/dist/rollup.js

@@ -0,0 +1,22 @@
+import { unpluginFactory } from "./index.js";
+import { createRollupPlugin } from "unplugin";
+//#region src/rollup.ts
+/**
+* This entry file is for Rollup plugin.
+*
+* @module
+*/
+/**
+* Rollup plugin
+*
+* @example
+* 	// rollup.config.js
+* 	import tldraw from '@kitschpatrol/unplugin-tldraw/rollup'
+*
+* 	export default {
+* 		plugins: [tldraw()],
+* 	}
+*/
+var rollup_default = createRollupPlugin(unpluginFactory);
+//#endregion
+export { rollup_default as default };

package/dist/rspack.d.ts

@@ -0,0 +1,22 @@
+import { n as Options } from "./options-OhkbiFS8.js";
+
+//#region src/rspack.d.ts
+/**
+ * This entry file is for Rspack plugin.
+ *
+ * @module
+ */
+/**
+ * Rspack plugin
+ *
+ * @example
+ * 	// rspack.config.js
+ * 	import tldraw from '@kitschpatrol/unplugin-tldraw/rspack'
+ *
+ * 	export default {
+ * 		plugins: [tldraw()],
+ * 	}
+ */
+declare const _default: (options?: Options | undefined) => RspackPluginInstance;
+//#endregion
+export { _default as default };

package/dist/rspack.js

@@ -0,0 +1,22 @@
+import { unpluginFactory } from "./index.js";
+import { createRspackPlugin } from "unplugin";
+//#region src/rspack.ts
+/**
+* This entry file is for Rspack plugin.
+*
+* @module
+*/
+/**
+* Rspack plugin
+*
+* @example
+* 	// rspack.config.js
+* 	import tldraw from '@kitschpatrol/unplugin-tldraw/rspack'
+*
+* 	export default {
+* 		plugins: [tldraw()],
+* 	}
+*/
+var rspack_default = createRspackPlugin(unpluginFactory);
+//#endregion
+export { rspack_default as default };