@ezeep/ezeep-js 1.0.294 → 1.0.302

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/dist/cjs/ezeep.cjs.js +1 -1
  2. package/dist/cjs/{ezp-auth_15.cjs.entry.js → ezp-auth_16.cjs.entry.js} +510 -109
  3. package/dist/cjs/loader.cjs.js +1 -1
  4. package/dist/collection/collection-manifest.json +1 -0
  5. package/dist/collection/components/ezp-file-name/ezp-file-name.css +98 -0
  6. package/dist/collection/components/ezp-file-name/ezp-file-name.js +280 -0
  7. package/dist/collection/components/ezp-icon/ezp-icon.js +1 -1
  8. package/dist/collection/components/ezp-icon-button/ezp-icon-button.js +1 -1
  9. package/dist/collection/components/ezp-input/ezp-input.js +1 -1
  10. package/dist/collection/components/ezp-label/ezp-label.js +39 -1
  11. package/dist/collection/components/ezp-printer-selection/ezp-printer-selection.css +4 -2
  12. package/dist/collection/components/ezp-printer-selection/ezp-printer-selection.js +216 -88
  13. package/dist/collection/components/ezp-printing/ezp-printing.js +1 -1
  14. package/dist/collection/components/ezp-select/ezp-select.js +1 -1
  15. package/dist/collection/components/ezp-status/ezp-status.js +2 -2
  16. package/dist/collection/components/ezp-stepper/ezp-stepper.js +1 -1
  17. package/dist/collection/components/ezp-text-button/ezp-text-button.js +1 -1
  18. package/dist/collection/components/ezp-upload/ezp-upload.css +5 -1
  19. package/dist/collection/components/ezp-upload/ezp-upload.js +1 -1
  20. package/dist/collection/components/ezp-user-menu/ezp-user-menu.js +1 -1
  21. package/dist/collection/shared/storage.js +39 -9
  22. package/dist/collection/types/shared/types.d.ts +1 -0
  23. package/dist/collection/utils/printer.js +75 -1
  24. package/dist/components/auth.js +1 -1
  25. package/dist/components/ezp-file-name.d.ts +11 -0
  26. package/dist/components/ezp-file-name.js +1 -0
  27. package/dist/components/ezp-file-name2.js +1 -0
  28. package/dist/components/ezp-icon-button2.js +1 -1
  29. package/dist/components/ezp-icon2.js +1 -1
  30. package/dist/components/ezp-input2.js +1 -1
  31. package/dist/components/ezp-label2.js +1 -1
  32. package/dist/components/ezp-printer-selection2.js +1 -1
  33. package/dist/components/ezp-printing.js +1 -1
  34. package/dist/components/ezp-select2.js +1 -1
  35. package/dist/components/ezp-status2.js +1 -1
  36. package/dist/components/ezp-stepper2.js +1 -1
  37. package/dist/components/ezp-text-button2.js +1 -1
  38. package/dist/components/ezp-upload2.js +1 -1
  39. package/dist/components/ezp-user-menu2.js +1 -1
  40. package/dist/components/utils.js +1 -1
  41. package/dist/directives/proxies.ts +26 -1
  42. package/dist/esm/ezeep.js +1 -1
  43. package/dist/esm/{ezp-auth_15.entry.js → ezp-auth_16.entry.js} +510 -110
  44. package/dist/esm/loader.js +1 -1
  45. package/dist/esm-es5/ezeep.js +1 -1
  46. package/dist/esm-es5/{ezp-auth_15.entry.js → ezp-auth_16.entry.js} +2 -2
  47. package/dist/esm-es5/loader.js +1 -1
  48. package/dist/ezeep/ezeep.esm.js +1 -1
  49. package/dist/ezeep/{p-fe700ca4.system.entry.js → p-636e190f.system.entry.js} +2 -2
  50. package/dist/ezeep/p-DCznw2Ee.system.js +1 -1
  51. package/dist/ezeep/p-ff075048.entry.js +1 -0
  52. package/dist/ezeep/types/shared/types.d.ts +1 -0
  53. package/dist/types/components/ezp-file-name/ezp-file-name.d.ts +83 -0
  54. package/dist/types/components/ezp-label/ezp-label.d.ts +10 -0
  55. package/dist/types/components/ezp-printer-selection/ezp-printer-selection.d.ts +40 -2
  56. package/dist/types/components.d.ts +65 -2
  57. package/dist/types/shared/storage.d.ts +18 -4
  58. package/dist/types/shared/types.d.ts +1 -0
  59. package/dist/types/utils/printer.d.ts +18 -0
  60. package/package.json +1 -1
  61. package/www/build/ezeep.esm.js +1 -1
  62. package/www/build/{p-fe700ca4.system.entry.js → p-636e190f.system.entry.js} +2 -2
  63. package/www/build/p-DCznw2Ee.system.js +1 -1
  64. package/www/build/p-a2a4f55b.js +1 -0
  65. package/www/build/p-ff075048.entry.js +1 -0
  66. package/www/index.html +1 -1
  67. package/dist/ezeep/p-3ab5a223.entry.js +0 -1
  68. package/www/build/p-3ab5a223.entry.js +0 -1
  69. package/www/build/p-65242d5e.js +0 -1
