@egen-civitas/esm-dynamic-loading 2.0.1 → 2.2.0

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.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,38 @@
1
1
  # @egen-civitas/esm-dynamic-loading
2
2
 
3
+ ## 2.2.0
4
+
5
+ ### Minor Changes
6
+
7
+ - d9b2c40: L'import map accepte une table facultative `aliases` (`{ "<alias>": "<nom réel>" }`) : `importDynamic` retrouve alors un paquet par un nom alternatif (par exemple un espace de noms i18n différent du nom du paquet). Une clé présente dans `imports` prime toujours sur un alias, la lecture de l'import map reste incluse dans le délai maximal de chargement, et les import maps sans `aliases` se comportent comme avant.
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [d9b2c40]
12
+ - @egen-civitas/esm-globals@2.5.0
13
+
14
+ ## 2.1.0
15
+
16
+ ### Minor Changes
17
+
18
+ - 669cbd6: Réforme multiplateforme, lot P0 (docs/EGEN-FRAMEWORK-DEV.md) :
19
+
20
+ - esm-globals : `EgenTarget`, `CapabilityName`, `getEgenTarget()`, `isNativeTarget()`.
21
+ - esm-platform (nouveau package, 1.0.0) : contrats des capacités (annexe 2), `PlatformError`, détection de la cible, `getPlatform()` (adaptateur Web : session vide, `openExternal`, `lifecycle`, `files.select`, `camera`, `permissions` ; jamais de faux coffre ni de biométrie simulée. En natif, aucune capacité tant que le client de pont n'est pas branché, `ready` rejette `INCOMPATIBLE` sans Host), `createMockPlatform` (sous-chemin `/testing`).
22
+ - esm-framework : ré-export de `@egen-civitas/esm-platform` (`index`, `internal`, mocks).
23
+ - egen (CLI) : option `build --platform web|android|ios`.
24
+ - esm-api : `setAuthorizationProvider` (jeton fourni par la plateforme, rafraîchissement unique sur 401, rejeu GET/HEAD, politique `credentials`) ; `FetchConfig.replayOnUnauthorized` ; `isDevAuthBypassEnabled()` inerte en natif. Sans fournisseur, comportement inchangé.
25
+ - esm-dynamic-loading : overrides d'import map et de route map désactivés en cible native.
26
+
27
+ ### Patch Changes
28
+
29
+ - Updated dependencies [d1d2d7d]
30
+ - Updated dependencies [669cbd6]
31
+ - Updated dependencies [b3d9419]
32
+ - Updated dependencies [5958a56]
33
+ - @egen-civitas/esm-globals@2.1.0
34
+ - @egen-civitas/esm-translations@1.0.4
35
+
3
36
  ## 2.0.1
4
37
 
5
38
  ### Patch Changes
@@ -26,7 +26,7 @@ export declare function slugify(name: string): string;
26
26
  * script to load before the promise returned from this function will be rejected. Defaults to 600,000 milliseconds,
27
27
  * i.e., 10 minutes.
28
28
  */
29
- export declare function importDynamic<T = any>(jsPackage: string, share?: string, options?: {
29
+ export declare function importDynamic<T = any>(requestedPackage: string, share?: string, options?: {
30
30
  importMap?: ImportMap;
31
31
  maxLoadingTime?: number;
32
32
  }): Promise<T>;
@@ -1 +1 @@
1
- {"version":3,"file":"dynamic-loading.d.ts","sourceRoot":"","sources":["../src/dynamic-loading.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAI/E;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,UAEnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,GAAG,EACzC,SAAS,EAAE,MAAM,EACjB,KAAK,GAAE,MAAkB,EACzB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,CAAC,CAAC,CAyCZ;AAuBD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,oBAoD3E;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,uBAExC"}
1
+ {"version":3,"file":"dynamic-loading.d.ts","sourceRoot":"","sources":["../src/dynamic-loading.ts"],"names":[],"mappings":"AAEA,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAI/E;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,UAEnC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,GAAG,EACzC,gBAAgB,EAAE,MAAM,EACxB,KAAK,GAAE,MAAkB,EACzB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,OAAO,CAAC,CAAC,CAAC,CAyDZ;AAuBD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,oBAoD3E;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,uBAExC"}
@@ -29,12 +29,27 @@ import { getCurrentPageMap, getImportMapOverrideMap, resetImportMapOverrides } f
29
29
  * @param options.maxLoadingTime A positive integer representing the maximum number of milliseconds to wait for the
30
30
  * script to load before the promise returned from this function will be rejected. Defaults to 600,000 milliseconds,
31
31
  * i.e., 10 minutes.
32
- */ export async function importDynamic(jsPackage, share = './start', options) {
32
+ */ export async function importDynamic(requestedPackage, share = './start', options) {
33
33
  // default to 10 minutes
34
34
  const maxLoadingTime = !options?.maxLoadingTime || options.maxLoadingTime <= 0 ? 600000 : options.maxLoadingTime;
35
+ // Alias de module (`importMap.aliases`) : permet de retrouver un paquet par un nom alternatif
36
+ // (ex. namespace i18n ≠ nom du paquet). Un nom présent dans `imports` n'est jamais remplacé.
37
+ // La résolution est incluse dans la course contre le délai maximal (la lecture de l'import map aussi).
38
+ let importMap = options?.importMap;
39
+ let jsPackage = requestedPackage;
40
+ const resolveAndPreload = async ()=>{
41
+ if (typeof requestedPackage === 'string' && requestedPackage.trim().length > 0 && !window[slugify(requestedPackage)]) {
42
+ importMap = importMap ?? await getCurrentImportMap();
43
+ const target = importMap.aliases?.[requestedPackage];
44
+ if (target && !Object.prototype.hasOwnProperty.call(importMap.imports, requestedPackage)) {
45
+ jsPackage = target;
46
+ }
47
+ }
48
+ await preloadImport(jsPackage, importMap);
49
+ };
35
50
  let timeout = undefined;
36
51
  await Promise.race([
37
- preloadImport(jsPackage, options?.importMap),
52
+ resolveAndPreload(),
38
53
  new Promise((_, reject)=>{
39
54
  timeout = setTimeout(()=>{
40
55
  reject(new Error(`Could not resolve requested script, ${jsPackage}, within ${humanReadableMs(maxLoadingTime)}.`));
@@ -1,5 +1,5 @@
1
1
  /** @module @category Import Map */
2
- import type { ImportMap } from '@egen-civitas/esm-globals';
2
+ import { type ImportMap } from '@egen-civitas/esm-globals';
3
3
  /**
4
4
  * Returns the import map for the current page. In dev mode, this merges
5
5
  * the base map with the override snapshot captured at page load.
@@ -1 +1 @@
1
- {"version":3,"file":"import-maps.d.ts","sourceRoot":"","sources":["../src/import-maps.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA2E3D;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,CAO5D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,SAAS,CAAC,CAEjE;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,SAAS,CAAC,CAMlE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAmB5E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,EAAE,CAiBxD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAWpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiB1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAmB9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgB1D;AAaD,wBAAgB,uBAAuB,SAWtC"}
1
+ {"version":3,"file":"import-maps.d.ts","sourceRoot":"","sources":["../src/import-maps.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAkB,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AA8E3E;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,SAAS,CAAC,CAO5D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,SAAS,CAAC,CAEjE;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,SAAS,CAAC,CAMlE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,eAAe,CAAC,EAAE,OAAO,GAAG,SAAS,CAmB5E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,EAAE,CAiBxD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAWpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAiB1D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,IAAI,CAmB9C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgB1D;AAaD,wBAAgB,uBAAuB,SAatC"}
@@ -1,4 +1,5 @@
1
- /** @module @category Import Map */ const OVERRIDE_PREFIX = 'import-map-override:';
1
+ /** @module @category Import Map */ import { isNativeTarget } from "@egen-civitas/esm-globals";
2
+ const OVERRIDE_PREFIX = 'import-map-override:';
2
3
  const DISABLED_KEY = 'import-map-overrides-disabled';
3
4
  const CHANGE_EVENT = 'import-map-overrides:change';
4
5
  // Set by setupImportMapOverrides(); controls whether override functionality is active.
@@ -36,6 +37,9 @@ function mergeMaps(maps) {
36
37
  if (map?.imports) {
37
38
  Object.assign(merged.imports, map.imports);
38
39
  }
40
+ if (map?.aliases) {
41
+ merged.aliases = Object.assign(merged.aliases ?? {}, map.aliases);
42
+ }
39
43
  }
40
44
  return merged;
41
45
  }
@@ -239,7 +243,9 @@ export function setupImportMapOverrides() {
239
243
  return;
240
244
  }
241
245
  initialized = true;
242
- devMode = window.spaEnv === 'development';
246
+ // Cibles natives : les overrides sont TOUJOURS désactivés (aucun code non prévu ne doit pouvoir être chargé),
247
+ // même si `window.spaEnv` valait « development » (le build natif impose déjà la production : seconde ceinture).
248
+ devMode = window.spaEnv === 'development' && !isNativeTarget();
243
249
  if (devMode) {
244
250
  initialOverrideSnapshot = readOverrideMap();
245
251
  }
@@ -1 +1 @@
1
- {"version":3,"file":"route-maps.d.ts","sourceRoot":"","sources":["../src/route-maps.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAAiC,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AA2G/G;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,CAAC,CAO9D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,UAAU,CAAC,CAEjE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,UAAU,CAAC,CAMlE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,GAAG,QAkC3F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,QAYxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,SAmBrC;AAaD,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgBtD"}
1
+ {"version":3,"file":"route-maps.d.ts","sourceRoot":"","sources":["../src/route-maps.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,UAAU,EAChB,MAAM,2BAA2B,CAAC;AA2GnC;;;GAGG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,UAAU,CAAC,CAO9D;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,UAAU,CAAC,CAEjE;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,UAAU,CAAC,CAMlE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAoB/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,GAAG,QAkC3F;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,QAYxD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,SAmBrC;AAaD,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBtD"}
@@ -1,4 +1,4 @@
1
- /** @module @category Route Map */ import { isEgenAppRoutes, isEgenRoutes } from "@egen-civitas/esm-globals";
1
+ /** @module @category Route Map */ import { isEgenAppRoutes, isEgenRoutes, isNativeTarget } from "@egen-civitas/esm-globals";
2
2
  const OVERRIDE_PREFIX = 'egen-routes:';
3
3
  const CHANGE_EVENT = 'egen-routes:change';
4
4
  // Set by setupRouteMapOverrides(); controls whether override functionality is active.
@@ -240,7 +240,9 @@ export function setupRouteMapOverrides() {
240
240
  if (setupPromise) {
241
241
  return setupPromise;
242
242
  }
243
- devMode = window.spaEnv === 'development';
243
+ // Cibles natives : les overrides sont TOUJOURS désactivés (aucun code non prévu ne doit pouvoir être chargé),
244
+ // même si `window.spaEnv` valait « development » (le build natif impose déjà la production : seconde ceinture).
245
+ devMode = window.spaEnv === 'development' && !isNativeTarget();
244
246
  if (devMode) {
245
247
  setupPromise = readOverrideMap().then((snapshot)=>{
246
248
  initialOverrideSnapshot = snapshot;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@egen-civitas/esm-dynamic-loading",
3
- "version": "2.0.1",
3
+ "version": "2.2.0",
4
4
  "license": "MPL-2.0",
5
5
  "description": "Utilities for dynamically loading code in Egen",
6
6
  "type": "module",
@@ -56,12 +56,12 @@
56
56
  "access": "public"
57
57
  },
58
58
  "peerDependencies": {
59
- "@egen-civitas/esm-globals": "^2.0.0",
60
- "@egen-civitas/esm-translations": "^1.0.3"
59
+ "@egen-civitas/esm-globals": "^2.5.0",
60
+ "@egen-civitas/esm-translations": "^1.0.4"
61
61
  },
62
62
  "devDependencies": {
63
- "@egen-civitas/esm-globals": "^2.0.0",
64
- "@egen-civitas/esm-translations": "^1.0.3",
63
+ "@egen-civitas/esm-globals": "^2.5.0",
64
+ "@egen-civitas/esm-translations": "^1.0.4",
65
65
  "@swc/cli": "0.8.1",
66
66
  "@swc/core": "1.15.21",
67
67
  "@vitest/coverage-v8": "^4.1.2",
@@ -70,6 +70,7 @@
70
70
  "jsdom": "^29.0.2",
71
71
  "rimraf": "^6.1.3",
72
72
  "single-spa": "^6.0.3",
73
+ "typescript": "^5.8.3",
73
74
  "vitest": "^4.1.2",
74
75
  "vitest-fetch-mock": "^0.4.5"
75
76
  }