@templatical/core 0.34.3 → 0.36.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { i as useEditor, n as UseEditorOptions, r as UseEditorReturn, t as EditorState } from "./editor-Bl4WsPU3.js";
-import { Block, BlockDefaults, BlockType, Comment, CommentAuthor, CommentInput, CommentPatch, CommentsListParams, CommentsProvider, CustomBlock, CustomBlockDefinition, SavedBlock, SavedBlockPatch, SavedBlocksListParams, SavedBlocksProvider, Template, TemplateContent, TemplateSettings, TemplateVersion, VersionHistoryListParams, VersionHistoryProvider } from "@templatical/types";
+import { Block, BlockDefaults, BlockType, Comment, CommentAuthor, CommentInput, CommentPatch, CommentsListParams, CommentsProvider, CustomBlock, CustomBlockDefinition, MediaProvider, SavedBlock, SavedBlockPatch, SavedBlocksListParams, SavedBlocksProvider, Template, TemplateContent, TemplateSettings, TemplateVersion, VersionHistoryListParams, VersionHistoryProvider } from "@templatical/types";
 import { ComputedRef, Ref } from "@vue/reactivity";
 import { ComputedRef as ComputedRef$1, Ref as Ref$1 } from "vue";
 //#region src/history.d.ts
@@ -231,6 +231,31 @@ interface LocalStorageSavedBlocksOptions {
  */
 export declare function createLocalStorageSavedBlocksProvider(options?: LocalStorageSavedBlocksOptions): SavedBlocksProvider;
 //#endregion
+//#region src/media-local.d.ts
+interface LocalStorageMediaProviderOptions {
+  /**
+   * `localStorage` key holding the serialized array.
+   *
+   * @default "templatical:media"
+   */
+  key?: string;
+}
+/**
+ * Browser-local {@link MediaProvider} backed by `localStorage`.
+ *
+ * Opt-in: pass it explicitly as `init({ media: createLocalStorageMediaProvider() })`.
+ * The editor never falls back to it, so consumers without a provider keep
+ * image fields URL-only.
+ *
+ * `create` stores the file as a data URL. That is a demo-sized persistence
+ * model — `localStorage` quotas are typically ~5 MB, and a few large
+ * images will fill it. Back a real gallery with your own API.
+ *
+ * Folders, replace, import, usage, frequently-used and quota are `false`:
+ * this adapter is a flat list of assets.
+ */
+export declare function createLocalStorageMediaProvider(options?: LocalStorageMediaProviderOptions): MediaProvider;
+//#endregion
 //#region src/version-history.d.ts
 interface UseVersionHistoryOptions {
   /**
@@ -394,5 +419,5 @@ interface UseCommentListenerOptions {
  */
 export declare function useCommentListener(options: UseCommentListenerOptions): void;
 //#endregion
-export { type EditorState, type LocalStorageSavedBlocksOptions, type UseAutoSaveOptions, type UseAutoSaveReturn, type UseBlockActionsOptions, type UseBlockActionsReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseConditionPreviewReturn, type UseEditorOptions, type UseEditorReturn, type UseHistoryOptions, type UseHistoryReturn, type UseSavedBlocksOptions, type UseSavedBlocksReturn, type UseVersionHistoryOptions, type UseVersionHistoryReturn, useEditor };
+export { type EditorState, type LocalStorageMediaProviderOptions, type LocalStorageSavedBlocksOptions, type UseAutoSaveOptions, type UseAutoSaveReturn, type UseBlockActionsOptions, type UseBlockActionsReturn, type UseCommentListenerOptions, type UseCommentsOptions, type UseCommentsReturn, type UseConditionPreviewReturn, type UseEditorOptions, type UseEditorReturn, type UseHistoryOptions, type UseHistoryReturn, type UseSavedBlocksOptions, type UseSavedBlocksReturn, type UseVersionHistoryOptions, type UseVersionHistoryReturn, useEditor };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -796,7 +796,7 @@ function useSavedBlocks(options) {
 }
 //#endregion
 //#region src/saved-blocks-local.ts
-const DEFAULT_KEY = "templatical:saved-blocks";
+const DEFAULT_KEY$1 = "templatical:saved-blocks";
 /**
 * Browser-local {@link SavedBlocksProvider} backed by `localStorage`.
 *
@@ -810,7 +810,7 @@ const DEFAULT_KEY = "templatical:saved-blocks";
 * that needs to outlive a browser profile.
 */
 function createLocalStorageSavedBlocksProvider(options = {}) {
-	const storageKey = options.key ?? DEFAULT_KEY;
+	const storageKey = options.key ?? DEFAULT_KEY$1;
 	function getStorage() {
 		if (typeof localStorage === "undefined") throw new Error("[Templatical] createLocalStorageSavedBlocksProvider requires a browser environment with localStorage. Supply your own SavedBlocksProvider for server-side or non-browser use.");
 		return localStorage;
@@ -874,6 +874,125 @@ function createLocalStorageSavedBlocksProvider(options = {}) {
 	};
 }
 //#endregion
+//#region src/media-local.ts
+const DEFAULT_KEY = "templatical:media";
+const PAGE_SIZE = 50;
+/**
+* Browser-local {@link MediaProvider} backed by `localStorage`.
+*
+* Opt-in: pass it explicitly as `init({ media: createLocalStorageMediaProvider() })`.
+* The editor never falls back to it, so consumers without a provider keep
+* image fields URL-only.
+*
+* `create` stores the file as a data URL. That is a demo-sized persistence
+* model — `localStorage` quotas are typically ~5 MB, and a few large
+* images will fill it. Back a real gallery with your own API.
+*
+* Folders, replace, import, usage, frequently-used and quota are `false`:
+* this adapter is a flat list of assets.
+*/
+function createLocalStorageMediaProvider(options = {}) {
+	const storageKey = options.key ?? DEFAULT_KEY;
+	function getStorage() {
+		if (typeof localStorage === "undefined") throw new Error("[Templatical] createLocalStorageMediaProvider requires a browser environment with localStorage. Supply your own MediaProvider for server-side or non-browser use.");
+		return localStorage;
+	}
+	function readAll() {
+		const raw = getStorage().getItem(storageKey);
+		if (!raw) return [];
+		try {
+			const parsed = JSON.parse(raw);
+			return Array.isArray(parsed) ? parsed : [];
+		} catch {
+			return [];
+		}
+	}
+	function writeAll(assets) {
+		getStorage().setItem(storageKey, JSON.stringify(assets));
+	}
+	function readFileAsDataURL(file) {
+		if (typeof FileReader === "undefined") return Promise.reject(/* @__PURE__ */ new Error("[Templatical] createLocalStorageMediaProvider requires a browser environment with FileReader."));
+		return new Promise((resolve, reject) => {
+			const reader = new FileReader();
+			reader.onload = () => {
+				if (typeof reader.result !== "string") {
+					reject(/* @__PURE__ */ new Error("[Templatical] Failed to read file as a data URL."));
+					return;
+				}
+				resolve(reader.result);
+			};
+			reader.onerror = () => {
+				reject(reader.error ?? /* @__PURE__ */ new Error("[Templatical] Failed to read file as a data URL."));
+			};
+			reader.readAsDataURL(file);
+		});
+	}
+	return {
+		async list(params) {
+			const all = readAll();
+			const search = params?.search?.trim().toLowerCase();
+			const filtered = search ? all.filter((asset) => {
+				const filename = asset.filename?.toLowerCase() ?? "";
+				const alt = asset.alt?.toLowerCase() ?? "";
+				return filename.includes(search) || alt.includes(search);
+			}) : all;
+			const parsed = params?.cursor ? Number.parseInt(params.cursor, 10) : 0;
+			const offset = Number.isFinite(parsed) && parsed > 0 ? parsed : 0;
+			const items = filtered.slice(offset, offset + PAGE_SIZE);
+			const page = { items };
+			const nextOffset = offset + items.length;
+			if (nextOffset < filtered.length) page.nextCursor = String(nextOffset);
+			return page;
+		},
+		async create(input) {
+			const url = await readFileAsDataURL(input.file);
+			const now = (/* @__PURE__ */ new Date()).toISOString();
+			const created = {
+				id: generateId(),
+				url,
+				filename: input.filename || input.file.name,
+				createdAt: now,
+				updatedAt: now,
+				size: input.file.size
+			};
+			if (input.alt !== void 0) created.alt = input.alt;
+			if (input.file.type) created.mimeType = input.file.type;
+			if (input.folderId !== void 0) created.folderId = input.folderId;
+			writeAll([created, ...readAll()]);
+			return created;
+		},
+		async update(id, patch) {
+			const all = readAll();
+			const index = all.findIndex((asset) => asset.id === id);
+			if (index === -1) throw new Error(`[Templatical] Media asset not found: ${id}`);
+			const current = all[index];
+			const updated = {
+				...current,
+				...patch,
+				id: current.id,
+				url: current.url,
+				updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+			};
+			const next = [...all];
+			next[index] = updated;
+			writeAll(next);
+			return updated;
+		},
+		async delete(ids) {
+			const all = readAll();
+			for (const id of ids) if (!all.some((asset) => asset.id === id)) throw new Error(`[Templatical] Media asset not found: ${id}`);
+			const remove = new Set(ids);
+			writeAll(all.filter((asset) => !remove.has(asset.id)));
+		},
+		folders: false,
+		replace: false,
+		importFromUrl: false,
+		checkUsage: false,
+		frequentlyUsed: false,
+		storage: false
+	};
+}
+//#endregion
 //#region src/version-history.ts
 /**
 * Reactive state over a {@link VersionHistoryProvider}.
@@ -1299,6 +1418,6 @@ function useCommentListener(options) {
 	onScopeDispose(stop);
 }
 //#endregion
-export { DEFAULT_AUTO_SAVE_DEBOUNCE_MS, createLocalStorageSavedBlocksProvider, useAutoSave, useBlockActions, useCommentListener, useComments, useConditionPreview, useDataSourceFetch, useEditor, useHistory, useHistoryInterceptor, useSavedBlocks, useVersionHistory };
+export { DEFAULT_AUTO_SAVE_DEBOUNCE_MS, createLocalStorageMediaProvider, createLocalStorageSavedBlocksProvider, useAutoSave, useBlockActions, useCommentListener, useComments, useConditionPreview, useDataSourceFetch, useEditor, useHistory, useHistoryInterceptor, useSavedBlocks, useVersionHistory };
 
 //# sourceMappingURL=index.js.map