@widgetic/editor 4.1.2 → 4.1.4

package/README.md

@@ -1,5 +1,7 @@
 ### WIDGET PROPERTIES EDITOR
 
+> **Internal building block.** This package is part of Widgetic's own apps and is not a supported integration surface. Partners: use [`@widgetic/ui-sdk`](https://www.npmjs.com/package/@widgetic/ui-sdk) instead.
+
 
 A Svelte Component Module that will be loaded and used to edit the widget properties: design and content.
 
@@ -377,6 +379,8 @@ Note that you need to add the right deploy script that copies the dist folder to
 
 ## Deploy the component to the npm package registry
 
+GitLab CI on `main` publishes this package. Bump `version` in `package.json` and push `main`. The job is an npm Trusted Publisher (`NPM_ID_TOKEN`) and skips a version that is already on npm. `npm publish` below is the laptop fallback when CI minutes are gone. The token stays in `~/.npmrc` and is never committed.
+
 ```bash
 npm publish
 ```

package/dist/components/editors/CompositionEditorApp.svelte

@@ -30,6 +30,8 @@
 	import { shareTextDirection, type TextDirection } from '@widgetic/design-system/components/textDirection';
 	import { leftOnThisScreen } from '../../utils/dockPlacement';
 	import { provideEditorLanguage } from '../../i18n/language.js';
+	import type { PartnerPickFileFn } from '../../pickFileContext.js';
+	import type { StoreFileUrlFn } from '../../fileStorageUrlContext.js';
 	import PropsEditor from './PropsEditor.svelte';
 	import WidgetPreview from '../WidgetPreview.svelte';
 	import { setGoogleFontsApiKey } from '../../config';
@@ -74,6 +76,15 @@
 	 * library. Without it the files are the ones of the Widgetic library the token can see.
 	 */
 	export let mediaLibrary: MediaLibraryProvider | undefined = undefined;
+	/** When given, file fields call this instead of opening the built-in File Browser. */
+	export let pickFile: PartnerPickFileFn | undefined = undefined;
+	/** When given, resolves the url stored with a picked file (partner `mediaLibrary.urlResolver`). */
+	export let storeFileUrl: StoreFileUrlFn | undefined = undefined;
+	/**
+	 * When true, dragging or typing a preview size changes the preview on screen but does not change the embed width and
+	 * height saved with the composition.
+	 */
+	export let lockPreviewSize = false;
 	/** The key the font pickers list Google Fonts with. Without one only the fonts that need no key are listed. */
 	export let googleFontsApiKey = '';
 	/** Wait this long after the last change before saving by itself; `0` turns saving by itself off. Read once, when the editor starts. */
@@ -130,6 +141,7 @@
 		compositionId,
 		api,
 		autosaveDelayMs,
+		lockPreviewSize,
 		// The sentences the controller makes (why there is no preview) are made in the language of the moment.
 		translate: (key, values) => get(language.t)(key, values),
 		// The preview page hears about every change as it happens (and everything, once its page has loaded).
@@ -508,6 +520,8 @@
 			initialDesignValues={state.designValues}
 			initialContentValues={propsEditorContentValues}
 			mediaLibrary={mediaLibrary ?? defaultMediaLibrary}
+			{pickFile}
+			{storeFileUrl}
 			width="{EDITOR_WIDTH_PX}px"
 			height="{floatingEditorHeight}px"
 			showDragHandle={true}

package/dist/components/editors/CompositionEditorApp.svelte.d.ts

@@ -1,6 +1,8 @@
 import { type MediaLibraryProvider } from '@widgetic/file-browser';
 import type { MessageOverrides } from '@widgetic/design-system/i18n';
 import { type TextDirection } from '@widgetic/design-system/components/textDirection';
+import type { PartnerPickFileFn } from '../../pickFileContext.js';
+import type { StoreFileUrlFn } from '../../fileStorageUrlContext.js';
 import { type TokenReason } from '../../composition/compositionApi.js';
 import { type CompositionEditorState, type EditorFailure } from '../../composition/compositionEditorController.js';
 interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
