@sitecore-jss/sitecore-jss-dev-tools 22.0.0-canary.9 → 22.1.0-canary.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sitecore-jss/sitecore-jss-dev-tools",
-  "version": "22.0.0-canary.9",
+  "version": "22.1.0-canary.2",
   "description": "Utilities to assist in the development and deployment of Sitecore JSS apps.",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",
@@ -9,15 +9,14 @@
     "build": "npm run clean && tsc -p tsconfig.json && tsc -p tsconfig-esm.json",
     "watch": "npm run build -- --watch",
     "clean": "del-cli dist types",
-    "lint": "eslint ./src/**/*.ts",
+    "lint": "eslint \"./src/**/*.ts\"",
     "test": "mocha --require ts-node/register -r tsconfig-paths/register  \"./src/**/*.test.ts\"",
     "prepublishOnly": "npm run build",
     "coverage": "nyc npm test",
     "generate-docs": "npx typedoc --plugin typedoc-plugin-markdown --readme none --out ../../ref-docs/sitecore-jss-dev-tools src/index.ts --githubPages false"
   },
   "engines": {
-    "node": ">=12",
-    "npm": ">=6"
+    "node": ">=18"
   },
   "bin": {
     "scjss-deploy": "./dist/cjs/bin/deploy.js",
@@ -33,7 +32,8 @@
     "url": "https://github.com/sitecore/jss/issues"
   },
   "dependencies": {
-    "@sitecore-jss/sitecore-jss": "^22.0.0-canary.9",
+    "@babel/parser": "^7.24.0",
+    "@sitecore-jss/sitecore-jss": "^22.1.0-canary.2",
     "axios": "^1.3.2",
     "chalk": "^4.1.2",
     "chokidar": "^3.5.3",
@@ -48,6 +48,7 @@
     "jszip": "^3.10.1",
     "module-alias": "^2.2.2",
     "readline-sync": "^1.4.10",
+    "recast": "^0.23.5",
     "resolve": "^1.22.1",
     "ts-node": "^10.9.1",
     "url-join": "^4.0.1",
@@ -55,6 +56,8 @@
     "yargs": "^17.6.2"
   },
   "devDependencies": {
+    "@babel/core": "^7.24.4",
+    "@babel/register": "^7.23.7",
     "@types/chai": "^4.3.4",
     "@types/chokidar": "^2.1.3",
     "@types/del": "^4.0.0",
@@ -70,7 +73,6 @@
     "@types/url-join": "^4.0.1",
     "@types/uuid": "^9.0.0",
     "@types/yargs": "^17.0.22",
-    "babel-core": "^6.26.3",
     "chai": "^4.3.7",
     "cross-env": "^7.0.3",
     "del-cli": "^5.0.0",
@@ -84,9 +86,11 @@
     "typescript": "~4.9.5"
   },
   "types": "types/index.d.ts",
-  "gitHead": "f28c2255e8bc93787848a7778b6a32355590e7b4",
+  "gitHead": "2b1c20b7ab1f2bc95bc9e363a944a12bac7363f1",
   "files": [
     "dist",
-    "types"
+    "types",
+    "/*.js",
+    "/*.d.ts"
   ]
 }

package/react.d.ts

@@ -0,0 +1 @@
+export * from './types/templating/react/index';

package/react.js

@@ -0,0 +1,3 @@
+const templating = require('./dist/cjs/templating/react/index');
+
+module.exports = { ...templating };

package/types/index.d.ts