@@ -52,6 +52,7 @@ export type TextButtonLevelTypes = 'primary' | 'secondary' | 'tertiary'
52
52
  export type TextButtonTypeTypes = 'button'
53
53
  export type LabelLevelTypes = 'primary' | 'secondary' | 'tertiary'
54
54
  export type WeightTypes = 'soft' | 'strong' | 'heavy'
55
+ export type TooltipPlacementTypes = 'top' | 'bottom'
55
56
  export type ThemeTypes = 'pink' | 'red' | 'orange' | 'green' | 'teal' | 'cyan' | 'blue' | 'violet'
56
57
  export type AppearanceTypes = 'system' | 'light' | 'dark'
57
58
  export type TriggerTypes = 'custom' | 'file' | 'button'
@@ -0,0 +1,83 @@
1
+ import { LabelLevelTypes, TooltipPlacementTypes, WeightTypes } from '../../shared/types';
2
+ export declare class EzpFileName {
3
+ host: HTMLEzpFileNameElement;
4
+ private openTimeout?;
5
+ private closeTimeout?;
6
+ /** Invalidates an in-flight open when the pointer leaves. */
7
+ private openGeneration;
8
+ /**
9
+ *
10
+ * Properties
11
+ *
12
+ */
13
+ /** The full file name. Always present in the DOM, so screen readers and
14
+ * copy-paste get it in full however it is truncated on screen. */
15
+ name: string;
16
+ /** Type scale of the rendered name, passed through to `ezp-label`. */
17
+ level: LabelLevelTypes;
18
+ /** Font weight of the rendered name, passed through to `ezp-label`. */
19
+ weight: WeightTypes;
20
+ /** Side the tooltip opens on. Consumers point it away from the edge their
21
+ * row sits against — `bottom` for the first row of a list, `top` below it. */
22
+ placement: TooltipPlacementTypes;
23
+ /**
24
+ *
25
+ * States
26
+ *
27
+ */
28
+ /** Set by tapping the name: shows it in full, wrapped over several lines.
29
+ * This is the touch counterpart of the tooltip, which needs a pointer. */
30
+ expanded: boolean;
31
+ tooltipOpen: boolean;
32
+ /**
33
+ *
34
+ * Lifecycle methods
35
+ *
36
+ */
37
+ disconnectedCallback(): void;
38
+ /**
39
+ *
40
+ * Listeners
41
+ *
42
+ */
43
+ /**
44
+ * Escape dismisses the tooltip, and only the tooltip.
45
+ *
46
+ * Listening globally catches the key however the tooltip was opened,
47
+ * including by hover, when nothing here has focus. It has to run in the
48
+ * capture phase: stopping propagation on the way back up happens after every
49
+ * ancestor has already seen the key, so a host app that closes its dialog on
50
+ * Escape would close it as the tooltip was dismissed.
51
+ *
52
+ * `window` rather than `document`, because dialog libraries capture on the
53
+ * document themselves — Radix's `DismissableLayer` does — and register before
54
+ * a component mounted inside them, so they would still see the key first.
55
+ * Capture runs window before document, so this transient layer consumes the
56
+ * key first, and only while it is actually open.
57
+ */
58
+ handleKeyDown(event: KeyboardEvent): void;
59
+ /**
60
+ *
61
+ * Private methods
62
+ *
63
+ */
64
+ /** Tooltips need a pointer; touch devices get the tap-to-expand path instead.
65
+ * Tapping fires a synthetic `mouseenter` in most mobile browsers, so without
66
+ * this check a tooltip would open on every tap. */
67
+ private get hasHover();
68
+ /** Whether anything is actually hidden. A name that fits needs no tooltip —
69
+ * repeating text the reader can already see is just noise in the way. */
70
+ private isClipped;
71
+ private openTooltip;
72
+ private closeTooltip;
73
+ /** Leaves the tooltip up briefly so the pointer can reach it. */
74
+ private scheduleClose;
75
+ private cancelScheduledClose;
76
+ private toggleExpanded;
77
+ /**
78
+ *
79
+ * Render method
80
+ *
81
+ */
82
+ render(): any;
83
+ }
@@ -1,5 +1,15 @@
1
1
  import { LabelLevelTypes, WeightTypes } from '../../shared/types';
