@atlaskit/codemod-utils 4.1.1 → 4.1.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @atlaskit/codemod-utils
 
+## 4.1.3
+
+### Patch Changes
+
+- [`8cc2f888c83`](https://bitbucket.org/atlassian/atlassian-frontend/commits/8cc2f888c83) - Upgrade Typescript from `4.3.5` to `4.5.5`
+
+## 4.1.2
+
+### Patch Changes
+
+- [`8d4228767b0`](https://bitbucket.org/atlassian/atlassian-frontend/commits/8d4228767b0) - Upgrade Typescript from `4.2.4` to `4.3.5`.
+
 ## 4.1.1
 
 ### Patch Changes

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/codemod-utils",
-	"version": "4.1.1",
+	"version": "4.1.3",
 	"sideEffects": false
 }

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/codemod-utils",
-	"version": "4.1.1",
+	"version": "4.1.3",
 	"sideEffects": false
 }

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/codemod-utils",
-	"version": "4.1.1",
+	"version": "4.1.3",
 	"sideEffects": false
 }

package/dist/types-ts4.0/index.d.ts

@@ -0,0 +1,2 @@
+export { createRenameFuncFor, createConvertFuncFor, createRenameImportFor, createRemoveFuncFor, replaceImportStatementFor, elevateComponentToNewEntryPoint, createTransformer, renameNamedImportWithAliasName, flattenCertainChildPropsAsProp, createRenameJSXFunc, createRemoveFuncAddCommentFor, changeImportEntryPoint, } from './utils';
+export { getDefaultSpecifier, getNamedSpecifier, getJSXAttributesByName, hasJSXAttributesByName, doesIdentifierExist, hasImportDeclaration, hasImportDeclarationFromAnyPackageEntrypoint, addCommentBefore, addCommentToStartOfFile, callExpressionArgMatchesString, testMethodVariantEach, getSafeImportName, removeImport, getDynamicImportName, addDynamicImport, tryCreateImport, addToImport, } from './utils/support';

package/dist/types-ts4.0/utils/index.d.ts

@@ -0,0 +1,15 @@
+import core, { API, ASTPath, FileInfo, Options } from 'jscodeshift';
+import { Collection } from 'jscodeshift/src/Collection';
+declare const createRemoveFuncFor: (component: string, importName: string, prop: string, predicate?: (j: core.JSCodeshift, element: ASTPath<any>) => boolean, comment?: string | undefined) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const createRenameFuncFor: (component: string, from: string, to: string) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const createConvertFuncFor: (component: string, from: string, to: string, predicate?: ((value: any) => boolean) | undefined) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const replaceImportStatementFor: (pkg: string, convertMap: any) => (j: core.JSCodeshift, root: Collection<Node>) => void;
+declare const createRenameImportFor: (component: string, from: string, to: string) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const createTransformer: (migrates: ((j: core.JSCodeshift, source: Collection<Node>) => void)[], shouldApplyTransform?: ((j: core.JSCodeshift, source: Collection<Node>) => boolean) | undefined) => (fileInfo: FileInfo, { jscodeshift: j }: API, options: Options) => string;
+declare const elevateComponentToNewEntryPoint: (pkg: string, toPkg: string, innerElementName: string) => (j: core.JSCodeshift, root: any) => void;
+declare const flattenCertainChildPropsAsProp: (component: string, propName: string, childProps: string[]) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const createRenameJSXFunc: (packagePath: string, from: string, to: string, fallback?: string | undefined) => (j: core.JSCodeshift, source: any) => void;
+declare const createRemoveFuncAddCommentFor: (component: string, prop: string, comment?: string | undefined) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const renameNamedImportWithAliasName: (component: string, from: string, to: string) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+declare const changeImportEntryPoint: (oldPackageName: string, importToConvert: string, newPackageName: string, shouldBeTypeImport?: boolean | undefined) => (j: core.JSCodeshift, root: Collection<Node>) => void;
+export { createRenameFuncFor, createConvertFuncFor, createRenameImportFor, createRemoveFuncFor, replaceImportStatementFor, elevateComponentToNewEntryPoint, createTransformer, renameNamedImportWithAliasName, flattenCertainChildPropsAsProp, createRenameJSXFunc, createRemoveFuncAddCommentFor, changeImportEntryPoint, };

package/dist/types-ts4.0/utils/support.d.ts

