@lwrjs/shared-utils 0.10.0-alpha.14 → 0.10.0-alpha.16

package/build/cjs/bundle.cjs

@@ -8,6 +8,7 @@ var __export = (target, all) => {
 // packages/@lwrjs/shared-utils/src/bundle.ts
 __markAsModule(exports);
 __export(exports, {
+  createAmdAlias: () => createAmdAlias,
   getGroupName: () => getGroupName,
   isGroupie: () => isGroupie
 });
@@ -26,3 +27,11 @@ function isGroupie(rawSpecifier, groupsConfig) {
   }
   return false;
 }
+function createAmdAlias(aliasSpecifier, originalSpecifier) {
+  const builder = [];
+  builder.push(`LWR.define('${aliasSpecifier}',['exports','${originalSpecifier}'],function(e,m){`);
+  builder.push(`e.default=m&&'object'==typeof m&&'default'in m?m.default:m;`);
+  builder.push(`Object.keys(m).forEach(function(n){'default'===n||e.hasOwnProperty(n)||Object.defineProperty(e,n,{enumerable:!0,get:function(){return m[n]}})});`);
+  builder.push("});");
+  return builder.join("");
+}

package/build/cjs/env.cjs

@@ -16,6 +16,6 @@ function getFeatureFlags() {
     LEGACY_LOADER: process.env.LEGACY_LOADER !== void 0 && process.env.LEGACY_LOADER.toLowerCase() === "true" ? true : false,
     SSR_SANDBOX_WORKER: process.env.SSR_SANDBOX_WORKER !== void 0 && process.env.SSR_SANDBOX_WORKER.toLowerCase() === "true" ? true : false,
     SSR_STATIC_BUNDLES: process.env.SSR_STATIC_BUNDLES !== void 0 && process.env.SSR_STATIC_BUNDLES.toLowerCase() === "true" ? true : false,
-    UNVERSIONED_ALIASES: process.env.UNVERSIONED_ALIASES !== void 0 && process.env.UNVERSIONED_ALIASES.toLowerCase() === "true" ? true : false
+    EXPERIMENTAL_UNVERSIONED_ALIASES: process.env.EXPERIMENTAL_UNVERSIONED_ALIASES !== void 0 && process.env.EXPERIMENTAL_UNVERSIONED_ALIASES.toLowerCase() === "true" ? true : false
   };
 }

package/build/cjs/html-meta.cjs

@@ -24,9 +24,13 @@ var __toModule = (module2) => {
 // packages/@lwrjs/shared-utils/src/html-meta.ts
 __markAsModule(exports);
 __export(exports, {
+  HYDRATE_CLIENT_VALUE: () => HYDRATE_CLIENT_VALUE,
   HYDRATE_DIRECTIVE: () => HYDRATE_DIRECTIVE,
+  HYDRATE_LOAD_VALUE: () => HYDRATE_LOAD_VALUE,
   extractMetadataFromHtml: () => extractMetadataFromHtml,
-  hasHydrateDirective: () => hasHydrateDirective,
+  getHydrateDirective: () => getHydrateDirective,
+  isCsrIsland: () => isCsrIsland,
+  isHydrateOnLoad: () => isHydrateOnLoad,
   isRelative: () => isRelative,
   isSelfUrl: () => isSelfUrl
 });
@@ -120,6 +124,18 @@ async function extractMetadataFromHtml(htmlSource) {
   });
 }
 var HYDRATE_DIRECTIVE = "lwr:hydrate";
