pptx-svelte-viewer 1.0.0 → 1.2.0

package/dist/i18n/translator.d.ts

@@ -17,6 +17,12 @@ export type Translator = (key: string, params?: Record<string, string | number>)
  * merged over earlier ones, so hosts can override individual keys.
  */
 export declare function registerTranslations(locale: string, dictionary: TranslationDictionary): void;
+/**
+ * List every locale code with a registered dictionary: `en` (built in) plus
+ * anything added via {@link registerTranslations}. Used by File > Options'
+ * Language tab to offer only locales the host has actually wired up.
+ */
+export declare function getRegisteredLocales(): string[];
 /** Interpolate `{{name}}` placeholders (the shared-dictionary convention). */
 export declare function interpolate(message: string, params: Record<string, string | number> | undefined): string;
 /**

package/dist/i18n/translator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAI3F;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAG5F;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,GACjD,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CAOR;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,MAAM,GAAG,UAAU,CAEpE"}
+{"version":3,"file":"translator.d.ts","sourceRoot":"","sources":["../../src/i18n/translator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,oEAAoE;AACpE,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,KAAK,MAAM,CAAC;AAI3F;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,qBAAqB,GAAG,IAAI,CAG5F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAC1B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,SAAS,GACjD,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACxB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,MAAM,CAOR;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,MAAM,GAAG,UAAU,CAEpE"}

package/dist/i18n.d.ts

@@ -22,6 +22,23 @@ type TranslationKey = keyof typeof translationsEn;
  */
 declare function keyToLabel(key: string): string;
 
+/** One selectable entry in the viewer chrome's built-in language picker (File > Options > Language). */
+interface LocaleCatalogEntry {
+    /** BCP-47-ish locale code, e.g. `'en'`, `'fr'`. Matches `pptx-viewer-locales`' exports. */
+    code: string;
+    /** English display name, used before a translation dictionary for the target locale is loaded. */
+    label: string;
+    /** The locale's own name for itself, e.g. `'Français'` for `fr`. */
+    nativeLabel: string;
+}
+/**
+ * Built-in language choices offered by File > Options > Language when a host
+ * doesn't supply its own `availableLocales`. Mirrors the locales shipped by
+ * the optional `pptx-viewer-locales` package (English needs no dictionary,
+ * it's the viewer's own baseline).
+ */
+declare const LOCALE_CATALOG: readonly LocaleCatalogEntry[];
+
 /**
  * Minimal, dependency-free translation layer for the Svelte binding.
  *
@@ -41,6 +58,12 @@ type Translator = (key: string, params?: Record<string, string | number>) => str
  * merged over earlier ones, so hosts can override individual keys.
  */
 declare function registerTranslations(locale: string, dictionary: TranslationDictionary): void;
+/**
+ * List every locale code with a registered dictionary: `en` (built in) plus
+ * anything added via {@link registerTranslations}. Used by File > Options'
+ * Language tab to offer only locales the host has actually wired up.
+ */
+declare function getRegisteredLocales(): string[];
 /** Interpolate `{{name}}` placeholders (the shared-dictionary convention). */
 declare function interpolate(message: string, params: Record<string, string | number> | undefined): string;
 /**
@@ -52,5 +75,5 @@ declare function translate(locale: string, key: string, params?: Record<string,
 /** Build a {@link Translator} bound to a (lazily-read) locale. */
 declare function createTranslator(getLocale: () => string): Translator;
 
-export { createTranslator, interpolate, keyToLabel, registerTranslations, translate, translationsEn };
-export type { TranslationDictionary, TranslationKey, Translator };
+export { LOCALE_CATALOG, createTranslator, getRegisteredLocales, interpolate, keyToLabel, registerTranslations, translate, translationsEn };
+export type { LocaleCatalogEntry, TranslationDictionary, TranslationKey, Translator };

package/dist/i18n.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnG,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACrF,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EACN,gBAAgB,EAChB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,SAAS,GACT,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/i18n.js

@@ -1,9 +1,11 @@
-import { a as r, i as s, n as t, o as e, r as n, t as o } from "./translator-X_R9mNNj.js";
+import { a as s, c as e, i as t, n as r, o, r as n, s as i, t as l } from "./translator-D4a_pxY4.js";
 export {
-  o as createTranslator,
-  t as interpolate,
-  r as keyToLabel,
-  n as registerTranslations,
+  o as LOCALE_CATALOG,
+  l as createTranslator,
+  r as getRegisteredLocales,
+  n as interpolate,
+  i as keyToLabel,
+  t as registerTranslations,
   s as translate,
   e as translationsEn
 };

package/dist/index.d.ts

@@ -6504,6 +6504,16 @@ declare const vermilionLightTheme: ViewerTheme;
 /** Dark vermilion theme, ready for the viewer's `theme` prop. */
 declare const vermilionDarkTheme: ViewerTheme;
 
+/** One selectable entry in the viewer chrome's built-in theme picker (File > Options > Appearance). */
+interface ThemeCatalogEntry {
+    /** Stable identifier persisted to storage and passed to `onThemeChange`. */
+    key: string;
+    /** `pptx.*` translation key for the entry's display label. */
+    labelKey: string;
+    /** The theme to apply, or `undefined` to reset to the built-in default. */
+    theme: ViewerTheme | undefined;
+}
+
 /**
  * Framework-agnostic public types shared by the viewer bindings.
  *
@@ -6719,6 +6729,21 @@ declare function listAutosaveSnapshots(): Promise<Array<{
  * Delete an autosave snapshot by file path.
  */
 declare function deleteAutosaveSnapshot(filePath: string): Promise<boolean>;