@@ -32,6 +34,12 @@ declare const CompositionEditorApp: $$__sveltets_2_IsomorphicComponent<{
          * Where the file picker gets its files, when they are not the Widgetic library: the partner's own media
          * library. Without it the files are the ones of the Widgetic library the token can see.
          */ mediaLibrary?: MediaLibraryProvider | undefined;
+    /** When given, file fields call this instead of opening the built-in File Browser. */ pickFile?: PartnerPickFileFn | undefined;
+    /** When given, resolves the url stored with a picked file (partner `mediaLibrary.urlResolver`). */ storeFileUrl?: StoreFileUrlFn | undefined;
+    /**
+         * When true, dragging or typing a preview size changes the preview on screen but does not change the embed width and
+         * height saved with the composition.
+         */ lockPreviewSize?: boolean;
     /** The key the font pickers list Google Fonts with. Without one only the fonts that need no key are listed. */ googleFontsApiKey?: string;
     /** Wait this long after the last change before saving by itself; `0` turns saving by itself off. Read once, when the editor starts. */ autosaveDelayMs?: number | undefined;
     /** Writes what the layout does to the console. */ debug?: boolean;

package/dist/components/editors/PropsEditor.svelte

@@ -90,6 +90,8 @@
     } from '../../utils/shadowDom';
     import { config as appConfig } from '../../config';
     import { provideEditorMediaLibrary } from '../../mediaLibraryContext';
+    import { provideEditorPickFile, type PartnerPickFileFn } from '../../pickFileContext';
+    import { provideEditorStoreFileUrl, type StoreFileUrlFn } from '../../fileStorageUrlContext';
     import { useEditorLanguage } from '../../i18n/language';
     import type { MediaLibraryProvider } from '@widgetic/file-browser';
 
@@ -181,8 +183,14 @@
      * storage (a CMS, an S3 bucket, a DAM) can be used with no Widgetic storage at all.
      */
     export let mediaLibrary: MediaLibraryProvider | undefined = undefined;
+    /** When given, file fields call this instead of opening the built-in File Browser. */
+    export let pickFile: PartnerPickFileFn | undefined = undefined;
+    /** When given, resolves the url stored with a picked file (partner `mediaLibrary.urlResolver`). */
+    export let storeFileUrl: StoreFileUrlFn | undefined = undefined;
     // The file controls are created from the schema several components down: give them the library through context.
     provideEditorMediaLibrary(() => mediaLibrary);
+    provideEditorPickFile(() => pickFile);
+    provideEditorStoreFileUrl(() => storeFileUrl);
 
     // The words of the editor in the language of the page: the editor above this one chose it (see `provideEditorLanguage`).
     const { t } = useEditorLanguage();

package/dist/components/editors/PropsEditor.svelte.d.ts

@@ -1,4 +1,6 @@
 import type { ContentSchemaView, DesignSchemaView } from '../../schemaViews.js';
+import { type PartnerPickFileFn } from '../../pickFileContext';
+import { type StoreFileUrlFn } from '../../fileStorageUrlContext';
 import type { MediaLibraryProvider } from '@widgetic/file-browser';
 /**
      * STYLES from Widgetic Design System
@@ -52,6 +54,8 @@ declare const PropsEditor: $$__sveltets_2_IsomorphicComponent<{
          * `MediaLibraryProvider` they list, upload, rename and delete through its functions instead, so a partner's own
          * storage (a CMS, an S3 bucket, a DAM) can be used with no Widgetic storage at all.
          */ mediaLibrary?: MediaLibraryProvider | undefined;
+    /** When given, file fields call this instead of opening the built-in File Browser. */ pickFile?: PartnerPickFileFn | undefined;
+    /** When given, resolves the url stored with a picked file (partner `mediaLibrary.urlResolver`). */ storeFileUrl?: StoreFileUrlFn | undefined;
     updateDesignValue?: (propertyId: string, value: any) => void;
     setPosition?: (left: number, top: number) => void;
     getPosition?: () => {

package/dist/components/ic/BrowserInputController.svelte

@@ -32,10 +32,12 @@
   import { onDestroy, tick } from 'svelte';
 
   // Shadcn UI Components
-  import { Portal, Tooltip } from '@widgetic/design-system/components';
+  import { Portal, Tooltip, showToast } from '@widgetic/design-system/components';
   import { ThumbHashImage } from "@widgetic/design-system/components";
   import { FileBrowser, setFileBrowserUploadConfig, persistentSelectStore } from '@widgetic/file-browser';
   import { useEditorMediaLibrary } from '../../mediaLibraryContext';
+  import { useEditorPickFile, type PartnerPickFile } from '../../pickFileContext';
+  import { useEditorStoreFileUrl } from '../../fileStorageUrlContext';
   import { useEditorLanguage } from '../../i18n/language';
   import type { EditorMessageKey } from '../../i18n/messages';
   import type { Translate } from '@widgetic/design-system/i18n';
@@ -74,6 +76,9 @@
   // The media library the editor above was given (a partner's own storage, for instance), read through a getter
   // because it reaches this component through context.
   const getEditorMediaLibrary = useEditorMediaLibrary();
+  const getEditorPickFile = useEditorPickFile();
+  const getEditorStoreFileUrl = useEditorStoreFileUrl();
+  let pickAbortController: AbortController | null = null;
 
   // The words of the editor in the language of the page, and the share of them that belongs to the File Browser inside it.
   const { t, fileBrowser: fileBrowserLanguage } = useEditorLanguage();
@@ -218,7 +223,56 @@
     }
   }
 
