@seliseblocks/mailcraft 0.2.0 → 0.2.2

package/DOCS.md

@@ -84,11 +84,11 @@ You write those functions next to the auth and base URL you already own, and poi
 
 The same applies to AI (`.aiProvider` is one `async (prompt) => text` function) and to social icons (`.iconProvider`).
 
-### 3. Upload policy belongs to the host
+### 3. Upload policy belongs to the host — formats excepted
 
-The package ships **no default limits**. What an email may carry depends on the sending platform's caps, the audience's mail clients, and the host's own product rules — none of which this package can know.
+Sizes and counts ship undefaulted: what an email may carry depends on the sending platform's caps and the host's own product rules — none of which this package can know. With a provider wired and no `maxBytes` declared, uploads are refused rather than waved through.
 
-With a provider wired and no limits declared, uploads are refused rather than waved through. Silently accepting anything is the exact failure the limits exist to prevent.
+Formats are the one default: **every image type is allowed** — JPEG, PNG, GIF, WebP, BMP, TIFF, ICO, AVIF, HEIC — unless `accept` lists a narrower set. SVG keeps its own gate below.
 
 Two supporting details:
 
@@ -269,12 +269,12 @@ A start marker's expression field suggests the host's `variables` in a dropdown
 
 ## Image uploads
 
-Both properties are required. The package ships no files of its own: with no provider the library opens empty and holds only what is dropped into it — data URIs, kept in the local draft, which no email client renders. With a provider but no limits every upload is refused.
+A provider and a `maxBytes` ceiling are both required. The package ships no files of its own: with no provider the library opens empty and holds only what is dropped into it — data URIs, kept in the local draft, which no email client renders. With a provider but no `maxBytes` every upload is refused.
 
 ```js
 editor.storageLimits = {
-  accept: ['image/jpeg', 'image/png', 'image/gif'],
   maxBytes: 2 * 1024 * 1024,
+  accept: ['image/jpeg', 'image/png', 'image/gif'],  // optional: omit to allow every image type
   maxWidth: 1600, maxHeight: 1600,   // optional
   maxFilesPerDrop: 20,               // optional
   allowSvg: false,                   // SVG needs this AND a place in `accept`
@@ -316,7 +316,7 @@ A provider may also carry its own `limits` object, for a backend that knows its
 editor.storageProvider = { list, upload, limits: { accept: [...], maxBytes: 5e6 } };
 ```
 
-The two are merged **per key**, with `editor.storageLimits` winning — so a provider can ship sane defaults and the host can still tighten one number without restating the rest. Either source satisfies the "limits are required" rule; only a file that passes the merged result reaches `upload`.
+The two are merged **per key**, with `editor.storageLimits` winning — so a provider can ship sane defaults and the host can still tighten one number without restating the rest. Either source satisfies the "`maxBytes` is required" rule; only a file that passes the merged result reaches `upload`.
 
 Setting `editor.storageProvider = null` drops back to that empty local library.
 
@@ -419,6 +419,8 @@ Hiding the strip collapses its row — the canvas keeps every pixel it had.
 
 31 locales ship. `dir` follows the locale automatically (`locale="ar"` gives RTL) and can be overridden. While `theme` is set the host owns light/dark and the editor hides its own toggle.
 
