path-to-prop 0.0.3 → 2.0.0

package/README.md

@@ -1,19 +1,37 @@
 # Path to prop 🛤
 
+<a href="https://www.npmjs.com/package/path-to-prop"><img src="https://img.shields.io/npm/v/path-to-prop.svg" alt="Total Downloads"></a>
+<a href="https://www.npmjs.com/package/path-to-prop"><img src="https://img.shields.io/npm/dw/path-to-prop.svg" alt="Latest Stable Version"></a>
+
 ```
 npm i path-to-prop
 ```
 
-Retrieves a property from an object based on a path.to.that.prop
+Retrieves a property from an object based on a `'path/to.that.prop'`
+
+- Supports paths with both `/` and `.` to separate props
+- Safely typed (with TypeScript) - returns `unknown`
 
 ## Usage
 
 ```js
-import pathToProp from 'path-to-prop'
+import { getProp } from 'path-to-prop'
 
 const target = {a: {b: {c: {d: {e: 1}}}}}
-const path = 'a.b.c.d.e'
+const path = 'a/b/c.d.e'
+
+getProp(target, path)
+  // returns 1
+
+getProp(target, 'nonexistent.prop')
+  // returns undefined
+```
+
+When you have `/` or `.` in your prop names, use an array:
+
+```js
+const target = {'a/b': {'c.d': 1}}
 
-pathToProp(target, path)
+getProp(target, ['a/b', 'c.d'])
   // returns 1
 ```