+/**
+ * Optional hook point for hosts that want to wire a real sign-in flow into
+ * File > Account. Disabled by default: the Account page renders nothing
+ * extra unless a host explicitly opts in by passing `enabled: true`.
+ * See docs/guide for wiring instructions.
+ */
+interface AccountAuthConfig {
+    enabled: boolean;
+    onSignIn: () => void;
+    signedInUser?: {
+        name: string;
+        email?: string;
+        avatarUrl?: string;
+    };
+}
 
 /**
  * Toolbar action / ribbon-tab visibility: a single, framework-agnostic
@@ -6789,6 +6814,16 @@ interface PrintSettings {
     customRangeTo: number;
 }
 
+/** One selectable entry in the viewer chrome's built-in language picker (File > Options > Language). */
+interface LocaleCatalogEntry {
+    /** BCP-47-ish locale code, e.g. `'en'`, `'fr'`. Matches `pptx-viewer-locales`' exports. */
+    code: string;
+    /** English display name, used before a translation dictionary for the target locale is loaded. */
+    label: string;
+    /** The locale's own name for itself, e.g. `'Français'` for `fr`. */
+    nativeLabel: string;
+}
+
 /**
  * Animated-GIF export capture/encode pipeline. All the pure logic is shared:
  * `planGifFrames` derives the per-slide frame delays (default duration +
@@ -6934,6 +6969,49 @@ interface PowerPointViewerProps {
     theme?: ViewerTheme;
     /** UI locale (BCP 47). English ships built in; register others via `pptx-svelte-viewer/i18n`. */
     locale?: string;
+    /**
+     * Initial File > Options > Appearance selection: a key into `availableThemes`
+     * (or the built-in `THEME_CATALOG` when unset). Falls back to a value
+     * persisted in `localStorage` (see `pptx-viewer-shared`'s
+     * `readStoredViewerPrefs`), then `'default'`. Once the user picks a theme
+     * from the Design tab or Options, that choice (`themeKey`) is the single
+     * source of truth for `effectiveTheme` for the rest of the session; the
+     * `theme` prop above still wins whenever the resolved key is `'default'`
+     * (its entry maps to `undefined`), preserving prior host-prop precedence.
+     */
+    defaultThemeKey?: string;
+    /** Theme choices offered by File > Options > Appearance. Defaults to the built-in `THEME_CATALOG`. */
+    availableThemes?: readonly ThemeCatalogEntry[];
+    /**
+     * Fired when the user picks a theme (Design tab or File > Options >
+     * Appearance) with the selected catalog key. Supplying this hands
+     * persistence to the host; without it, the choice is written to
+     * `localStorage` automatically.
+     */
+    onThemeChange?: (themeKey: string) => void;
+    /**
+     * Initial File > Options > Language selection (locale code). Falls back to
+     * a value persisted in `localStorage`, then the `locale` prop. Once the
+     * user picks a language from Options, that choice always wins over `locale`
+     * for the rest of the session: unlike `theme`, there is no "host forces
+     * this language no matter what" case in this binding.
+     */
+    defaultLocale?: string;
+    /** Language choices offered by File > Options > Language. Defaults to every locale registered via `pptx-svelte-viewer/i18n`'s `registerTranslations`, labelled from the shared `LOCALE_CATALOG`. */
+    availableLocales?: readonly LocaleCatalogEntry[];
+    /**
+     * Fired when the user picks a language from File > Options > Language with
+     * the selected locale code. Supplying this hands persistence to the host;
+     * without it, the choice is written to `localStorage` automatically. Note
+     * this only switches which registered dictionary is read; registering the
+     * dictionary itself is a separate step (`registerTranslations`).
+     */
+    onLocaleChange?: (locale: string) => void;
+    /**
+     * Optional hook point for a real sign-in flow in File > Account. Disabled
+     * by default (renders nothing extra) unless `enabled: true`.
+     */
+    accountAuth?: AccountAuthConfig;
     /** Slide shown after load (0-based, clamped). Default 0. */
     initialSlide?: number;
     /** Show the thumbnail sidebar. Default true. */

package/dist/index.js

@@ -1,12 +1,12 @@
-import { C as e, D as a, E as o, S as r, T as t, _ as i, b as l, d as n, f as m, g as S, h as d, l as p, m as v, p as g, t as h, u as T, v as u, w as x, x as f, y as A } from "./export-tBg928r6.js";
-import { r as D } from "./translator-X_R9mNNj.js";
+import { C as e, D as a, E as o, S as t, T as i, _ as r, b as l, d as n, f as m, g as S, h as d, l as p, m as v, p as g, t as h, u as T, v as u, w as x, x as f, y as A } from "./export-CalS6VEm.js";
+import { i as D } from "./translator-D4a_pxY4.js";
 import "./i18n.js";
 export {
   h as PowerPointViewer,
   v as defaultCssVars,
   d as defaultRadius,
   S as defaultThemeColors,
-  i as deleteAutosaveSnapshot,
+  r as deleteAutosaveSnapshot,
   p as exportAllSlidesToSvg,
   T as exportAllSlidesToSvgBlobs,
   n as exportSlideAsSvg,
@@ -17,10 +17,10 @@ export {
   l as loadPresentationDeck,
   f as parsePresentationSessionId,
   D as registerTranslations,
-  r as themeToCssVars,
+  t as themeToCssVars,
   e as vermilionDarkColors,
   x as vermilionDarkTheme,
-  t as vermilionLightColors,
+  i as vermilionLightColors,
   o as vermilionLightTheme,
   a as vermilionRadius
 };