-function hasHydrateDirective(props = {}) {
-  return Object.keys(props).filter((propName) => propName === HYDRATE_DIRECTIVE).length > 0;
+var HYDRATE_LOAD_VALUE = "load";
+var HYDRATE_CLIENT_VALUE = "client-only";
+var HYDRATION_VALUES = [HYDRATE_LOAD_VALUE, HYDRATE_CLIENT_VALUE];
+function getHydrateDirective(props = {}) {
+  const rawValue = props[HYDRATE_DIRECTIVE];
+  const value = rawValue === "true" ? HYDRATE_LOAD_VALUE : rawValue;
+  if (HYDRATION_VALUES.includes(value))
+    return value;
+}
+function isHydrateOnLoad(props = {}) {
+  return getHydrateDirective(props) === HYDRATE_LOAD_VALUE;
+}
+function isCsrIsland(props = {}) {
+  return getHydrateDirective(props) === HYDRATE_CLIENT_VALUE;
 }

package/build/cjs/import-metadata.cjs

@@ -29,6 +29,7 @@ __export(exports, {
 });
 var import_es_module_lexer = __toModule(require("es-module-lexer"));
 var import_logger = __toModule(require("./logger.cjs"));
+var IMPORT_META_REGEX = /^import\.meta(\.\w+)+/;
 var ModuleNameType;
 (function(ModuleNameType2) {
   ModuleNameType2["string"] = "string";
@@ -37,11 +38,13 @@ var ModuleNameType;
 async function getImportMetadata(compiledSource) {
   const imports = [];
   const dynamicImports = [];
+  const importMeta = [];
   const [moduleImportLocations] = await (0, import_es_module_lexer.parse)(compiledSource);
   for (const moduleImportLocation of moduleImportLocations) {
     let moduleSpecifier = compiledSource.substring(moduleImportLocation.s, moduleImportLocation.e);
     const isStatic = moduleImportLocation.d === -1;
     const isDynamic = moduleImportLocation.d > -1;
+    const isMeta = moduleImportLocation.d === -2;
     const location = {
       startColumn: moduleImportLocation.s,
       endColumn: moduleImportLocation.e
@@ -64,10 +67,24 @@ async function getImportMetadata(compiledSource) {
       });
     } else if (isStatic) {
       imports.push({moduleSpecifier, location});
+    } else if (isMeta) {
+      const metaMatch = IMPORT_META_REGEX.exec(compiledSource.substring(moduleImportLocation.s));
+      if (metaMatch) {
+        const statement = metaMatch[0];
+        const extraLength = statement.length - 11;
+        importMeta.push({
+          statement,
+          location: {
+            startColumn: moduleImportLocation.s,
+            endColumn: moduleImportLocation.e + extraLength
+          }
+        });
+      }
     }
   }
   return {
     imports,
-    dynamicImports
+    dynamicImports,
+    importMeta
   };
 }

package/build/es/bundle.d.ts

@@ -1,4 +1,16 @@
 import type { BundleGroups } from '@lwrjs/types';
 export declare function getGroupName(rawSpecifier: string, groupsConfig: BundleGroups): string | undefined;
 export declare function isGroupie(rawSpecifier: string, groupsConfig: BundleGroups): boolean;
+/**
+ * Create an AMD Alias to another AMD module
+ *
+ * In the spirit of...
+ * LWR.define('alias', 'og', og=>og);
+ *
+ * But if OG has a default it is exposed as exports.default
+ *
+ * All enumerable properties of og are exposed as enumerable properties of exports.
+ *
+ */
+export declare function createAmdAlias(aliasSpecifier: string, originalSpecifier: string): string;
 //# sourceMappingURL=bundle.d.ts.map

package/build/es/bundle.js

@@ -13,4 +13,27 @@ export function isGroupie(rawSpecifier, groupsConfig) {
     }
     return false;
 }
+/**
+ * Create an AMD Alias to another AMD module
+ *
+ * In the spirit of...
+ * LWR.define('alias', 'og', og=>og);
+ *
+ * But if OG has a default it is exposed as exports.default
+ *
+ * All enumerable properties of og are exposed as enumerable properties of exports.
+ *
+ */
+export function createAmdAlias(aliasSpecifier, originalSpecifier) {
+    const builder = [];
+    // Define statement
+    builder.push(`LWR.define('${aliasSpecifier}',['exports','${originalSpecifier}'],function(e,m){`);
+    // un-wrap default
+    builder.push(`e.default=m&&'object'==typeof m&&'default'in m?m.default:m;`);
+    // Expose enumerable properties
+    builder.push(`Object.keys(m).forEach(function(n){'default'===n||e.hasOwnProperty(n)||Object.defineProperty(e,n,{enumerable:!0,get:function(){return m[n]}})});`);
+    // End the define
+    builder.push('});');
+    return builder.join('');
+}
 //# sourceMappingURL=bundle.js.map

package/build/es/env.js

@@ -21,8 +21,8 @@ export function getFeatureFlags() {
             ? true
             : false,
         // AMD Module Bundles include un-versioned aliases
-        UNVERSIONED_ALIASES: process.env.UNVERSIONED_ALIASES !== undefined &&
-            process.env.UNVERSIONED_ALIASES.toLowerCase() === 'true'
+        EXPERIMENTAL_UNVERSIONED_ALIASES: process.env.EXPERIMENTAL_UNVERSIONED_ALIASES !== undefined &&
+            process.env.EXPERIMENTAL_UNVERSIONED_ALIASES.toLowerCase() === 'true'
             ? true
             : false,
     };

package/build/es/html-meta.d.ts

@@ -7,5 +7,9 @@ export declare function isSelfUrl(url: string): boolean;
  */
 export declare function extractMetadataFromHtml(htmlSource: string): Promise<RenderedViewMetadata>;
 export declare const HYDRATE_DIRECTIVE = "lwr:hydrate";
-export declare function hasHydrateDirective(props?: {}): boolean;
+export declare const HYDRATE_LOAD_VALUE = "load";
+export declare const HYDRATE_CLIENT_VALUE = "client-only";
+export declare function getHydrateDirective(props?: Record<string, string>): string | undefined;
+export declare function isHydrateOnLoad(props?: {}): boolean;
+export declare function isCsrIsland(props?: {}): boolean;
 //# sourceMappingURL=html-meta.d.ts.map

package/build/es/html-meta.js

@@ -106,7 +106,19 @@ export async function extractMetadataFromHtml(htmlSource) {
     });
 }
 export const HYDRATE_DIRECTIVE = 'lwr:hydrate';