+Tables load lazily: in a bundled app each locale is its own code-split chunk, fetched the first time its tag is used, so you ship only the languages you render (English is always built in). The chrome shows English for the instant the chunk takes to arrive; call `loadLocale(tag)` ahead of time to have it ready before you flip the attribute. The single-file CDN bundle carries every table, so switching there is always instant.
+
 Override any individual string:
 
 ```js
@@ -509,7 +511,7 @@ template, not to your app.
 | `.accent` | string |
 | `.messages` | `{ key: string }` |
 | `.storageProvider` | `{ list, upload, folders?, remove?, limits? }` — `null` drops back to the empty local library |
-| `.storageLimits` | `{ accept, maxBytes, maxWidth?, maxHeight?, maxFilesPerDrop?, allowSvg? }`, merged over `provider.limits` per key |
+| `.storageLimits` | `{ accept?, maxBytes, maxWidth?, maxHeight?, maxFilesPerDrop?, allowSvg? }`, merged over `provider.limits` per key |
 | `.aiProvider` | `async (prompt) => text` |
 | `.iconProvider` | `(platformKey, { label, size, color }) => Node` — social-icon override; falls back to the built-in icon when it is unset, throws, or returns a non-node |
 
@@ -521,6 +523,7 @@ template, not to your app.
 | `isReady()` | whether the custom element is registered |
 | `MailCraftEditor` | the element class |
 | `LOCALES`, `LOCALE_TABLES`, `createTranslator` | i18n: the shipped tags, their tables, and the translator the editor uses |
+| `LOCALE_LOADERS`, `loadLocale(tag)` | lazy per-locale table loading — what the `locale` attribute resolves through, so a bundled app ships only the locales it uses. `loadLocale` prefetches one (e.g. before flipping `locale` at runtime) |
 | `defineMessages(base, overrides)` | merge a shipped locale with your own overrides — the supported way to build a `.messages` value |
 | `missingKeys(locale, base)` | keys `base` has that `locale` does not translate. What a translator has left to do |
 | `EN`, `MESSAGE_KEYS` | the English table and every key in it — listed in [Every message key](#every-message-key) |
@@ -686,7 +689,6 @@ The complete catalog of UI strings that `.messages` accepts — every key the ed
 | `storage.errDimensions` | {name} is {w}×{ht}px — the limit is {maxW}×{maxH}px. |
 | `storage.errFormat` | {name} is a {type} file, which is not allowed here. |
 | `storage.errLoadFailed` | The file library could not be loaded — {reason} |
-| `storage.errNoAccept` | Uploads are switched off: no file formats have been allowed. |
 | `storage.errNoLimits` | Uploads are switched off: this app has not set any upload limits. |
 | `storage.errNoMaxBytes` | Uploads are switched off: no maximum file size has been set. |
 | `storage.errSvg` | {name} is an SVG, which this app does not accept. |

package/README.md

@@ -102,9 +102,10 @@ KEYS      Bound on window, so they survive toolbar="none":
           Ctrl/Cmd+E (export dialog), Ctrl/Cmd+K (link, while editing),
           Ctrl/Cmd+D (duplicate), Backspace|Delete (delete selection).
 
-UPLOADS   Limits and a provider are both required, or every upload is refused.
-          editor.storageLimits   = { accept:['image/jpeg','image/png','image/gif'],
-                                     maxBytes: 2*1024*1024 }
+UPLOADS   A provider plus `maxBytes` are required, or every upload is refused;
+          every image type is allowed unless `accept` narrows it.
+          editor.storageLimits   = { maxBytes: 2*1024*1024,
+                                     accept:['image/jpeg','image/png'] }  // accept optional
           editor.storageProvider = { list(q), upload(file, o), folders?(), remove?(a),
                                      limits? }
           provider.limits is merged per key under .storageLimits, and satisfies

package/README.md.txt

@@ -102,9 +102,10 @@ KEYS      Bound on window, so they survive toolbar="none":
           Ctrl/Cmd+E (export dialog), Ctrl/Cmd+K (link, while editing),
           Ctrl/Cmd+D (duplicate), Backspace|Delete (delete selection).
 
-UPLOADS   Limits and a provider are both required, or every upload is refused.
-          editor.storageLimits   = { accept:['image/jpeg','image/png','image/gif'],
-                                     maxBytes: 2*1024*1024 }
+UPLOADS   A provider plus `maxBytes` are required, or every upload is refused;
+          every image type is allowed unless `accept` narrows it.
+          editor.storageLimits   = { maxBytes: 2*1024*1024,
+                                     accept:['image/jpeg','image/png'] }  // accept optional
           editor.storageProvider = { list(q), upload(file, o), folders?(), remove?(a),
                                      limits? }
           provider.limits is merged per key under .storageLimits, and satisfies