@@ -0,0 +1,47 @@
+import core, { ASTPath, CallExpression, ImportDeclaration, ImportDefaultSpecifier, ImportSpecifier, JSXAttribute, JSXElement, Program, VariableDeclaration, VariableDeclarator } from 'jscodeshift';
+import { Collection } from 'jscodeshift/src/Collection';
+declare function getNamedSpecifier(j: core.JSCodeshift, source: Collection<Node>, specifier: string, importName: string): string | null;
+declare const getDynamicImportName: (j: core.JSCodeshift, source: Collection<any>, importPath: string) => string | null;
+declare const addDynamicImport: (j: core.JSCodeshift, target: Collection<VariableDeclaration>, name: string, packageEndpoint: string) => void;
+declare function clean(value: string): string;
+declare const addCommentToStartOfFile: ({ j, base, message, }: {
+    j: core.JSCodeshift;
+    base: Collection<Node>;
+    message: string;
+}) => void;
+declare function addCommentBefore(j: core.JSCodeshift, target: Collection<Program> | Collection<ImportDeclaration> | Collection<JSXElement> | Collection<JSXAttribute> | Collection<CallExpression> | Collection<VariableDeclarator>, message: string, commentType?: 'block' | 'line', messagePrefix?: string): void;
+declare const getDefaultSpecifier: (j: core.JSCodeshift, source: Collection<Node>, specifier: string) => string | null;
+declare const getJSXAttributesByName: (j: core.JSCodeshift, element: ASTPath<any>, attributeName: string) => Collection<JSXAttribute>;
+declare const isEmpty: any;
+declare const hasImportDeclaration: (j: core.JSCodeshift, source: Collection<Node>, importPath: string) => boolean;
+declare const hasImportDeclarationFromAnyPackageEntrypoint: (j: core.JSCodeshift, source: Collection<Node>, packageName: string) => boolean;
+declare const debug: (component: string) => (j: core.JSCodeshift, source: Collection<Node>) => void;
+export declare function placeholderStringMatches(placeholderStr: string, resolvedStr: string): boolean;
+/**
+ * Check whether a value contains a Format Specifier (printf placeholder)
+ *
+ * @see https://jestjs.io/docs/api#testeachtablename-fn-timeout
+ * @see https://nodejs.org/api/util.html#utilformatformat-args
+ *
+ * @param argValue The string potentially containing a format specifier (e.g. 'Foo %s')
+ * @param str The string that has replaced a format specifier with a tangible value (e.g. 'Foo Bar`)
+ *
+ * @returns Boolean: True if the strings matched (after considering the placeholder), or false if not.
+ */
+export declare function matchesStringWithFormatSpecifier(argValue: string | number | boolean | RegExp | null, str: string): boolean;
+declare const callExpressionArgMatchesString: (arg: CallExpression['arguments'][number], str: string) => boolean;
+declare const testMethodVariantEach: (path: ASTPath<CallExpression>, testMethods: Set<string>) => boolean;
+declare const hasJSXAttributesByName: (j: core.JSCodeshift, element: ASTPath<any>, attributeName: string) => boolean;
+declare const doesIdentifierExist: (j: core.JSCodeshift, base: Collection<any>, name: string) => boolean;
+declare function removeImport(j: core.JSCodeshift, base: Collection<any>, packageName: string): void;
+declare function tryCreateImport(j: core.JSCodeshift, base: Collection<any>, relativeToPackage: string, packageName: string, shouldBeTypeImport?: boolean): void;
+declare function addToImport(j: core.JSCodeshift, base: Collection<any>, importSpecifier: ImportSpecifier | ImportDefaultSpecifier, packageName: string): void;
+declare const shiftDefaultImport: (j: core.JSCodeshift, base: Collection<any>, defaultName: string, oldPackagePath: string, newPackagePath: string) => void;
+declare function getSafeImportName({ j, base, currentDefaultSpecifierName, desiredName, fallbackName, }: {
+    j: core.JSCodeshift;
+    base: Collection<any>;
+    currentDefaultSpecifierName: string | null;
+    desiredName: string;
+    fallbackName: string;
+}): string;
+export { getDefaultSpecifier, getNamedSpecifier, getJSXAttributesByName, hasJSXAttributesByName, hasImportDeclaration, hasImportDeclarationFromAnyPackageEntrypoint, addCommentBefore, addCommentToStartOfFile, doesIdentifierExist, removeImport, tryCreateImport, addToImport, shiftDefaultImport, isEmpty, clean, debug, callExpressionArgMatchesString, testMethodVariantEach, getSafeImportName, getDynamicImportName, addDynamicImport, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/codemod-utils",
-  "version": "4.1.1",
+  "version": "4.1.3",
   "author": "Atlassian Pty Ltd",
   "license": "Apache-2.0",
   "description": " jscodeshift-compatible codemod utilities",
@@ -17,6 +17,13 @@
   "module": "dist/esm/index.js",
   "module:es2019": "dist/es2019/index.js",
   "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    ">=4.0 <4.5": {
+      "*": [
+        "dist/types-ts4.0/*"
+      ]
+    }
+  },
   "sideEffects": false,
   "atlaskit:src": "src/index.ts",
   "af:exports": {
@@ -30,7 +37,7 @@
     "@atlassian/atlassian-frontend-prettier-config-1.0.0": "npm:@atlassian/atlassian-frontend-prettier-config@1.0.0",
     "@types/jscodeshift": "^0.11.0",
     "jscodeshift": "^0.13.0",
-    "typescript": "4.2.4"
+    "typescript": "4.5.5"
   },
   "techstack": {
     "@atlassian/frontend": {

package/report.api.md

@@ -2,6 +2,12 @@
 
 > Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
 
+<!--
+	Generated API Report version: 2.0
+-->
+
+[Learn more about API reports](https://hello.atlassian.net/wiki/spaces/UR/pages/1825484529/Package+API+Reports)
+
 ```ts
 import { API } from 'jscodeshift';
 import { ASTPath } from 'jscodeshift';
@@ -19,7 +25,8 @@ import { Program } from 'jscodeshift';
 import { VariableDeclaration } from 'jscodeshift';
 import { VariableDeclarator } from 'jscodeshift';
 
-export declare function addCommentBefore(
+// @public (undocumented)
+export function addCommentBefore(
   j: core.JSCodeshift,
   target:
     | Collection<Program>
@@ -33,7 +40,8 @@ export declare function addCommentBefore(
   messagePrefix?: string,
 ): void;
 
-export declare const addCommentToStartOfFile: ({
+// @public (undocumented)
+export const addCommentToStartOfFile: ({
   j,
   base,
   message,
@@ -43,46 +51,53 @@ export declare const addCommentToStartOfFile: ({
   message: string;
 }) => void;
 
-export declare const addDynamicImport: (
+// @public (undocumented)
+export const addDynamicImport: (
   j: core.JSCodeshift,
   target: Collection<VariableDeclaration>,
   name: string,
   packageEndpoint: string,
 ) => void;
 
-export declare function addToImport(
+// @public (undocumented)
+export function addToImport(
   j: core.JSCodeshift,
   base: Collection<any>,
   importSpecifier: ImportSpecifier | ImportDefaultSpecifier,
   packageName: string,
 ): void;
 
-export declare const callExpressionArgMatchesString: (
+// @public (undocumented)
+export const callExpressionArgMatchesString: (
   arg: CallExpression['arguments'][number],
   str: string,
 ) => boolean;
 
-export declare const changeImportEntryPoint: (
+// @public (undocumented)
+export const changeImportEntryPoint: (
   oldPackageName: string,
   importToConvert: string,
   newPackageName: string,
   shouldBeTypeImport?: boolean | undefined,
 ) => (j: core.JSCodeshift, root: Collection<Node>) => void;
 
-export declare const createConvertFuncFor: (
+// @public (undocumented)
+export const createConvertFuncFor: (
   component: string,
   from: string,
   to: string,
   predicate?: ((value: any) => boolean) | undefined,
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const createRemoveFuncAddCommentFor: (
+// @public (undocumented)
+export const createRemoveFuncAddCommentFor: (
   component: string,
   prop: string,
   comment?: string | undefined,
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const createRemoveFuncFor: (
+// @public (undocumented)
+export const createRemoveFuncFor: (
   component: string,
   importName: string,
   prop: string,
@@ -90,76 +105,88 @@ export declare const createRemoveFuncFor: (
   comment?: string | undefined,
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const createRenameFuncFor: (
+// @public (undocumented)
+export const createRenameFuncFor: (
   component: string,
   from: string,
   to: string,
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const createRenameImportFor: (
+// @public (undocumented)
+export const createRenameImportFor: (
   component: string,
   from: string,
   to: string,
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const createRenameJSXFunc: (
+// @public (undocumented)
+export const createRenameJSXFunc: (
   packagePath: string,
   from: string,
   to: string,
   fallback?: string | undefined,
 ) => (j: core.JSCodeshift, source: any) => void;
 
-export declare const createTransformer: (
+// @public (undocumented)
+export const createTransformer: (
   migrates: ((j: core.JSCodeshift, source: Collection<Node>) => void)[],
   shouldApplyTransform?:
     | ((j: core.JSCodeshift, source: Collection<Node>) => boolean)
     | undefined,
 ) => (fileInfo: FileInfo, { jscodeshift: j }: API, options: Options) => string;
 
-export declare const doesIdentifierExist: (
+// @public (undocumented)
+export const doesIdentifierExist: (
   j: core.JSCodeshift,
   base: Collection<any>,
   name: string,
 ) => boolean;
 
-export declare const elevateComponentToNewEntryPoint: (
+// @public (undocumented)
+export const elevateComponentToNewEntryPoint: (
   pkg: string,
   toPkg: string,
   innerElementName: string,
 ) => (j: core.JSCodeshift, root: any) => void;
 
-export declare const flattenCertainChildPropsAsProp: (
+// @public (undocumented)
+export const flattenCertainChildPropsAsProp: (
   component: string,
   propName: string,
   childProps: string[],
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const getDefaultSpecifier: (
+// @public (undocumented)
+export const getDefaultSpecifier: (
   j: core.JSCodeshift,
   source: Collection<Node>,
   specifier: string,
 ) => string | null;
 
-export declare const getDynamicImportName: (
+// @public (undocumented)
+export const getDynamicImportName: (
   j: core.JSCodeshift,
   source: Collection<any>,
   importPath: string,
 ) => string | null;
 
-export declare const getJSXAttributesByName: (
+// @public (undocumented)
+export const getJSXAttributesByName: (
   j: core.JSCodeshift,
   element: ASTPath<any>,
   attributeName: string,
 ) => Collection<JSXAttribute>;
 
-export declare function getNamedSpecifier(
+// @public (undocumented)
+export function getNamedSpecifier(
   j: core.JSCodeshift,
   source: Collection<Node>,
   specifier: string,
   importName: string,
 ): string | null;
 
-export declare function getSafeImportName({
+// @public (undocumented)
+export function getSafeImportName({
   j,
   base,
   currentDefaultSpecifierName,
@@ -173,47 +200,55 @@ export declare function getSafeImportName({
   fallbackName: string;
 }): string;
 
-export declare const hasImportDeclaration: (
+// @public (undocumented)
+export const hasImportDeclaration: (
   j: core.JSCodeshift,
   source: Collection<Node>,
   importPath: string,
 ) => boolean;
 
-export declare const hasImportDeclarationFromAnyPackageEntrypoint: (
+// @public (undocumented)
+export const hasImportDeclarationFromAnyPackageEntrypoint: (
   j: core.JSCodeshift,
   source: Collection<Node>,
   packageName: string,
 ) => boolean;
 
-export declare const hasJSXAttributesByName: (
+// @public (undocumented)
+export const hasJSXAttributesByName: (
   j: core.JSCodeshift,
   element: ASTPath<any>,
   attributeName: string,
 ) => boolean;
 
-export declare function removeImport(
+// @public (undocumented)
+export function removeImport(
   j: core.JSCodeshift,
   base: Collection<any>,
   packageName: string,
 ): void;
 
-export declare const renameNamedImportWithAliasName: (
+// @public (undocumented)
+export const renameNamedImportWithAliasName: (
   component: string,
   from: string,
   to: string,
 ) => (j: core.JSCodeshift, source: Collection<Node>) => void;
 
-export declare const replaceImportStatementFor: (
+// @public (undocumented)
+export const replaceImportStatementFor: (
   pkg: string,
   convertMap: any,
 ) => (j: core.JSCodeshift, root: Collection<Node>) => void;
 
-export declare const testMethodVariantEach: (
+// @public (undocumented)
+export const testMethodVariantEach: (
   path: ASTPath<CallExpression>,
   testMethods: Set<string>,
 ) => boolean;
 
-export declare function tryCreateImport(
+// @public (undocumented)
+export function tryCreateImport(
   j: core.JSCodeshift,
   base: Collection<any>,
   relativeToPackage: string,
@@ -221,5 +256,5 @@ export declare function tryCreateImport(
   shouldBeTypeImport?: boolean,
 ): void;
 
-export {};
+// (No @packageDocumentation comment for this package)
 ```