-export function hasHydrateDirective(props = {}) {
-    return Object.keys(props).filter((propName) => propName === HYDRATE_DIRECTIVE).length > 0;
+export const HYDRATE_LOAD_VALUE = 'load';
+export const HYDRATE_CLIENT_VALUE = 'client-only';
+const HYDRATION_VALUES = [HYDRATE_LOAD_VALUE, HYDRATE_CLIENT_VALUE];
+export function getHydrateDirective(props = {}) {
+    const rawValue = props[HYDRATE_DIRECTIVE];
+    const value = rawValue === 'true' ? HYDRATE_LOAD_VALUE : rawValue; // valueless hyration directives => lwr:hydrate="load"
+    if (HYDRATION_VALUES.includes(value))
+        return value;
+}
+export function isHydrateOnLoad(props = {}) {
+    return getHydrateDirective(props) === HYDRATE_LOAD_VALUE;
+}
+export function isCsrIsland(props = {}) {
+    return getHydrateDirective(props) === HYDRATE_CLIENT_VALUE;
 }
 //# sourceMappingURL=html-meta.js.map

package/build/es/import-metadata.js

@@ -1,5 +1,6 @@
 import { parse as parseImports } from 'es-module-lexer';
 import { DEBUG, logger, VERBOSE } from './logger.js';
+const IMPORT_META_REGEX = /^import\.meta(\.\w+)+/;
 export var ModuleNameType;
 (function (ModuleNameType) {
     ModuleNameType["string"] = "string";
@@ -8,6 +9,7 @@ export var ModuleNameType;
 export async function getImportMetadata(compiledSource) {
     const imports = [];
     const dynamicImports = [];
+    const importMeta = [];
     // Use very fast parser to get the location of the imports/exports
     const [moduleImportLocations] = await parseImports(compiledSource);
     for (const moduleImportLocation of moduleImportLocations) {
@@ -15,6 +17,7 @@ export async function getImportMetadata(compiledSource) {
         let moduleSpecifier = compiledSource.substring(moduleImportLocation.s, moduleImportLocation.e);
         const isStatic = moduleImportLocation.d === -1;
         const isDynamic = moduleImportLocation.d > -1;
+        const isMeta = moduleImportLocation.d === -2;
         const location = {
             startColumn: moduleImportLocation.s,
             endColumn: moduleImportLocation.e,
@@ -40,10 +43,27 @@ export async function getImportMetadata(compiledSource) {
         else if (isStatic) {
             imports.push({ moduleSpecifier, location });
         }
+        else if (isMeta) {
+            // moduleImportLocation.s => moduleImportLocation.e only captures "import.meta"
+            // this regex will capture the entire statement, eg: `import.meta.env.SSR"
+            const metaMatch = IMPORT_META_REGEX.exec(compiledSource.substring(moduleImportLocation.s));
+            if (metaMatch) {
+                const statement = metaMatch[0];
+                const extraLength = statement.length - 11; // to include meta property, eg: ".env.SSR"
+                importMeta.push({
+                    statement,
+                    location: {
+                        startColumn: moduleImportLocation.s,
+                        endColumn: moduleImportLocation.e + extraLength,
+                    },
+                });
+            }
+        }
     }
     return {
         imports,
         dynamicImports,
+        importMeta,
     };
 }
 //# sourceMappingURL=import-metadata.js.map

package/package.json

@@ -4,7 +4,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "version": "0.10.0-alpha.14",
+    "version": "0.10.0-alpha.16",
     "homepage": "https://developer.salesforce.com/docs/platform/lwr/overview",
     "repository": {
         "type": "git",
@@ -62,13 +62,13 @@
         "rollup": "^2.78.0"
     },
     "devDependencies": {
-        "@lwrjs/diagnostics": "0.10.0-alpha.14",
-        "@lwrjs/types": "0.10.0-alpha.14",
+        "@lwrjs/diagnostics": "0.10.0-alpha.16",
+        "@lwrjs/types": "0.10.0-alpha.16",
         "@types/mime-types": "2.1.1",
         "@types/path-to-regexp": "^1.7.0"
     },
     "engines": {
         "node": ">=16.0.0 <20"
     },
-    "gitHead": "f80dc1c18719b77c183f339027313be11d69f9dc"
+    "gitHead": "c5a13d471330c0f738d0c783fd1b69f456c544bd"
 }