package/dist/index.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * Returns the keys of a path
+ *
+ * @param   {string} path   a/path/like.this
+ * @returns {string[]} with keys
+ */
+function getKeysFromPath(path) {
+    return path.split ? path.split(/\.|\//) : path;
+}
+/**
+ * Gets a deep property in an object, based on a path to that property. Pass the path as array when you have prop names with `.` or `/` in them
+ *
+ * @param {Record<string, unknown>} obj an object to wherefrom to retrieve the deep reference of
+ * @param {string | string[]} path 'path/to.prop' or ['path', 'to', 'prop']
+ * @returns {unknown} the last prop in the path
+ */
+function pathToProp(obj, path) {
+    const keys = getKeysFromPath(path);
+    let p;
+    for (p = 0; p < keys.length; p++) {
+        obj = (obj ? obj[keys[p]] : undefined);
+    }
+    return obj === undefined ? undefined : obj;
+}
+const getProp = pathToProp;
+
+exports.getKeysFromPath = getKeysFromPath;
+exports.getProp = getProp;
+exports.pathToProp = pathToProp;

package/dist/index.es.js

@@ -0,0 +1,27 @@
+/**
+ * Returns the keys of a path
+ *
+ * @param   {string} path   a/path/like.this
+ * @returns {string[]} with keys
+ */
+function getKeysFromPath(path) {
+    return path.split ? path.split(/\.|\//) : path;
+}
+/**
+ * Gets a deep property in an object, based on a path to that property. Pass the path as array when you have prop names with `.` or `/` in them
+ *
+ * @param {Record<string, unknown>} obj an object to wherefrom to retrieve the deep reference of
+ * @param {string | string[]} path 'path/to.prop' or ['path', 'to', 'prop']
+ * @returns {unknown} the last prop in the path
+ */
+function pathToProp(obj, path) {
+    const keys = getKeysFromPath(path);
+    let p;
+    for (p = 0; p < keys.length; p++) {
+        obj = (obj ? obj[keys[p]] : undefined);
+    }
+    return obj === undefined ? undefined : obj;
+}
+const getProp = pathToProp;
+
+export { getKeysFromPath, getProp, pathToProp };

package/dist/types/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Returns the keys of a path
+ *
+ * @param   {string} path   a/path/like.this
+ * @returns {string[]} with keys
+ */
+export declare function getKeysFromPath(path: string | string[]): string[];
+/**
+ * Gets a deep property in an object, based on a path to that property. Pass the path as array when you have prop names with `.` or `/` in them
+ *
+ * @param {Record<string, unknown>} obj an object to wherefrom to retrieve the deep reference of
+ * @param {string | string[]} path 'path/to.prop' or ['path', 'to', 'prop']
+ * @returns {unknown} the last prop in the path
+ */
+export declare function pathToProp(obj: Record<string, unknown>, path: string | string[]): unknown;
+export declare const getProp: typeof pathToProp;

package/package.json

@@ -1,33 +1,63 @@
 {
   "name": "path-to-prop",
-  "version": "0.0.3",
+  "version": "2.0.0",
   "sideEffects": false,
-  "description": "Retrieves a property from an object based on a path.to.that.prop",
-  "main": "dist/index.cjs.js",
-  "module": "dist/index.esm.js",
-  "typings": "types/index.d.ts",
+  "type": "module",
+  "description": "Retrieves a property from an object based on a 'path/to.that.prop'",
+  "module": "./dist/index.es.js",
+  "main": "./dist/index.cjs",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.es.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/types/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=12.13",
+    "npm": ">=7"
+  },
   "scripts": {
-    "test": "ava --verbose",
-    "build": "npm run lint && npm run test && npm run rollup",
-    "lint": "eslint . --ext .js,.jsx,.ts,.tsx",
-    "rollup": "rollup -c build/rollup.js"
+    "test": "vitest run",
+    "lint": "tsc --noEmit && eslint ./src --ext .ts",
+    "build": "rollup -c ./scripts/build.js",
+    "release": "npm run lint && del dist && npm run build && np"
   },
-  "keywords": ["path-to-prop"],
+  "keywords": [
+    "path-to-prop",
+    "dot-prop",
+    "dotprop",
+    "propdot",
+    "dot-notation",
+    "dotnotation-prop",
+    "delve",
+    "prop-at-path",
+    "get-prop-at-path",
+    "get-property-at-path",
+    "get-dot-prop",
+    "get-dot-property"
+  ],
   "author": "Luca Ban - Mesqueeb",
+  "funding": "https://github.com/sponsors/mesqueeb",
   "license": "MIT",
   "homepage": "https://github.com/mesqueeb/path-to-prop#readme",
-  "dependencies": {},
   "devDependencies": {
-    "@typescript-eslint/eslint-plugin": "^2.28.0",
-    "@typescript-eslint/parser": "^2.28.0",
-    "ava": "^3.7.0",
-    "eslint": "^6.8.0",
-    "eslint-config-prettier": "^6.10.1",
-    "eslint-plugin-tree-shaking": "^1.8.0",
-    "rollup": "^2.6.1",
-    "rollup-plugin-typescript2": "^0.27.0",
-    "ts-node": "^8.8.2",
-    "typescript": "^3.8.3"
+    "@typescript-eslint/eslint-plugin": "^5.10.1",
+    "@typescript-eslint/parser": "^5.10.1",
+    "del-cli": "^4.0.1",
+    "eslint": "^8.7.0",
+    "eslint-config-prettier": "^8.3.0",
+    "eslint-plugin-tree-shaking": "^1.10.0",
+    "np": "^7.6.0",
+    "prettier": "^2.5.1",
+    "rollup": "^2.66.0",
+    "rollup-plugin-typescript2": "^0.31.1",
+    "typescript": "^4.5.5",
+    "vitest": "^0.2.1"
   },
   "bugs": {
     "url": "https://github.com/mesqueeb/path-to-prop/issues"
@@ -36,8 +66,35 @@
     "type": "git",
     "url": "git+https://github.com/mesqueeb/path-to-prop.git"
   },
-  "ava": {
-    "extensions": ["ts"],
-    "require": ["ts-node/register"]
+  "np": {
+    "yarn": false,
+    "branch": "production"
+  },
+  "eslintConfig": {
+    "ignorePatterns": [
+      "node_modules",
+      "dist",
+      "scripts",
+      "test"
+    ],
+    "root": true,
+    "parser": "@typescript-eslint/parser",
+    "plugins": [
+      "@typescript-eslint",
+      "tree-shaking"
+    ],
+    "extends": [
+      "eslint:recommended",
+      "plugin:@typescript-eslint/eslint-recommended",
+      "plugin:@typescript-eslint/recommended",
+      "prettier"
+    ],
+    "rules": {
+      "@typescript-eslint/no-empty-function": "off",
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/ban-ts-ignore": "off",
+      "tree-shaking/no-side-effects-in-initialization": "error",
+      "@typescript-eslint/ban-ts-comment": "off"
+    }
   }
 }

package/.eslintignore

@@ -1,8 +0,0 @@
-# don't ever lint node_modules
-node_modules
-# don't lint build output (make sure it's set to your correct build folder name)
-dist
-# don't lint nyc coverage output
-coverage
-
-test

package/.eslintrc.js

@@ -1,19 +0,0 @@
-// npm i -D @typescript-eslint/eslint-plugin @typescript-eslint/parser eslint eslint-config-prettier eslint-plugin-tree-shaking
-module.exports = {
-  root: true,
-  parser: '@typescript-eslint/parser',
-  plugins: ['@typescript-eslint', 'tree-shaking'],
-  extends: [
-    'eslint:recommended',
-    'plugin:@typescript-eslint/eslint-recommended',
-    'plugin:@typescript-eslint/recommended',
-    'prettier/@typescript-eslint',
-  ],
-  rules: {
-    '@typescript-eslint/no-explicit-any': 'off',
-    '@typescript-eslint/ban-ts-ignore': 'off',
-    'tree-shaking/no-side-effects-in-initialization': 'error',
-    'comma-dangle': ['error', 'always-multiline'],
-    'no-unused-vars': 'off',
-  },
-}

package/.github/FUNDING.yml

@@ -1,12 +0,0 @@
-# These are supported funding model platforms
-
-github: mesqueeb
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-otechie: # Replace with a single Otechie username
-custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

package/.prettierrc

@@ -1,9 +0,0 @@
-{
-  "printWidth": 100,
-  "tabWidth": 2,
-  "singleQuote": true,
-  "trailingComma": "es5",
-  "semi": false,
-  "bracketSpacing": true,
-  "quoteProps": "consistent"
-}

package/build/rollup.js

@@ -1,56 +0,0 @@
-/* eslint-disable */
-
-// npm install rollup-plugin-typescript2 typescript --save-dev
-import typescript from 'rollup-plugin-typescript2'
-// import { terser } from 'rollup-plugin-terser'
-// import resolve from 'rollup-plugin-node-resolve'
-
-// ------------------------------------------------------------------------------------------
-// formats
-// ------------------------------------------------------------------------------------------
-// amd – Asynchronous Module Definition, used with module loaders like RequireJS
-// cjs – CommonJS, suitable for Node and Browserify/Webpack
-// esm – Keep the bundle as an ES module file
-// iife – A self-executing function, suitable for inclusion as a <script> tag. (If you want to create a bundle for your application, you probably want to use this, because it leads to smaller file sizes.)
-// umd – Universal Module Definition, works as amd, cjs and iife all in one
-// system – Native format of the SystemJS loader
-
-// ------------------------------------------------------------------------------------------
-// setup
-// ------------------------------------------------------------------------------------------
-const pkg = require('../package.json')
-const name = pkg.name
-const className = name.replace(/(^\w|-\w)/g, c => c.replace('-', '').toUpperCase())
-const external = Object.keys(pkg.dependencies || [])
-const plugins = [
-  typescript({useTsconfigDeclarationDir: true}),
-]
-
-// ------------------------------------------------------------------------------------------
-// Builds
-// ------------------------------------------------------------------------------------------
-function defaults (config) {
-  // defaults
-  const defaults = {
-    plugins,
-    external
-  }
-  // defaults.output
-  config.output = config.output.map(output => {
-    return Object.assign({
-      sourcemap: false,
-      name: className,
-    }, output)
-  })
-  return Object.assign(defaults, config)
-}
-
-export default [
-  defaults({
-    input: 'src/index.ts',
-    output: [
-      {file: 'dist/index.cjs.js', format: 'cjs'},
-      {file: 'dist/index.esm.js', format: 'esm'},
-    ],
-  }),
-]

package/dist/index.cjs.js

@@ -1,40 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-/**
- * Returns the keys of a path
- *
- * @param   {string} path   a/path/like.this
- * @returns {string[]} with keys
- */
-function getKeysFromPath(path) {
-    if (!path)
-        return [];
-    // eslint-disable-next-line no-useless-escape
-    return path.match(/[^\/^\.]+/g);
-}
-/**
- * Gets a deep property in an object, based on a path to that property
- *
- * @param {object} target an object to wherefrom to retrieve the deep reference of
- * @param {string} path   'path/to.prop'
- * @returns {*} the last prop in the path
- */
-function pathToProp(target, path) {
-    var keys = getKeysFromPath(path);
-    if (!keys.length)
-        return target;
-    var obj = target;
-    while (obj && keys.length > 1) {
-        obj = obj[keys.shift()];
-    }
-    var key = keys.shift();
-    if (obj && obj.hasOwnProperty(key)) {
-        return obj[key];
-    }
-}
-
-exports.default = pathToProp;
-exports.getKeysFromPath = getKeysFromPath;
-exports.pathToProp = pathToProp;

package/dist/index.esm.js

@@ -1,35 +0,0 @@
-/**
- * Returns the keys of a path
- *
- * @param   {string} path   a/path/like.this
- * @returns {string[]} with keys
- */
-function getKeysFromPath(path) {
-    if (!path)
-        return [];
-    // eslint-disable-next-line no-useless-escape
-    return path.match(/[^\/^\.]+/g);
-}
-/**
- * Gets a deep property in an object, based on a path to that property
- *
- * @param {object} target an object to wherefrom to retrieve the deep reference of
- * @param {string} path   'path/to.prop'
- * @returns {*} the last prop in the path
- */
-function pathToProp(target, path) {
-    var keys = getKeysFromPath(path);
-    if (!keys.length)
-        return target;
-    var obj = target;
-    while (obj && keys.length > 1) {
-        obj = obj[keys.shift()];
-    }
-    var key = keys.shift();
-    if (obj && obj.hasOwnProperty(key)) {
-        return obj[key];
-    }
-}
-
-export default pathToProp;
-export { getKeysFromPath, pathToProp };

package/src/index.ts

@@ -1,33 +0,0 @@
-/**
- * Returns the keys of a path
- *
- * @param   {string} path   a/path/like.this
- * @returns {string[]} with keys
- */
-export function getKeysFromPath (path: string): string[] {
-  if (!path) return []
-  // eslint-disable-next-line no-useless-escape
-  return path.match(/[^\/^\.]+/g)
-}
-
-/**
- * Gets a deep property in an object, based on a path to that property
- *
- * @param {object} target an object to wherefrom to retrieve the deep reference of
- * @param {string} path   'path/to.prop'
- * @returns {*} the last prop in the path
- */
-export function pathToProp (target: object, path: string): any {
-  const keys = getKeysFromPath(path)
-  if (!keys.length) return target
-  let obj = target
-  while (obj && keys.length > 1) {
-    obj = obj[keys.shift()]
-  }
-  const key = keys.shift()
-  if (obj && Object.hasOwnProperty.call(obj, key)) {
-    return obj[key]
-  }
-}
-
-export default pathToProp

package/test/index.ts

@@ -1,24 +0,0 @@
-import test from 'ava'
-import pathToProp from '../src'
-
-test('test', t => {
-  const target = { a: { b: { c: { d: { e: 1 } } } } }
-  const res1 = pathToProp(target, 'a.b.c.d.e')
-  t.deepEqual(res1, 1)
-  const res2 = pathToProp(target, 'a.b.c.d')
-  t.deepEqual(res2, { e: 1 })
-  const res3 = pathToProp(target, 'a.b')
-  t.deepEqual(res3, { c: { d: { e: 1 } } })
-  const res4 = pathToProp(target, 'a')
-  t.deepEqual(res4, { b: { c: { d: { e: 1 } } } })
-})
-
-test('not an object', t => {
-  const path = 'a.b'
-  const res1 = pathToProp(null, path)
-  t.is(res1, undefined)
-  const res2 = pathToProp(new Date(), path)
-  t.is(res2, undefined)
-  const res3 = pathToProp(function () {}, path)
-  t.is(res3, undefined)
-})

package/tsconfig.json

@@ -1,9 +0,0 @@
-{
-  "compilerOptions": {
-    "declaration": true,
-    "declarationDir": "./types/"
-  },
-  "include": [
-    "src/**/*"
-  ]
-}

package/types/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * Returns the keys of a path
- *
- * @param   {string} path   a/path/like.this
- * @returns {string[]} with keys
- */
-export declare function getKeysFromPath(path: string): string[];
-/**
- * Gets a deep property in an object, based on a path to that property
- *
- * @param {object} target an object to wherefrom to retrieve the deep reference of
- * @param {string} path   'path/to.prop'
- * @returns {*} the last prop in the path
- */
-export declare function pathToProp(target: object, path: string): any;
-export default pathToProp;