+  function acceptPatternsForField(): string[] {
+    if (!fileTypes?.length || fileTypes.includes('*')) return ['*/*'];
+    return fileTypes;
+  }
+
+  async function storedUrlFor(file: PartnerPickFile): Promise<string> {
+    const storeFileUrl = getEditorStoreFileUrl();
+    if (!storeFileUrl) return file.url;
+    try {
+      return await storeFileUrl(file);
+    } catch (error) {
+      console.warn('[editor] storeFileUrl failed; using the file url.', error);
+      return file.url;
+    }
+  }
+
+  async function applyPickedFile(selectedFile: PartnerPickFile) {
+    const url = await storedUrlFor(selectedFile);
+    const nextValue: FileValue = {
+      id: selectedFile.id,
+      file: selectedFile.name || '',
+      url,
+      hash: selectedFile.hash
+    };
+    value = nextValue;
+    onChange(nextValue);
+  }
+
   async function openFileBrowser() {
+    const pickFile = getEditorPickFile();
+    if (pickFile) {
+      pickAbortController?.abort();
+      pickAbortController = new AbortController();
+      const signal = pickAbortController.signal;
+      try {
+        const picked = await pickFile({ accept: acceptPatternsForField(), multiple: false, signal });
+        if (signal.aborted) return;
+        const selectedFile = picked?.[0];
+        if (!selectedFile) return;
+        await applyPickedFile(selectedFile);
+      } catch (error) {
+        if (signal.aborted) return;
+        const name = error instanceof Error ? error.name : '';
+        if (name === 'AbortError') return;
+        console.error('[editor] pickFile failed:', error);
+        showToast('error', $t('editor.file.pickFailed'));
+      }
+      return;
+    }
+
     try {
       syncFileBrowserUploadConfigIfEmbedded();
       // console.log('BrowserInputController: opening file browser', {
@@ -240,7 +294,7 @@
     setPortalHostInteractive(false);
   }
 
-  function handleFileBrowserSelect(event: CustomEvent<{ files?: Array<FileValue & { name?: string; thumbnail?: string }> }>) {
+  async function handleFileBrowserSelect(event: CustomEvent<{ files?: Array<FileValue & { name?: string; thumbnail?: string }> }>) {
     try {
       const selectedFile = event.detail?.files?.[0];
       if (!selectedFile) {
@@ -248,21 +302,12 @@
         return;
       }
 
-      const nextValue: FileValue = {
+      await applyPickedFile({
         id: selectedFile.id,
-        file: selectedFile.file || selectedFile.name || '',
+        name: selectedFile.name || selectedFile.file || '',
         url: selectedFile.url,
         hash: selectedFile.hash
-      };
-
-      // console.log('BrowserInputController: selected file', {
-        // id: nextValue.id,
-        // file: nextValue.file,
-        // url: nextValue.url
-      // });
-
-      value = nextValue;
-      onChange(nextValue);
+      });
       closeFileBrowser();
     } catch (error) {
       console.error('BrowserInputController: failed to select file', error);
@@ -292,6 +337,8 @@
   }
 
   onDestroy(() => {
+    pickAbortController?.abort();
+    pickAbortController = null;
     clearTimeout(showHelpTimeout);
     setPortalHostInteractive(false);
     if (audioElement) {

package/dist/composition/compositionEditorController.d.ts

@@ -148,6 +148,11 @@ export interface CompositionEditorOptions {
      * Default: English.
      */
     translate?: Translate<EditorMessageKey>;
+    /**
+     * When true, resizing the preview changes how it is drawn but never updates the embed width and height that are saved
+     * with the composition (the partner owns embed size elsewhere).
+     */
+    lockPreviewSize?: boolean;
 }
 /** What went wrong, from whatever was thrown. */
 export declare function describeFailure(error: unknown): EditorFailure;

package/dist/composition/compositionEditorController.js

@@ -515,6 +515,14 @@ export class CompositionEditorController {
         // (The preview reports the size it was just given, too: that is not a new size.)
         if (previewWidth === this.state.previewWidth && previewHeight === this.state.previewHeight)
             return;
+        if (this.options.lockPreviewSize === true) {
+            this.patch({
+                previewWidth,
+                previewHeight,
+                deviceView: 'desktop'
+            });
+            return;
+        }
         const embedChanged = previewWidth !== this.state.embedWidth || previewHeight !== this.state.embedHeight;
         this.patch({
             previewWidth,

package/dist/fileStorageUrlContext.d.ts

@@ -0,0 +1,6 @@
+import type { PartnerPickFile } from './pickFileContext';
+/** Resolves the address stored with a composition for a picked file (partner `mediaLibrary.urlResolver`). */
+export type StoreFileUrlFn = (file: PartnerPickFile) => Promise<string>;
+export type StoreFileUrlGetter = () => StoreFileUrlFn | undefined;
+export declare function provideEditorStoreFileUrl(getStoreFileUrl: StoreFileUrlGetter): void;
+export declare function useEditorStoreFileUrl(): StoreFileUrlGetter;

package/dist/fileStorageUrlContext.js

@@ -0,0 +1,13 @@
+import { getContext, setContext } from 'svelte';
+const STORE_FILE_URL_CONTEXT_KEY = Symbol.for('widgetic.editor.storeFileUrl');
+export function provideEditorStoreFileUrl(getStoreFileUrl) {
+    setContext(STORE_FILE_URL_CONTEXT_KEY, getStoreFileUrl);
+}
+export function useEditorStoreFileUrl() {
+    try {
+        return getContext(STORE_FILE_URL_CONTEXT_KEY) ?? (() => undefined);
+    }
+    catch {
+        return () => undefined;
+    }
+}

package/dist/i18n/language.d.ts

@@ -1,4 +1,3 @@
-import { SHAD_EDITOR_MESSAGES } from '@widgetic/design-system/shad-editor';
 export type { EditorCatalogs, EditorLanguage, EditorLanguageHandle } from './languageKit.js';
 /**
  * The language of an editor on a page. The editor has two packages inside it (the File Browser that picks a file, and
@@ -145,6 +144,7 @@ export declare const EDITOR_CATALOGS: {
         readonly 'editor.file.notFound': "File not found";
         readonly 'editor.file.emptyFolder': "Empty folder";
         readonly 'editor.file.clear': "Clear file";
+        readonly 'editor.file.pickFailed': "Could not choose a file. Try again.";
         readonly 'editor.file.dialogTitle': "Select file";
         readonly 'editor.file.closeDialog': "Close file browser";
         readonly 'editor.color.noRecent': "No recent colors";
@@ -206,7 +206,93 @@ export declare const EDITOR_CATALOGS: {
         readonly 'editor.schema.subtitleFont': "Subtitle Font";
     };
     readonly fileBrowser: any;
-    readonly shadEditor: any;
+    readonly shadEditor: {
+        readonly 'shadEditor.toolbar.undo': "Undo (\u2318Z)";
+        readonly 'shadEditor.toolbar.redo': "Redo (\u2318\u21E7Z)";
+        readonly 'shadEditor.toolbar.bold': "Bold (\u2318B)";
+        readonly 'shadEditor.toolbar.italic': "Italic (\u2318I)";
+        readonly 'shadEditor.toolbar.underline': "Underline (\u2318U)";
+        readonly 'shadEditor.toolbar.strikethrough': "Strike (\u2318\u21E7S)";
+        readonly 'shadEditor.toolbar.subscript': "Subscript (\u2318,)";
+        readonly 'shadEditor.toolbar.superscript': "Superscript (\u2318.)";
+        readonly 'shadEditor.toolbar.code': "Code (\u2318E)";
+        readonly 'shadEditor.toolbar.blockQuote': "Block Quote (\u2318\u21E7B)";
+        readonly 'shadEditor.toolbar.bulletList': "Bullet List (\u2318\u21E78)";
+        readonly 'shadEditor.toolbar.orderedList': "Ordered List";
+        readonly 'shadEditor.toolbar.taskList': "Tasks List (\u2318\u21E79)";
+        readonly 'shadEditor.text.tooltip': "Text Formatting";
+        readonly 'shadEditor.text.heading1': "Heading 1";
+        readonly 'shadEditor.text.heading2': "Heading 2";
+        readonly 'shadEditor.text.heading3': "Heading 3";
+        readonly 'shadEditor.text.paragraph': "Paragraph";
+        readonly 'shadEditor.text.codeBlock': "Code Block";
+        readonly 'shadEditor.align.tooltip': "Text Alignment";
+        readonly 'shadEditor.align.left': "Align Left";
+        readonly 'shadEditor.align.center': "Align Center";
+        readonly 'shadEditor.align.right': "Align Right";
+        readonly 'shadEditor.align.justify': "Align Justify";
+        readonly 'shadEditor.link.tooltip': "Add Or Remove Link";
+        readonly 'shadEditor.link.title': "Link";
+        readonly 'shadEditor.link.hint': "Insert or remove link from selected text.";
+        readonly 'shadEditor.link.placeholder': "Enter link to attach..";
+        readonly 'shadEditor.link.insert': "Insert";
+        readonly 'shadEditor.link.remove': "Remove";
+        readonly 'shadEditor.image.tooltip': "Add Image";
+        readonly 'shadEditor.image.title': "Image";
+        readonly 'shadEditor.image.urlHint': "Insert image url";
+        readonly 'shadEditor.image.urlPlaceholder': "Enter image url...";
+        readonly 'shadEditor.image.orPick': "OR Pick an Image";
+        readonly 'shadEditor.table.tooltip': "Table";
+        readonly 'shadEditor.table.insert': "Insert Table";
+        readonly 'shadEditor.table.header': "Header";
+        readonly 'shadEditor.table.toggleColumn': "Toggle Column";
+        readonly 'shadEditor.table.toggleRow': "Toggle Row";
+        readonly 'shadEditor.table.toggleCell': "Toggle Cell";
+        readonly 'shadEditor.table.cells': "Cells";
+        readonly 'shadEditor.table.merge': "Merge";
+        readonly 'shadEditor.table.split': "Split";
+        readonly 'shadEditor.table.mergeOrSplit': "Merge or Split";
+        readonly 'shadEditor.table.row': "Row";
+        readonly 'shadEditor.table.insertAbove': "Insert Above";
+        readonly 'shadEditor.table.insertBelow': "Insert Below";
+        readonly 'shadEditor.table.deleteRow': "Delete Row";
+        readonly 'shadEditor.table.column': "Column";
+        readonly 'shadEditor.table.insertBefore': "Insert Before";
+        readonly 'shadEditor.table.insertAfter': "Insert After";
+        readonly 'shadEditor.table.deleteColumn': "Delete";
+        readonly 'shadEditor.table.deleteTable': "Delete";
+        readonly 'shadEditor.textColor.tooltip': "Text Color";
+        readonly 'shadEditor.textColor.pick': "Pick a text color";
+        readonly 'shadEditor.textColor.remove': "Remove Color";
+        readonly 'shadEditor.highlight.tooltip': "Highlighter (\u2318\u21E7H)";
+        readonly 'shadEditor.highlight.pick': "Pick a highlight color";
+        readonly 'shadEditor.highlight.remove': "Remove Highlight";
+        readonly 'shadEditor.quickColor.tooltip': "Quick Colors";
+        readonly 'shadEditor.quickColor.textColor': "Text Color";
+        readonly 'shadEditor.quickColor.backgroundColors': "Background Colors";
+        readonly 'shadEditor.colorName.default': "Default";
+        readonly 'shadEditor.colorName.blue': "Blue";
+        readonly 'shadEditor.colorName.brown': "Brown";
+        readonly 'shadEditor.colorName.green': "Green";
+        readonly 'shadEditor.colorName.grey': "Grey";
+        readonly 'shadEditor.colorName.orange': "Orange";
+        readonly 'shadEditor.colorName.pink': "Pink";
+        readonly 'shadEditor.colorName.purple': "Purple";
+        readonly 'shadEditor.colorName.red': "Red";
+        readonly 'shadEditor.colorName.yellow': "Yellow";
+        readonly 'shadEditor.colorPicker.label': "Pick a color";
+        readonly 'shadEditor.search.tooltip': "Search And Replace Text";
+        readonly 'shadEditor.search.searchPlaceholder': "Enter Text to search..";
+        readonly 'shadEditor.search.replacePlaceholder': "Enter Text to Replace..";
+        readonly 'shadEditor.search.caseSensitive': "Case Sensitive";
+        readonly 'shadEditor.search.position': "{index} / {count}";
+        readonly 'shadEditor.imageBlock.back': "Back";
+        readonly 'shadEditor.imageBlock.caption': "Caption";
+        readonly 'shadEditor.imageBlock.duplicate': "Duplicate";
+        readonly 'shadEditor.imageBlock.fullScreen': "Full Screen";
+        readonly 'shadEditor.imageBlock.delete': "Delete";
+        readonly 'shadEditor.imageBlock.defaultCaption': "Image Caption";
+    };
 };
 /** Every message of the editor and of the packages inside it, as one catalog: what a page's `messages` may have a key of. */
 export declare const ALL_EDITOR_MESSAGES: Readonly<Record<string, string>>;
@@ -215,12 +301,12 @@ export declare const ALL_EDITOR_MESSAGES: Readonly<Record<string, string>>;
  * the nearest real one), a value that is not text, a template that does not parse, or one that asks for a value the message
  * is never given. An empty list means every message will be used. For a test or a build step of the page.
  */
-export declare const checkEditorMessages: (messages: SHAD_EDITOR_MESSAGES) => SHAD_EDITOR_MESSAGES[];
+export declare const checkEditorMessages: (messages: import("@widgetic/design-system/i18n").MessageOverrides) => import("@widgetic/design-system/i18n").MessageProblem[];
 /**
  * Called by the root component of an editor while it is created, so everything inside it speaks the page's language.
  * The context belongs to one root component, so two editors on a page can speak two languages.
  */
-export declare const provideEditorLanguage: (initial: SHAD_EDITOR_MESSAGES) => import("./languageKit.js").EditorLanguageHandle;
+export declare const provideEditorLanguage: (initial: import("@widgetic/design-system/i18n").I18nSettings) => import("./languageKit.js").EditorLanguageHandle;
 /**
  * Called by a part of the editor while it is created. Gives its words as stores, so a part that is already on the screen
  * changes when the page sets the language again. Outside an editor (a control used on its own) it speaks English.

package/dist/i18n/messages.d.ts

@@ -164,6 +164,7 @@ export declare const EDITOR_MESSAGES: {
     readonly 'editor.file.notFound': "File not found";
     readonly 'editor.file.emptyFolder': "Empty folder";
     readonly 'editor.file.clear': "Clear file";
+    readonly 'editor.file.pickFailed': "Could not choose a file. Try again.";
     readonly 'editor.file.dialogTitle': "Select file";
     readonly 'editor.file.closeDialog': "Close file browser";
     readonly 'editor.color.noRecent': "No recent colors";

package/dist/i18n/messages.js

@@ -173,6 +173,7 @@ export const EDITOR_MESSAGES = {
     'editor.file.notFound': 'File not found',
     'editor.file.emptyFolder': 'Empty folder',
     'editor.file.clear': 'Clear file',
+    'editor.file.pickFailed': 'Could not choose a file. Try again.',
     'editor.file.dialogTitle': 'Select file',
     'editor.file.closeDialog': 'Close file browser',
     // ===== Colours =====

package/dist/i18n/translate.d.ts

@@ -3,4 +3,4 @@
  * its sentences with it until the page gives another translator). The editor's screens get their words, in the page's
  * language, from `useEditorLanguage` (see `language.ts`).
  */
-export declare const translateEnglish: any;
+export declare const translateEnglish: import("@widgetic/design-system/i18n").Translate<"editor.app.loading" | "editor.app.tryAgain" | "editor.app.retry" | "editor.failure.widgetNotPublished" | "editor.failure.sessionEndedWhileSaving" | "editor.failure.sessionEnded" | "editor.failure.compositionNotFound" | "editor.failure.noAccess" | "editor.failure.noWidget" | "editor.failure.widgetNotFound" | "editor.failure.saveNeedsConnection" | "editor.failure.loadNeedsConnection" | "editor.failure.saveFailed" | "editor.failure.loadFailed" | "editor.failure.settingsLoadFailed" | "editor.failure.noSettings" | "editor.failure.errorCode" | "editor.props.title" | "editor.props.designTab" | "editor.props.contentTab" | "editor.props.contentCard" | "editor.props.save" | "editor.props.saving" | "editor.props.noConfiguration" | "editor.props.noDesignSchema" | "editor.props.noSchemaData" | "editor.props.noComponents" | "editor.props.noProperties" | "editor.props.addItem" | "editor.props.deleteItem" | "editor.embed.title" | "editor.embed.loading" | "editor.embed.noCode" | "editor.embed.codeHeader" | "editor.embed.headerArea" | "editor.embed.readMore" | "editor.embed.copy" | "editor.embed.copied" | "editor.embed.copiedHint" | "editor.embed.copiedDone" | "editor.embed.copyFailed" | "editor.embed.copyFailedHint" | "editor.preview.title" | "editor.preview.dragHandle" | "editor.preview.desktop" | "editor.preview.mobile" | "editor.preview.widthShort" | "editor.preview.heightShort" | "editor.preview.noUrl" | "editor.preview.copyUrl" | "editor.preview.refresh" | "editor.preview.fitToPanel" | "editor.preview.mobileViewport" | "editor.preview.desktopViewport" | "editor.preview.openInNewTab" | "editor.preview.newTab" | "editor.preview.selectWidget" | "editor.preview.widgetName" | "editor.preview.notPublished" | "editor.preview.publishToPreview" | "editor.preview.frameTitle" | "editor.preview.frameTitleNamed" | "editor.preview.unavailable" | "editor.preview.loadFailedPreview" | "editor.preview.retry" | "editor.preview.retryBuild" | "editor.preview.retryPreview" | "editor.preview.fixErrors" | "editor.preview.viewErrors" | "editor.preview.runtimeError" | "editor.preview.compilationErrors" | "editor.preview.compilationErrorsDetail" | "editor.preview.noCodeYet" | "editor.preview.noPreview" | "editor.preview.building" | "editor.preview.loadingWidget" | "editor.preview.loadingPreview" | "editor.preview.checkingWidget" | "editor.preview.applyingSettings" | "editor.preview.connecting" | "editor.preview.generatingCode" | "editor.list.recentlyUsed" | "editor.list.more" | "editor.list.searchResults" | "editor.list.loadingMore" | "editor.list.deleteItem" | "editor.category.all" | "editor.category.mine" | "editor.category.sansSerif" | "editor.category.serif" | "editor.category.script" | "editor.category.other" | "editor.category.icons" | "editor.category.emojis" | "editor.category.clipart" | "editor.font.select" | "editor.font.title" | "editor.font.search" | "editor.font.list" | "editor.font.loading" | "editor.font.noneFound" | "editor.font.noneAvailable" | "editor.font.remove" | "editor.font.weight" | "editor.font.weightList" | "editor.fontWeight.withItalic" | "editor.fontWeight.italic" | "editor.fontWeight.thin" | "editor.fontWeight.extraLight" | "editor.fontWeight.light" | "editor.fontWeight.regular" | "editor.fontWeight.medium" | "editor.fontWeight.semiBold" | "editor.fontWeight.bold" | "editor.fontWeight.extraBold" | "editor.fontWeight.black" | "editor.vector.select" | "editor.vector.title" | "editor.vector.search" | "editor.vector.list" | "editor.vector.noneFound" | "editor.vector.noneAvailable" | "editor.file.useFile" | "editor.file.useImage" | "editor.file.useVideo" | "editor.file.useAudio" | "editor.file.useDocument" | "editor.file.addFile" | "editor.file.addImage" | "editor.file.addVideo" | "editor.file.addAudio" | "editor.file.addDocument" | "editor.file.play" | "editor.file.pause" | "editor.file.notFound" | "editor.file.emptyFolder" | "editor.file.clear" | "editor.file.pickFailed" | "editor.file.dialogTitle" | "editor.file.closeDialog" | "editor.color.noRecent" | "editor.color.picker" | "editor.date.pick" | "editor.date.pickRange" | "editor.date.invalid" | "editor.date.selectMonth" | "editor.date.selectYear" | "editor.date.calendarLabel" | "editor.date.rangeCalendarLabel" | "editor.date.previousMonth" | "editor.date.nextMonth" | "editor.dateField.dayHint" | "editor.dateField.monthHint" | "editor.dateField.yearHint" | "editor.dateField.dayLabel" | "editor.dateField.monthLabel" | "editor.dateField.yearLabel" | "editor.dropdown.select" | "editor.switch.off" | "editor.switch.on" | "editor.tags.add" | "editor.position.x" | "editor.position.y" | "editor.fixedPosition.set" | "editor.fixedPosition.topLeft" | "editor.fixedPosition.topCenter" | "editor.fixedPosition.topRight" | "editor.fixedPosition.centerLeft" | "editor.fixedPosition.centerCenter" | "editor.fixedPosition.centerRight" | "editor.fixedPosition.bottomLeft" | "editor.fixedPosition.bottomCenter" | "editor.fixedPosition.bottomRight" | "editor.corners.group" | "editor.corners.topLeft" | "editor.corners.topRight" | "editor.corners.bottomLeft" | "editor.corners.bottomRight" | "editor.corners.lock" | "editor.corners.unlock" | "editor.textArea.toolbar" | "editor.textArea.toggleBold" | "editor.textArea.toggleItalic" | "editor.textArea.toggleUnderline" | "editor.textArea.toggleLink" | "editor.textArea.text" | "editor.textArea.paragraph" | "editor.textArea.heading1" | "editor.textArea.heading2" | "editor.textArea.heading3" | "editor.textArea.bulletList" | "editor.textArea.numberedList" | "editor.textArea.checkList" | "editor.textArea.textStyles" | "editor.textArea.listStyles" | "editor.textArea.enterUrl" | "editor.schema.subtitleFont">;

package/dist/pickFileContext.d.ts

@@ -0,0 +1,19 @@
+/** One file the partner's picker returns (same shape as the media library's `MediaLibraryFile`). */
+export interface PartnerPickFile {
+    id: string;
+    name: string;
+    url: string;
+    mimeType?: string;
+    size?: number;
+    thumbnail?: string;
+    hash?: string;
+}
+export interface PartnerPickFileRequest {
+    accept: string[];
+    multiple: boolean;
+    signal: AbortSignal;
+}
+export type PartnerPickFileFn = (request: PartnerPickFileRequest) => Promise<PartnerPickFile[]>;
+export type PickFileGetter = () => PartnerPickFileFn | undefined;
+export declare function provideEditorPickFile(getPickFile: PickFileGetter): void;
+export declare function useEditorPickFile(): PickFileGetter;

package/dist/pickFileContext.js

@@ -0,0 +1,19 @@
+/**
+ * Hands the partner's `pickFile` hook from the editor down to file field controls.
+ *
+ * Same pattern as {@link mediaLibraryContext}: `PropsEditor` receives `pickFile`, and the file controls read it through
+ * context instead of threading a prop through the controller renderer.
+ */
+import { getContext, setContext } from 'svelte';
+const PICK_FILE_CONTEXT_KEY = Symbol.for('widgetic.editor.pickFile');
+export function provideEditorPickFile(getPickFile) {
+    setContext(PICK_FILE_CONTEXT_KEY, getPickFile);
+}
+export function useEditorPickFile() {
+    try {
+        return getContext(PICK_FILE_CONTEXT_KEY) ?? (() => undefined);
+    }
+    catch {
+        return () => undefined;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@widgetic/editor",
-	"version": "4.1.2",
+	"version": "4.1.4",
 	"type": "module",
 	"main": "./dist/index.js",
 	"types": "./dist/index.d.ts",
@@ -38,6 +38,7 @@
 		"render-build": "bash render-build.sh",
 		"build": "npm run sync-embed-schema && NODE_ENV=production NODE_OPTIONS=--max-old-space-size=8192 vite build",
 		"package": "svelte-package",
+		"publish-to-npm": "npm version patch --no-git-tag-version && npm run package && npm publish --ignore-scripts --access public",
 		"package:watch": "svelte-package --watch",
 		"preview": "vite preview",
 		"deploy": "vite build && vite preview --host --port 80",