@@ -13,7 +13,8 @@ export { createDisconnectedDictionaryService, DisconnectedDictionaryServiceOptio
 export { createDefaultDocumentMiddleware, DefaultDocumentMiddlewareOptions, } from './disconnected-server/default-document';
 export { createDefaultDisconnectedServer, DisconnectedServerOptions, } from './disconnected-server/create-default-disconnected-server';
 export { ScJssConfig, JssConfiguration, resolveScJssConfig } from './resolve-scjssconfig';
-export { strip } from './templating/strip';
+export { Metadata } from '@sitecore-jss/sitecore-jss/utils';
+export * from './templating';
 export * from './manifest';
 export * from './pipelines';
 export * from './update';

package/types/templating/components.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Describes a file that represents a component definition
+ */
+export interface ComponentFile {
+    path: string;
+    moduleName: string;
+    componentName: string;
+}
+/**
+ * Describes a package and components to be imported
+ */
+export interface PackageDefinition {
+    name: string;
+    components: {
+        moduleName: string;
+        componentName: string;
+    }[];
+}
+/**
+ * Get list of components from @var path
+ * Returns a list of components in the following format:
+ * {
+ *  path: 'path/to/component',
+ *  componentName: 'ComponentName',
+ *  moduleName: 'ComponentName'
+ * }
+ * @param {string} path path to search
+ */
+export declare function getComponentList(path: string): ComponentFile[];

package/types/templating/index.d.ts

@@ -0,0 +1,5 @@
+export { ComponentFile, PackageDefinition, getComponentList } from './components';
+export { PluginDefinition, generatePlugins, ModuleType } from './plugins';
+export { scaffoldFile } from './scaffold';
+export { strip } from './strip';
+export { getMetadata } from './metadata';

package/types/templating/metadata.d.ts

@@ -0,0 +1,5 @@
+import { Metadata } from '@sitecore-jss/sitecore-jss/utils';
+/**
+ * Get application metadata
+ */
+export declare function getMetadata(): Metadata;

package/types/templating/nextjs/component-props.loader.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Webpack loader to strip functions from the source code
+ * Strips the `getServerSideProps` and `getStaticProps` functions from the source code
+ * @param {string} source file source code
+ * @returns {string} output file source code with stripped functions
+ */
+export default function componentPropsLoader(source: string): string;

package/types/templating/nextjs/generate-component-builder.d.ts

@@ -0,0 +1,45 @@
+import { ComponentFile, PackageDefinition } from '../components';
+/**
+ * Generate component builder based on provided settings
+ * @param {Object} [settings] settings for component builder generation
+ * @param {string} [settings.componentRootPath] path to components root
+ * @param {string} [settings.componentBuilderOutputPath] path to component builder output
+ * @param {PackageDefinition[]} [settings.packages] list of packages to include in component builder
+ * @param {ComponentFile[]} [settings.components] list of components to include in component builder
+ * @param {boolean} [settings.watch] whether to watch for changes to component builder sources
+ */
+export declare function generateComponentBuilder({ componentRootPath, componentBuilderOutputPath, packages, components, watch, }?: {
+    componentRootPath?: string;
+    componentBuilderOutputPath?: string;
+    packages?: PackageDefinition[];
+    components?: ComponentFile[];
+    watch?: boolean;
+}): void;
+/**
+ * Watch for changes to component builder sources
+ * @param {Object} settings settings for component builder generation
+ * @param {string} settings.componentRootPath path to components root
+ * @param {string} settings.componentBuilderOutputPath path to component builder output
+ * @param {PackageDefinition[]} settings.packages list of packages to include in component builder
+ * @param {ComponentFile[]} settings.components list of components to include in component builder
+ */
+export declare function watchComponentBuilder({ componentRootPath, componentBuilderOutputPath, packages, components, }: {
+    componentRootPath: string;
+    componentBuilderOutputPath: string;
+    packages: PackageDefinition[];
+    components: ComponentFile[];
+}): void;
+/**
+ * Write component builder to file
+ * @param {Object} settings settings for component builder generation
+ * @param {string} settings.componentRootPath path to components root
+ * @param {string} settings.componentBuilderOutputPath path to component builder output
+ * @param {PackageDefinition[]} settings.packages list of packages to include in component builder
+ * @param {ComponentFile[]} settings.components list of components to include in component builder
+ */
+export declare function writeComponentBuilder({ componentRootPath, componentBuilderOutputPath, packages, components, }: {
+    componentRootPath: string;
+    componentBuilderOutputPath: string;
+    packages: PackageDefinition[];
+    components: ComponentFile[];
+}): void;

package/types/templating/nextjs/index.d.ts

@@ -0,0 +1,2 @@
+export { generateComponentBuilder } from './generate-component-builder';
+export { getComponentBuilderTemplate } from './templates/component-builder';

package/types/templating/nextjs/templates/component-builder.d.ts

@@ -0,0 +1,7 @@
+import { ComponentFile, PackageDefinition } from '../../components';
+/**
+ * Generate component builder template
+ * @param {(PackageDefinition | ComponentFile)[]} components components to include in component builder
+ * @returns generated component builder template
+ */
+export declare const getComponentBuilderTemplate: (components: (PackageDefinition | ComponentFile)[]) => string;

package/types/templating/plugins.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Identifies the format of the module to be compiled
+ */
+export declare enum ModuleType {
+    CJS = 0,
+    ESM = 1
+}
+/**
+ * Type to specify plugin file details
+ */
+export interface PluginFile {
+    path: string;
+    name: string;
+}
+/**
+ * Definition to be used for plugin registration during bootstrap
+ */
+export interface PluginDefinition {
+    /**
+     * destination path to compile plugins to
+     */
+    distPath: string;
+    /**
+     * source path for where the plugins are defined
+     */
+    rootPath: string;
+    /**
+     * CJS or ESM - which type to compile plugins to
+     */
+    moduleType: ModuleType;
+    /**
+     * whether to use relative or absolute paths in the generated file. By default, absolute paths are used.
+     */
+    relative?: boolean;
+    /**
+     * whether to suppress console output
+     */
+    silent?: boolean;
+}
+/**
+ * Get list of plugins from @var path
+ * Returns a list of plugins in the following format:
+ * {
+ *   path: 'path/to/plugin/foo',
+ *   name: 'fooPlugin'
+ * }
+ * @example getPluginList('src/foo/plugins', 'Foo')
+ * @param {Object} definition plugin definition
+ * @param {string} definition.path path to get plugin from
+ * @param {string} definition.pluginName plugin name
+ * @param {boolean} [definition.silent] whether to suppress console output
+ */
+export declare function getPluginList({ path, pluginName, silent, }: {
+    path: string;
+    pluginName: string;
+    silent?: boolean;
+}): PluginFile[];
+/**
+ * Generates the plugins file and saves it to the filesystem.
+ * By convention, we expect to find plugins under {pluginName}/plugins/** (subfolders are searched recursively).
+ * generated file will be saved to @var {distPath} and will contain a list of plugins in the following format:
+ * CJS: exports.fooPlugin = require('{pluginPath}');
+ * ESM: export { fooPlugin } from '{pluginPath}';
+ * @example generatePlugins({ distPath: 'src/temp/foo-plugins.js', rootPath: 'src/foo/plugins', moduleType: ModuleType.CJS })
+ * @param {PluginDefinition} definition plugin definition
+ */
+export declare function generatePlugins(definition: PluginDefinition): void;

package/types/templating/react/generate-component-builder.d.ts

@@ -0,0 +1,39 @@
+import { ComponentFile, PackageDefinition } from '../components';
+/**
+ * Generate component builder based on provided settings
+ * @param {Object} settings settings for component builder generation
+ * @param {string} settings.componentRootPath path to components root
+ * @param {PackageDefinition[]} [settings.packages] list of packages to include in component builder
+ * @param {ComponentFile[]} [settings.components] list of components to include in component builder
+ * @param {boolean} settings.watch whether to watch for changes to component builder sources
+ */
+export declare function generateComponentBuilder({ componentRootPath, packages, components, watch, }: {
+    componentRootPath?: string;
+    packages?: PackageDefinition[];
+    components?: ComponentFile[];
+    watch?: boolean;
+}): void;
+/**
+ * Watch for changes to component builder sources
+ * @param {object} config configuration for component builder watcher
+ * @param {string} config.componentRootPath root path to components
+ * @param {PackageDefinition[]} config.packages packages to include in component builder
+ * @param {ComponentFile[]} config.components components to include in component builder
+ */
+export declare function watchComponentBuilder({ componentRootPath, packages, components, }: {
+    componentRootPath: string;
+    packages: PackageDefinition[];
+    components: ComponentFile[];
+}): void;
+/**
+ * Write component builder to file
+ * @param {Object} settings settings for component builder generation
+ * @param {string} settings.componentRootPath root path to components
+ * @param {PackageDefinition[]} settings.packages packages to include in component builder
+ * @param {ComponentFile[]} settings.components list of components to include in component builder
+ */
+export declare function writeComponentBuilder({ componentRootPath, packages, components, }: {
+    componentRootPath: string;
+    packages: PackageDefinition[];
+    components: ComponentFile[];
+}): void;

package/types/templating/react/index.d.ts

@@ -0,0 +1,2 @@
+export { getComponentBuilderTemplate } from './templates/component-builder';
+export { generateComponentBuilder } from './generate-component-builder';

package/types/templating/react/templates/component-builder.d.ts

@@ -0,0 +1,8 @@
+import { ComponentFile, PackageDefinition } from '../../components';
+/**
+ * Generate component builder template
+ * @param {(PackageDefinition | ComponentFile)[]} components components to include in component builder
+ * @param {string} distPath destination path for component builder
+ * @returns generated component builder template
+ */
+export declare const getComponentBuilderTemplate: (components: (PackageDefinition | ComponentFile)[], distPath: string) => string;

package/types/templating/scaffold.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Force to use `crlf` line endings, we are using `crlf` across the project.
+ * Replace: `lf` (\n), `cr` (\r)
+ * @param {string} content
+ */
+export declare function editLineEndings(content: string): string;
+/**
+ * Creates a file relative to the specified path if the file doesn't exist.
+ * Creates directories as needed.
+ * Does not overwrite existing files.
+ * @param {string} filePath - the file path
+ * @param {string} fileContent - the file content
+ * @returns {string} the file path if the file was created, otherwise null
+ */
+export declare function scaffoldFile(filePath: string, fileContent: string): string | null;

package/types/templating/utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Settings for @var getItems function
+ */
+export type GetItemsSettings<Item> = {
+    /**
+     * items path
+     */
+    path: string;
+    /**
+     * Resolve item in required data format
+     */
+    resolveItem: (path: string, name: string) => Item;
+    /**
+     * Will be called when new file is found
+     */
+    cb?: (name: string) => void;
+    /**
+     * Matches specific files format
+     */
+    fileFormat?: RegExp;
+    /**
+     * Wether to search recursively
+     */
+    recursive?: boolean;
+};
+/**
+ * Using @var path find all files and generate output using @var resolveItem function for each file
+ * Can be used to generate list of components, templates, etc.
+ * @param {GetItemsSettings} settings
+ * @returns {Item[]} list of items
+ */
+export declare function getItems<Item>(settings: GetItemsSettings<Item>): Item[];
+/**
+ * Run watch mode, watching on @var paths
+ * @param {string[]} paths paths to watch by chokidar
+ * @param {Function<void>} cb callback to run on file change
+ */
+export declare function watchItems(paths: string[], cb: () => void): void;