2
2
  export declare class EzpLabel {
3
+ host: HTMLEzpLabelElement;
4
+ /**
5
+ *
6
+ * Public methods
7
+ *
8
+ */
9
+ /** Whether the text is currently clipped — `ellipsis` only bites when the
10
+ * text outgrows the space it was given, which callers cannot tell from the
11
+ * props alone. Lets a caller offer the full text only when it is needed. */
12
+ isTruncated(): Promise<boolean>;
3
13
  /**
4
14
  *
5
15
  * Properties
@@ -47,11 +47,15 @@ export declare class EzpPrinterSelection {
47
47
  userMenuOpen: boolean;
48
48
  printStopped: boolean;
49
49
  userName: string;
50
+ /** Starts empty so the dialog can still render if the list never arrives. */
50
51
  printers: Printer[];
52
+ /** Starts empty so the dialog renders even if the list never loads. */
51
53
  selectedPrinter: Printer;
52
54
  printerConfig: PrinterConfig[];
53
55
  selectedPrinterConfig: PrinterConfig;
54
56
  selectedProperties: PrinterProperties;
57
+ /** True while a printer's capabilities are being fetched. */
58
+ loadingPrinterConfig: boolean;
55
59
  paperid: number | string | undefined;
56
60
  currentFileIndex: number;
57
61
  totalFiles: number;
@@ -90,18 +94,43 @@ export declare class EzpPrinterSelection {
90
94
  private handleCancel;
91
95
  /** Poll `validate` callback: maps a job status to component state, returns `true` to stop polling. */
92
96
  private validateData;
93
- /** Print needs a printer, no job in flight and a valid page range. */
97
+ /** Print needs a printer with its capabilities in hand, no job in flight and
98
+ * a valid page range. The config matters: between picking a printer and its
99
+ * properties arriving, the selection is set but the properties still hold
100
+ * blank defaults, and printing then saves those as that printer's settings. */
94
101
  private get printDisabled();
95
102
  /** Description... */
96
103
  private handlePrint;
104
+ /** Keep this printer and its settings for the next print. Stored per printer,
105
+ * so each one keeps its own and no setting follows the user to a printer
106
+ * that cannot do it. */
107
+ private rememberSelection;
97
108
  private handleUserMenu;
98
- private getPropertiesFromLocalStorage;
109
+ /**
110
+ * Decide which printer the dialog opens on: the one last printed to, or the
111
+ * user's only printer when there is nothing to choose between. Its settings
112
+ * follow once its config is in, since they can only be validated against the
113
+ * printer's capabilities.
114
+ */
115
+ private selectInitialPrinter;
99
116
  private setPaperid;
100
117
  private getUserInfo;
101
118
  private setSelectedProperties;
102
119
  /** Upload + print a single file, reflecting progress into component state. */
103
120
  private processSingleFile;
104
121
  private validateFileType;
122
+ /**
123
+ * What a dropdown should show: the current selection — restored from the last
124
+ * print, or just made by the user — and otherwise the printer's own default.
125
+ *
126
+ * The fallbacks matter because a config may describe its default only by name
127
+ * (`Default.Duplex`, `Default.Paper`, `Default.Tray`) without flagging the
128
+ * matching entry, which is all these dropdowns had to go on before settings
129
+ * were remembered.
130
+ */
131
+ private duplexPreSelection;
132
+ private paperPreSelection;
133
+ private trayPreSelection;
105
134
  setDefaultPaperFormat(): void;
106
135
  private processMultipleFiles;
107
136
  /**
@@ -111,6 +140,15 @@ export declare class EzpPrinterSelection {
111
140
  */
112
141
  /** Description... */
113
142
  connectedCallback(): Promise<void>;
143
+ /**
144
+ * Fetch the selected printer's capabilities and restore its saved settings.
145
+ *
146
+ * A failure drops the selection rather than keeping a printer the dialog
147
+ * cannot describe: the options would stay disabled while Print stayed
148
+ * enabled, so the job would go out with properties nothing has verified.
149
+ * With no selection the user picks from the list, which fetches again.
150
+ */
151
+ private loadSelectedPrinterConfig;
114
152
  disconnectedCallback(): void;
115
153
  /**
116
154
  *
@@ -5,8 +5,8 @@
5
5
  * It contains typing information for all components that exist in this project.
6
6
  */
7
7
  import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
8
- import { AppearanceTypes, IconButtonLevelTypes, IconButtonTypeTypes, IconNameTypes, IconSizeTypes, LabelLevelTypes, SelectFlowTypes, SelectOptionType, TextButtonLevelTypes, TextButtonTypeTypes, ThemeTypes, TriggerTypes, WeightTypes } from "./shared/types";
9
- export { AppearanceTypes, IconButtonLevelTypes, IconButtonTypeTypes, IconNameTypes, IconSizeTypes, LabelLevelTypes, SelectFlowTypes, SelectOptionType, TextButtonLevelTypes, TextButtonTypeTypes, ThemeTypes, TriggerTypes, WeightTypes } from "./shared/types";
8
+ import { AppearanceTypes, IconButtonLevelTypes, IconButtonTypeTypes, IconNameTypes, IconSizeTypes, LabelLevelTypes, SelectFlowTypes, SelectOptionType, TextButtonLevelTypes, TextButtonTypeTypes, ThemeTypes, TooltipPlacementTypes, TriggerTypes, WeightTypes } from "./shared/types";
9
+ export { AppearanceTypes, IconButtonLevelTypes, IconButtonTypeTypes, IconNameTypes, IconSizeTypes, LabelLevelTypes, SelectFlowTypes, SelectOptionType, TextButtonLevelTypes, TextButtonTypeTypes, ThemeTypes, TooltipPlacementTypes, TriggerTypes, WeightTypes } from "./shared/types";
10
10
  export namespace Components {
11
11
  interface EzpAuth {
12
12
  "clientID": string;
@@ -42,6 +42,28 @@ export namespace Components {
42
42
  "iconSize": IconSizeTypes;
43
43
  "instance": string;
44
44
  }
45
+ interface EzpFileName {
46
+ /**
47
+ * Type scale of the rendered name, passed through to `ezp-label`.
48
+ * @default 'secondary'
49
+ */
50
+ "level": LabelLevelTypes;
51
+ /**
52
+ * The full file name. Always present in the DOM, so screen readers and copy-paste get it in full however it is truncated on screen.
53
+ * @default ''
54
+ */
55
+ "name": string;
56
+ /**
57
+ * Side the tooltip opens on. Consumers point it away from the edge their row sits against — `bottom` for the first row of a list, `top` below it.
58
+ * @default 'top'
59
+ */
60
+ "placement": TooltipPlacementTypes;
61
+ /**
62
+ * Font weight of the rendered name, passed through to `ezp-label`.
63
+ * @default 'soft'
64
+ */
65
+ "weight": WeightTypes;
66
+ }
45
67
  interface EzpIcon {
46
68
  /**
47
69
  * Description...
@@ -126,6 +148,10 @@ export namespace Components {
126
148
  * @default false
127
149
  */
128
150
  "ellipsis": boolean;
151
+ /**
152
+ * Whether the text is currently clipped — `ellipsis` only bites when the text outgrows the space it was given, which callers cannot tell from the props alone. Lets a caller offer the full text only when it is needed.
153
+ */
154
+ "isTruncated": () => Promise<boolean>;
129
155
  /**
130
156
  * Description...
131
157
  * @default 'secondary'
@@ -441,6 +467,12 @@ declare global {
441
467
  prototype: HTMLEzpDialogElement;
442
468
  new (): HTMLEzpDialogElement;
443
469
  };
470
+ interface HTMLEzpFileNameElement extends Components.EzpFileName, HTMLStencilElement {
471
+ }
472
+ var HTMLEzpFileNameElement: {
473
+ prototype: HTMLEzpFileNameElement;
474
+ new (): HTMLEzpFileNameElement;
475
+ };
444
476
  interface HTMLEzpIconElement extends Components.EzpIcon, HTMLStencilElement {
445
477
  }
446
478
  var HTMLEzpIconElement: {
@@ -613,6 +645,7 @@ declare global {
613
645
  "ezp-auth": HTMLEzpAuthElement;
614
646
  "ezp-backdrop": HTMLEzpBackdropElement;
615
647
  "ezp-dialog": HTMLEzpDialogElement;
648
+ "ezp-file-name": HTMLEzpFileNameElement;
616
649
  "ezp-icon": HTMLEzpIconElement;
617
650
  "ezp-icon-button": HTMLEzpIconButtonElement;
618
651
  "ezp-input": HTMLEzpInputElement;
@@ -674,6 +707,28 @@ declare namespace LocalJSX {
674
707
  */
675
708
  "onDialogClose"?: (event: EzpDialogCustomEvent<string>) => void;
676
709
  }
710
+ interface EzpFileName {
711
+ /**
712
+ * Type scale of the rendered name, passed through to `ezp-label`.
713
+ * @default 'secondary'
714
+ */
715
+ "level"?: LabelLevelTypes;
716
+ /**
717
+ * The full file name. Always present in the DOM, so screen readers and copy-paste get it in full however it is truncated on screen.
718
+ * @default ''
719
+ */
720
+ "name"?: string;
721
+ /**
722
+ * Side the tooltip opens on. Consumers point it away from the edge their row sits against — `bottom` for the first row of a list, `top` below it.
723
+ * @default 'top'
724
+ */
725
+ "placement"?: TooltipPlacementTypes;
726
+ /**
727
+ * Font weight of the rendered name, passed through to `ezp-label`.
728
+ * @default 'soft'
729
+ */
730
+ "weight"?: WeightTypes;
731
+ }
677
732
  interface EzpIcon {
678
733
  /**
679
734
  * Description...
@@ -1032,6 +1087,12 @@ declare namespace LocalJSX {
1032
1087
  "iconFramed": boolean;
1033
1088
  "instance": string;
1034
1089
  }
1090
+ interface EzpFileNameAttributes {
1091
+ "name": string;
1092
+ "level": LabelLevelTypes;
1093
+ "weight": WeightTypes;
1094
+ "placement": TooltipPlacementTypes;
1095
+ }
1035
1096
  interface EzpIconAttributes {
1036
1097
  "name": IconNameTypes;
1037
1098
  "size": IconSizeTypes;
@@ -1136,6 +1197,7 @@ declare namespace LocalJSX {
1136
1197
  "ezp-auth": Omit<EzpAuth, keyof EzpAuthAttributes> & { [K in keyof EzpAuth & keyof EzpAuthAttributes]?: EzpAuth[K] } & { [K in keyof EzpAuth & keyof EzpAuthAttributes as `attr:${K}`]?: EzpAuthAttributes[K] } & { [K in keyof EzpAuth & keyof EzpAuthAttributes as `prop:${K}`]?: EzpAuth[K] };
1137
1198
  "ezp-backdrop": Omit<EzpBackdrop, keyof EzpBackdropAttributes> & { [K in keyof EzpBackdrop & keyof EzpBackdropAttributes]?: EzpBackdrop[K] } & { [K in keyof EzpBackdrop & keyof EzpBackdropAttributes as `attr:${K}`]?: EzpBackdropAttributes[K] } & { [K in keyof EzpBackdrop & keyof EzpBackdropAttributes as `prop:${K}`]?: EzpBackdrop[K] };
1138
1199
  "ezp-dialog": Omit<EzpDialog, keyof EzpDialogAttributes> & { [K in keyof EzpDialog & keyof EzpDialogAttributes]?: EzpDialog[K] } & { [K in keyof EzpDialog & keyof EzpDialogAttributes as `attr:${K}`]?: EzpDialogAttributes[K] } & { [K in keyof EzpDialog & keyof EzpDialogAttributes as `prop:${K}`]?: EzpDialog[K] };
1200
+ "ezp-file-name": Omit<EzpFileName, keyof EzpFileNameAttributes> & { [K in keyof EzpFileName & keyof EzpFileNameAttributes]?: EzpFileName[K] } & { [K in keyof EzpFileName & keyof EzpFileNameAttributes as `attr:${K}`]?: EzpFileNameAttributes[K] } & { [K in keyof EzpFileName & keyof EzpFileNameAttributes as `prop:${K}`]?: EzpFileName[K] };
1139
1201
  "ezp-icon": Omit<EzpIcon, keyof EzpIconAttributes> & { [K in keyof EzpIcon & keyof EzpIconAttributes]?: EzpIcon[K] } & { [K in keyof EzpIcon & keyof EzpIconAttributes as `attr:${K}`]?: EzpIconAttributes[K] } & { [K in keyof EzpIcon & keyof EzpIconAttributes as `prop:${K}`]?: EzpIcon[K] } & OneOf<"name", EzpIcon["name"], EzpIconAttributes["name"]>;
1140
1202
  "ezp-icon-button": Omit<EzpIconButton, keyof EzpIconButtonAttributes> & { [K in keyof EzpIconButton & keyof EzpIconButtonAttributes]?: EzpIconButton[K] } & { [K in keyof EzpIconButton & keyof EzpIconButtonAttributes as `attr:${K}`]?: EzpIconButtonAttributes[K] } & { [K in keyof EzpIconButton & keyof EzpIconButtonAttributes as `prop:${K}`]?: EzpIconButton[K] } & OneOf<"icon", EzpIconButton["icon"], EzpIconButtonAttributes["icon"]>;
1141
1203
  "ezp-input": Omit<EzpInput, keyof EzpInputAttributes> & { [K in keyof EzpInput & keyof EzpInputAttributes]?: EzpInput[K] } & { [K in keyof EzpInput & keyof EzpInputAttributes as `attr:${K}`]?: EzpInputAttributes[K] } & { [K in keyof EzpInput & keyof EzpInputAttributes as `prop:${K}`]?: EzpInput[K] };
@@ -1157,6 +1219,7 @@ declare module "@stencil/core" {
1157
1219
  "ezp-auth": LocalJSX.IntrinsicElements["ezp-auth"] & JSXBase.HTMLAttributes<HTMLEzpAuthElement>;
1158
1220
  "ezp-backdrop": LocalJSX.IntrinsicElements["ezp-backdrop"] & JSXBase.HTMLAttributes<HTMLEzpBackdropElement>;
1159
1221
  "ezp-dialog": LocalJSX.IntrinsicElements["ezp-dialog"] & JSXBase.HTMLAttributes<HTMLEzpDialogElement>;
1222
+ "ezp-file-name": LocalJSX.IntrinsicElements["ezp-file-name"] & JSXBase.HTMLAttributes<HTMLEzpFileNameElement>;
1160
1223
  "ezp-icon": LocalJSX.IntrinsicElements["ezp-icon"] & JSXBase.HTMLAttributes<HTMLEzpIconElement>;
1161
1224
  "ezp-icon-button": LocalJSX.IntrinsicElements["ezp-icon-button"] & JSXBase.HTMLAttributes<HTMLEzpIconButtonElement>;
1162
1225
  "ezp-input": LocalJSX.IntrinsicElements["ezp-input"] & JSXBase.HTMLAttributes<HTMLEzpInputElement>;
@@ -13,12 +13,26 @@ export declare const storage: {
13
13
  getIsAuthorized(): boolean;
14
14
  setIsAuthorized(value: boolean): void;
15
15
  hasIsAuthorized(): boolean;
16
- getProperties(): PrinterProperties | null;
17
- setProperties(properties: PrinterProperties): void;
16
+ /**
17
+ * Settings the user last printed with on `printerId`, or null if that printer
18
+ * has none yet. Kept per printer so switching printers never carries another
19
+ * printer's paper size or tray over to one that may not have it.
20
+ */
21
+ getPrinterSettings(printerId: string): PrinterProperties | null;
22
+ setPrinterSettings(printerId: string, properties: PrinterProperties): void;
23
+ /** The printer used for the last print, preselected when the dialog reopens. */
18
24
  getPrinter(): Printer | null;
19
25
  setPrinter(printer: Printer): void;
20
- /** Remove everything tied to the current session (used on logout). */
26
+ /**
27
+ * Remove everything tied to the current session (used on logout).
28
+ *
29
+ * Print settings and the last printer deliberately survive: they belong to
30
+ * this browser profile rather than to the session, and are validated against
31
+ * the signed-in user's printers on the next load (an unknown printer resets
32
+ * the selection), so the next user never inherits a selection they can't use.
33
+ */
21
34
  clearSession(): void;
22
- /** Remove just the saved printer + its properties (used when the saved printer is gone). */
35
+ /** Forget which printer was last used (when it is gone from the user's list).
36
+ * Its settings stay put, ready in case that printer comes back. */
23
37
  clearSavedPrinter(): void;
24
38
  };
@@ -52,6 +52,7 @@ export type TextButtonLevelTypes = 'primary' | 'secondary' | 'tertiary'
52
52
  export type TextButtonTypeTypes = 'button'
53
53
  export type LabelLevelTypes = 'primary' | 'secondary' | 'tertiary'
54
54
  export type WeightTypes = 'soft' | 'strong' | 'heavy'
55
+ export type TooltipPlacementTypes = 'top' | 'bottom'
55
56
  export type ThemeTypes = 'pink' | 'red' | 'orange' | 'green' | 'teal' | 'cyan' | 'blue' | 'violet'
56
57
  export type AppearanceTypes = 'system' | 'light' | 'dark'
57
58
  export type TriggerTypes = 'custom' | 'file' | 'button'
@@ -8,6 +8,24 @@ import { PrinterConfig, PrinterProperties } from '../shared/types';
8
8
  * and returns it for convenience.
9
9
  */
10
10
  export declare function applyPrinterDefaults(config: PrinterConfig, properties: PrinterProperties): PrinterProperties;
11
+ /**
12
+ * Carry the settings the user last printed with on this printer over the
13
+ * printer's own defaults, dropping anything the printer can no longer do.
14
+ *
15
+ * Capabilities change between sessions — a printer loses a tray, an admin
16
+ * swaps the paper formats — and a stale value would otherwise be sent to the
17
+ * API or shown as a selection that isn't in the list. Each field is therefore
18
+ * only restored if the current config still offers it; everything else stays
19
+ * on the default `applyPrinterDefaults` just put in place. Copies and page
20
+ * ranges are never part of `saved`, so they are never restored.
21
+ */
22
+ export declare function applySavedProperties(config: PrinterConfig, saved: PrinterProperties | null, properties: PrinterProperties): PrinterProperties;
23
+ /**
24
+ * The slice of the current selection worth remembering for next time: what the
25
+ * print dialog offers per printer, minus copies and page ranges, which belong
26
+ * to the one document being printed rather than to the printer.
27
+ */
28
+ export declare function pickRememberedProperties(properties: PrinterProperties): PrinterProperties;
11
29
  /** Does this printer config report an explicit "no usable trays" state? */
12
30
  export declare function hasNoTrays(config: PrinterConfig): boolean;
13
31
  /** Does this printer config expose at least one selectable tray? */
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ezeep/ezeep-js",
3
- "version": "1.0.294",
3
+ "version": "1.0.302",
4
4
  "description": "A JavaScript library to enable easy and fast printing on any web application uising ezeep Blue.",
5
5
  "author": "Thinprint GmbH",
6
6
  "license": "MIT",
@@ -1 +1 @@
1
- import{p as e,B as t,c as n,w as i,N as l,H as a,b as r}from"./p-BButrLnB.js";export{s as setNonce}from"./p-BButrLnB.js";import{g as o}from"./p-C0WTlb31.js";var p=e=>{const t=e.cloneNode;e.cloneNode=function(e){if("TEMPLATE"===this.nodeName)return t.call(this,e);const n=t.call(this,!1),i=this.childNodes;if(e)for(let e=0;e<i.length;e++)2!==i[e].nodeType&&n.appendChild(i[e].cloneNode(!0));return n}};(()=>{t.isDev&&!t.isTesting&&n("Running in development mode."),t.cloneNodeFix&&p(a.prototype);const s=t.scriptDataOpts?i.document&&Array.from(i.document.querySelectorAll("script")).find((e=>new RegExp(`/${l}(\\.esm)?\\.js($|\\?|#)`).test(e.src)||e.getAttribute("data-stencil-namespace")===l)):null,r=import.meta.url,o=t.scriptDataOpts&&(s||{})["data-opts"]||{};return""!==r&&(o.resourcesUrl=new URL(".",r).href),e(o)})().then((async e=>(await o(),r([["p-3ab5a223",[[257,"ezp-printing",{clientid:[1],redirecturi:[1],filename:[1025],fileurl:[1],filetype:[1],custom:[4],hidelogin:[4],hidemenu:[4],hideheader:[4],authapihosturl:[1],printapihosturl:[1],theme:[1],fileid:[1],appearance:[1],trigger:[1],language:[1],code:[1],filedata:[1],seamless:[4],printOpen:[32],authOpen:[32],onlyGetSasUri:[32],noDocumentOpen:[32],systemAppearance:[32],files:[32],open:[64],logOut:[64],getSasUri:[64],getAuthUri:[64],setAuthRefreshToken:[64],checkAuth:[64]},[[0,"printCancel","listenPrintCancel"],[0,"printSubmit","listenPrintSubmit"],[0,"authCancel","listenAuthCancel"],[0,"userCancel","listenUserCancel"],[0,"authSuccess","listenAuthSuccess"],[0,"uploadFile","listenUploadFile"],[0,"uploadContinue","listenUploadContinue"],[0,"dialogClose","listenDialogClose"],[0,"dialogAction","listenDialogAction"],[0,"logout","listenLogout"]],{filedata:[{watchFileData:0}],filename:[{watchFilename:0}],fileurl:[{watchFileUrl:0}],language:[{watchLanguage:0}]}],[1,"ezp-printer-selection",{clientID:[1,"client-i-d"],redirectURI:[1,"redirect-u-r-i"],filename:[1025],fileurl:[1],filetype:[1025],fileid:[1025],files:[16],hidemenu:[4],hideheader:[4],seamless:[4],loading:[32],printProcessing:[32],pageRangeInvalid:[32],uploading:[32],preparingUpload:[32],printSuccess:[32],printFailed:[32],printTimedOut:[32],notSupported:[32],noPrinters:[32],hubDriverError:[32],userMenuOpen:[32],printStopped:[32],userName:[32],printers:[32],selectedPrinter:[32],printerConfig:[32],selectedPrinterConfig:[32],selectedProperties:[32],paperid:[32],currentFileIndex:[32],totalFiles:[32],failedFiles:[32],successfulFiles:[32],partialSuccess:[32]},[[0,"inputValueChanged","listenInputValueChanged"],[0,"selectSelection","listenSelectSelection"],[0,"stepperChanged","listenStepperChanged"],[0,"userMenuClosure","listenUserMenuClosure"],[0,"logoutEmitter","listenLogout"],[0,"statusCancel","listenStatusCancel"],[0,"statusClose","listenStatusClose"],[0,"statusRetry","listenStatusRetry"]]],[1,"ezp-auth",{clientID:[1025,"client-i-d"],redirectURI:[1025,"redirect-u-r-i"],hidelogin:[4],trigger:[1],code:[1],auth:[32],authURI:[32],accessToken:[32]},[[0,"dialogAction","listenDialogAction"],[0,"dialogClose","listenDialogClose"],[0,"statusCancel","listenStatusCancel"]]],[1,"ezp-upload",{selectedFiles:[32],dragging:[32]},[[0,"dragenter","handleDragEnter"],[0,"dragover","handleDragOver"],[1,"dragleave","handleDragLeave"],[0,"drop","handleDrop"],[9,"drop","resetDrag"],[9,"dragend","resetDrag"],[4,"printCancel","listenPrintCancel"]]],[1,"ezp-dialog",{heading:[1],description:[1],action:[1],iconName:[1,"icon-name"],iconSize:[1,"icon-size"],iconFramed:[4,"icon-framed"],instance:[1]},[[8,"keydown","handleKeydown"]]],[1,"ezp-user-menu",{name:[1],open:[1028]},null,{open:[{watchOpen:0}]}],[1,"ezp-select",{icon:[1],label:[1],optionFlow:[1,"option-flow"],options:[16],placeholder:[1],preSelected:[8,"pre-selected"],toggleFlow:[1,"toggle-flow"],disabled:[4],expanded:[32],selected:[32]},null,{expanded:[{watchExpanded:0}],preSelected:[{preSelectedChanged:0}]}],[1,"ezp-input",{label:[1],value:[1032],type:[1],icon:[1],suffix:[513],eventType:[1,"event-type"],placeholder:[1],focused:[32]}],[1,"ezp-stepper",{icon:[1],label:[1],max:[2],min:[2],canDecrease:[32],canIncrease:[32],focused:[32],value:[32]},null,{value:[{watchValue:0}]}],[1,"ezp-status",{description:[1],subtext:[1],processing:[4],instance:[1],icon:[1],cancel:[8],close:[8],retry:[8]}],[1,"ezp-backdrop",{visible:[1028]},[[0,"animationend","listenAnimationEnd"]]],[1,"ezp-icon-button",{blank:[4],disabled:[4],href:[1],icon:[1],level:[1],type:[1]}],[1,"ezp-text-button",{blank:[4],disabled:[4],href:[1],level:[1],label:[1],type:[1],small:[4]}],[1,"ezp-icon",{name:[1],size:[1],framed:[4]}],[1,"ezp-label",{ellipsis:[4],level:[1],noWrap:[4,"no-wrap"],text:[1],weight:[1]}]]]],e))));
1
+ import{p as e,B as n,c as t,w as i,N as l,H as a,b as r}from"./p-BButrLnB.js";export{s as setNonce}from"./p-BButrLnB.js";import{g as o}from"./p-C0WTlb31.js";var p=e=>{const n=e.cloneNode;e.cloneNode=function(e){if("TEMPLATE"===this.nodeName)return n.call(this,e);const t=n.call(this,!1),i=this.childNodes;if(e)for(let e=0;e<i.length;e++)2!==i[e].nodeType&&t.appendChild(i[e].cloneNode(!0));return t}};(()=>{n.isDev&&!n.isTesting&&t("Running in development mode."),n.cloneNodeFix&&p(a.prototype);const s=n.scriptDataOpts?i.document&&Array.from(i.document.querySelectorAll("script")).find((e=>new RegExp(`/${l}(\\.esm)?\\.js($|\\?|#)`).test(e.src)||e.getAttribute("data-stencil-namespace")===l)):null,r=import.meta.url,o=n.scriptDataOpts&&(s||{})["data-opts"]||{};return""!==r&&(o.resourcesUrl=new URL(".",r).href),e(o)})().then((async e=>(await o(),r([["p-ff075048",[[257,"ezp-printing",{clientid:[1],redirecturi:[1],filename:[1025],fileurl:[1],filetype:[1],custom:[4],hidelogin:[4],hidemenu:[4],hideheader:[4],authapihosturl:[1],printapihosturl:[1],theme:[1],fileid:[1],appearance:[1],trigger:[1],language:[1],code:[1],filedata:[1],seamless:[4],printOpen:[32],authOpen:[32],onlyGetSasUri:[32],noDocumentOpen:[32],systemAppearance:[32],files:[32],open:[64],logOut:[64],getSasUri:[64],getAuthUri:[64],setAuthRefreshToken:[64],checkAuth:[64]},[[0,"printCancel","listenPrintCancel"],[0,"printSubmit","listenPrintSubmit"],[0,"authCancel","listenAuthCancel"],[0,"userCancel","listenUserCancel"],[0,"authSuccess","listenAuthSuccess"],[0,"uploadFile","listenUploadFile"],[0,"uploadContinue","listenUploadContinue"],[0,"dialogClose","listenDialogClose"],[0,"dialogAction","listenDialogAction"],[0,"logout","listenLogout"]],{filedata:[{watchFileData:0}],filename:[{watchFilename:0}],fileurl:[{watchFileUrl:0}],language:[{watchLanguage:0}]}],[1,"ezp-printer-selection",{clientID:[1,"client-i-d"],redirectURI:[1,"redirect-u-r-i"],filename:[1025],fileurl:[1],filetype:[1025],fileid:[1025],files:[16],hidemenu:[4],hideheader:[4],seamless:[4],loading:[32],printProcessing:[32],pageRangeInvalid:[32],uploading:[32],preparingUpload:[32],printSuccess:[32],printFailed:[32],printTimedOut:[32],notSupported:[32],noPrinters:[32],hubDriverError:[32],userMenuOpen:[32],printStopped:[32],userName:[32],printers:[32],selectedPrinter:[32],printerConfig:[32],selectedPrinterConfig:[32],selectedProperties:[32],loadingPrinterConfig:[32],paperid:[32],currentFileIndex:[32],totalFiles:[32],failedFiles:[32],successfulFiles:[32],partialSuccess:[32]},[[0,"inputValueChanged","listenInputValueChanged"],[0,"selectSelection","listenSelectSelection"],[0,"stepperChanged","listenStepperChanged"],[0,"userMenuClosure","listenUserMenuClosure"],[0,"logoutEmitter","listenLogout"],[0,"statusCancel","listenStatusCancel"],[0,"statusClose","listenStatusClose"],[0,"statusRetry","listenStatusRetry"]]],[1,"ezp-auth",{clientID:[1025,"client-i-d"],redirectURI:[1025,"redirect-u-r-i"],hidelogin:[4],trigger:[1],code:[1],auth:[32],authURI:[32],accessToken:[32]},[[0,"dialogAction","listenDialogAction"],[0,"dialogClose","listenDialogClose"],[0,"statusCancel","listenStatusCancel"]]],[1,"ezp-upload",{selectedFiles:[32],dragging:[32]},[[0,"dragenter","handleDragEnter"],[0,"dragover","handleDragOver"],[1,"dragleave","handleDragLeave"],[0,"drop","handleDrop"],[9,"drop","resetDrag"],[9,"dragend","resetDrag"],[4,"printCancel","listenPrintCancel"]]],[1,"ezp-dialog",{heading:[1],description:[1],action:[1],iconName:[1,"icon-name"],iconSize:[1,"icon-size"],iconFramed:[4,"icon-framed"],instance:[1]},[[8,"keydown","handleKeydown"]]],[1,"ezp-user-menu",{name:[1],open:[1028]},null,{open:[{watchOpen:0}]}],[1,"ezp-select",{icon:[1],label:[1],optionFlow:[1,"option-flow"],options:[16],placeholder:[1],preSelected:[8,"pre-selected"],toggleFlow:[1,"toggle-flow"],disabled:[4],expanded:[32],selected:[32]},null,{expanded:[{watchExpanded:0}],preSelected:[{preSelectedChanged:0}]}],[1,"ezp-input",{label:[1],value:[1032],type:[1],icon:[1],suffix:[513],eventType:[1,"event-type"],placeholder:[1],focused:[32]}],[1,"ezp-stepper",{icon:[1],label:[1],max:[2],min:[2],canDecrease:[32],canIncrease:[32],focused:[32],value:[32]},null,{value:[{watchValue:0}]}],[1,"ezp-status",{description:[1],subtext:[1],processing:[4],instance:[1],icon:[1],cancel:[8],close:[8],retry:[8]}],[1,"ezp-file-name",{name:[1],level:[1],weight:[1],placement:[1],expanded:[32],tooltipOpen:[32]},[[10,"keydown","handleKeyDown"]]],[1,"ezp-backdrop",{visible:[1028]},[[0,"animationend","listenAnimationEnd"]]],[1,"ezp-icon-button",{blank:[4],disabled:[4],href:[1],icon:[1],level:[1],type:[1]}],[1,"ezp-text-button",{blank:[4],disabled:[4],href:[1],level:[1],label:[1],type:[1],small:[4]}],[1,"ezp-icon",{name:[1],size:[1],framed:[4]}],[1,"ezp-label",{ellipsis:[4],level:[1],noWrap:[4,"no-wrap"],text:[1],weight:[1],isTruncated:[64]}]]]],e))));