@komaci/esm-generator 240.1.3

package/build/types.d.ts

@@ -0,0 +1,132 @@
+import * as t from '@babel/types';
+import { KomaciDocument } from '@komaci/types';
+import { AstContext } from '@komaci/common-shared';
+export declare type GeneratorInput = {
+    moduleInfo: ModuleFileInfo | ModuleBundleInfo;
+    options?: GeneratorOptions;
+    srcFileMap?: {
+        [filename: string]: string;
+    };
+};
+declare type ModuleInfo = {
+    type: string;
+    name: string;
+    namespace: string;
+};
+export declare type ModuleFileInfo = ModuleInfo & {
+    type: 'file';
+    fileName: string;
+    komaciDoc: KomaciDocument;
+};
+export declare type ModuleBundleInfo = ModuleInfo & {
+    type: 'bundle';
+    files: {
+        [fileName: string]: KomaciDocument;
+    };
+};
+export declare type GeneratorOptions = {
+    removeUnlinkedNodes?: boolean;
+    inlineRelativeImports?: boolean;
+    targetModule?: string;
+};
+export declare type GeneratorState = {
+    inlineTemplateDoc?: KomaciDocument;
+    input: GeneratorInput;
+    adgImportSuffix: number;
+    importAliasSuffix: number;
+    scriptGenState: {
+        importRefsMap: {
+            [refId: string]: ImportInfo;
+        };
+        importMetadata?: AstContext['importDeclarations'];
+        importInfosForWireAdapter: Set<ImportInfo>;
+        requiredFactoryFunctions: Set<t.Identifier>;
+        primingAdapterImportDeclarations: t.ImportDeclaration[];
+        ast?: t.File;
+    };
+    templateGenState: {
+        importRefsMap: {
+            [refId: string]: ImportInfo;
+        };
+        requiredFactoryFunctions: Set<t.Identifier>;
+        refProps: Set<string>;
+    };
+    iterationContext: string[];
+    defaultCompImported: boolean;
+    adgNameMap: {
+        [index: string]: string;
+    };
+    isDefaultExportFound: boolean;
+};
+/**
+ * Information about an import composed when adding imports to the resolvable module.
+ * All information here is uplifted directly from Komaci Document state.
+ *
+ * NOTE: some of these imports are **INVALID** meaning they come from an unsupported namespace.
+ *
+ */
+export declare type ImportInfo = {
+    /** locally generated identifier (i0, i1, etc) represented as the babel identifier obj. if import is bad localName is UNRESOLVED  */
+    localName: t.Identifier;
+    /**
+     * component id for if this import maps to a component used in a template
+     * this is only managed as part of processTemplateImports
+     */
+    componentId?: string;
+    /** import path for this import */
+    resourceName: string;
+    exportName: string | undefined;
+    /** enum indicating how the import's export is being used. ex: { wireadapter, getter, wireconfig, initialvalue, composedadg } */
+    importUsages: Set<ImportUsageState>;
+    /**
+     * t.ImportSpecifiers for import.
+     * ex: `import { wire1 as i1, wire2 as i2} from "my/resourceName"`.
+     * `wire1 as i1` and `wire2 as i2` are the import's specifiers.
+     */
+    importSpecifier: t.ImportSpecifier | t.ImportDefaultSpecifier | t.ImportNamespaceSpecifier;
+    /** newly formed import statement for resolvable module */
+    importDeclaration: t.ImportDeclaration | undefined;
+    primingAdapterImportNames?: PrimingAdapterImportNames;
+};
+export declare type ImportRefPropUsed = {
+    importRef: string;
+    propUsed: boolean;
+};
+/**
+ *  Names of local imports for Priming Adapters
+ */
+export declare type PrimingAdapterImportNames = {
+    primingAdapterDef: PrimingAdapterDefinition;
+    adapter: t.Identifier;
+    batchAdapter?: t.Identifier;
+    reducer?: t.Identifier;
+};
+export declare enum ImportUsageState {
+    wireadapter = "wireadapter",
+    getter = "getter",
+    wireconfig = "wireconfig",
+    initialvalue = "initialvalue",
+    composedadg = "composedadg",
+    parentadg = "parentadg"
+}
+export declare type ImportBinding = {
+    importPath: string;
+    identifier: string;
+};
+export declare type PrimingAdapterDefinition = {
+    prime: ImportBinding;
+    batch?: {
+        prime: ImportBinding;
+        reducer: ImportBinding;
+    };
+};
+export declare type GetPrimingAdapter = {
+    (importPath: string, identifier: string): PrimingAdapterDefinition | null;
+};
+export declare type WireAdaptersMapping = {
+    [importPath: string]: {
+        [identifier: string]: PrimingAdapterDefinition;
+    };
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/build/types.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImportUsageState = void 0;
+// enum representing the different states of the way an Import is used
+var ImportUsageState;
+(function (ImportUsageState) {
+    ImportUsageState["wireadapter"] = "wireadapter";
+    ImportUsageState["getter"] = "getter";
+    ImportUsageState["wireconfig"] = "wireconfig";
+    ImportUsageState["initialvalue"] = "initialvalue";
+    ImportUsageState["composedadg"] = "composedadg";
+    ImportUsageState["parentadg"] = "parentadg";
+})(ImportUsageState = exports.ImportUsageState || (exports.ImportUsageState = {}));
+//# sourceMappingURL=types.js.map

package/package.json

@@ -0,0 +1,40 @@
+{
+    "name": "@komaci/esm-generator",
+    "version": "240.1.3",
+    "description": "Komaci generator for ADG ES modules",
+    "homepage": "https://komaci.dev/",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/salesforce/komaci.git",
+        "directory": "packages/@komaci/esm-generator"
+    },
+    "bugs": {
+        "url": "https://github.com/salesforce/komaci/issues"
+    },
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "type": "commonjs",
+    "types": "build/index.d.ts",
+    "main": "build/index.js",
+    "scripts": {
+        "build": "tsc -b"
+    },
+    "files": [
+        "build/**/*.js",
+        "build/**/*.d.ts"
+    ],
+    "dependencies": {
+        "@babel/core": "^7.9.0",
+        "@babel/generator": "^7.9.0",
+        "@komaci/common-shared": "240.1.3",
+        "@komaci/static-analyzer": "240.1.3",
+        "o11y": "^240.7.0"
+    },
+    "devDependencies": {
+        "@babel/types": "^7.9.0",
+        "@komaci/types": "240.1.3",
+        "@lwc-platform/sfdc-lwc-compiler": "^2.18.0-240.2"
+    }
+}