@hamak/shared-utils 0.4.2 → 0.4.4

package/dist/core-utils-pathway.d.ts

@@ -81,4 +81,31 @@ export declare class Pathway {
     static asString(path: Path): string;
     static getName(path: string | string[] | Pathway): string;
 }
+/**
+ * Converts a path (string or string array) to an array of path segments.
+ * If already an array, returns it as-is.
+ * If a string, splits by '/' and filters out empty segments.
+ *
+ * @param path - The path to convert to segments
+ * @returns Array of path segments
+ *
+ * @example
+ * pathSteps('/foo/bar/baz') // ['foo', 'bar', 'baz']
+ * pathSteps(['foo', 'bar']) // ['foo', 'bar']
+ * pathSteps('foo//bar/') // ['foo', 'bar']
+ */
+export declare function pathSteps(path: string | string[]): string[];
+/**
+ * Returns the parent path segments by removing the last segment.
+ * Uses pathSteps internally to normalize the input path.
+ *
+ * @param path - The path to get parent segments from
+ * @returns Array of parent path segments (all but last segment)
+ *
+ * @example
+ * parentPathSteps('/foo/bar/baz') // ['foo', 'bar']
+ * parentPathSteps(['foo', 'bar']) // ['foo']
+ * parentPathSteps(['foo']) // []
+ */
+export declare function parentPathSteps(path: string | string[]): string[];
 //# sourceMappingURL=core-utils-pathway.d.ts.map

package/dist/core-utils-pathway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core-utils-pathway.d.ts","sourceRoot":"","sources":["../src/core-utils-pathway.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;AAC9C;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,cAAc,CAAU;IAEhC;;;;OAIG;gBACS,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS;IAUtD;;;;OAIG;WACW,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO;IAQ/E;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;OAGG;IACI,WAAW,IAAI,MAAM,EAAE;IAIvB,YAAY;IAInB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;OAGG;IACI,UAAU,IAAI,OAAO;IAI5B;;;OAGG;IACI,UAAU,IAAI,OAAO;IAI5B;;;;OAIG;IACI,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAuB/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAQ3B;;;OAGG;IACI,mBAAmB,IAAI,MAAM;IAOpC;;;OAGG;WACW,MAAM,IAAI,OAAO;IAI/B;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAsBlE;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAiBpE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAG,IAAI,GAAI,OAAO;IAK5C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,IAAI,GAAI,MAAM;IASrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;CAgBjD"}
+{"version":3,"file":"core-utils-pathway.d.ts","sourceRoot":"","sources":["../src/core-utils-pathway.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAA;AAC9C;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,cAAc,CAAU;IAEhC;;;;OAIG;gBACS,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS;IAUtD;;;;OAIG;WACW,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO;IAQ/E;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;OAGG;IACI,WAAW,IAAI,MAAM,EAAE;IAIvB,YAAY;IAInB;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAIzB;;;OAGG;IACI,UAAU,IAAI,OAAO;IAI5B;;;OAGG;IACI,UAAU,IAAI,OAAO;IAI5B;;;;OAIG;IACI,OAAO,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAuB/D;;;OAGG;IACI,SAAS,IAAI,OAAO;IAQ3B;;;OAGG;IACI,mBAAmB,IAAI,MAAM;IAOpC;;;OAGG;WACW,MAAM,IAAI,OAAO;IAI/B;;;;OAIG;IACI,UAAU,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAsBlE;;;;OAIG;IACI,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;IAiBpE,MAAM,CAAC,cAAc,CAAC,IAAI,EAAG,IAAI,GAAI,OAAO;IAK5C,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,IAAI,GAAI,MAAM;IASrC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO;CAgBjD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAM3D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAGjE"}

package/dist/core-utils-pathway.js

@@ -204,3 +204,38 @@ export class Pathway {
         return name;
     }
 }
+/**
+ * Converts a path (string or string array) to an array of path segments.
+ * If already an array, returns it as-is.
+ * If a string, splits by '/' and filters out empty segments.
+ *
+ * @param path - The path to convert to segments
+ * @returns Array of path segments
+ *
+ * @example
+ * pathSteps('/foo/bar/baz') // ['foo', 'bar', 'baz']
+ * pathSteps(['foo', 'bar']) // ['foo', 'bar']
+ * pathSteps('foo//bar/') // ['foo', 'bar']
+ */
+export function pathSteps(path) {
+    if (Array.isArray(path)) {
+        return path;
+    }
+    return path.split('/').filter(s => s.trim().length > 0);
+}
+/**
+ * Returns the parent path segments by removing the last segment.
+ * Uses pathSteps internally to normalize the input path.
+ *
+ * @param path - The path to get parent segments from
+ * @returns Array of parent path segments (all but last segment)
+ *
+ * @example
+ * parentPathSteps('/foo/bar/baz') // ['foo', 'bar']
+ * parentPathSteps(['foo', 'bar']) // ['foo']
+ * parentPathSteps(['foo']) // []
+ */
+export function parentPathSteps(path) {
+    const steps = pathSteps(path);
+    return steps.length > 0 ? steps.slice(0, steps.length - 1) : steps;
+}

package/dist/es2015/core-utils-pathway.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Pathway = void 0;
+exports.parentPathSteps = exports.pathSteps = exports.Pathway = void 0;
 /**
  * Class representing a normalized pathway.
  */
@@ -208,3 +208,40 @@ class Pathway {
     }
 }
 exports.Pathway = Pathway;
+/**
+ * Converts a path (string or string array) to an array of path segments.
+ * If already an array, returns it as-is.
+ * If a string, splits by '/' and filters out empty segments.
+ *
+ * @param path - The path to convert to segments
+ * @returns Array of path segments
+ *
+ * @example
+ * pathSteps('/foo/bar/baz') // ['foo', 'bar', 'baz']
+ * pathSteps(['foo', 'bar']) // ['foo', 'bar']
+ * pathSteps('foo//bar/') // ['foo', 'bar']
+ */
+function pathSteps(path) {
+    if (Array.isArray(path)) {
+        return path;
+    }
+    return path.split('/').filter(s => s.trim().length > 0);
+}
+exports.pathSteps = pathSteps;
+/**
+ * Returns the parent path segments by removing the last segment.
+ * Uses pathSteps internally to normalize the input path.
+ *
+ * @param path - The path to get parent segments from
+ * @returns Array of parent path segments (all but last segment)
+ *
+ * @example
+ * parentPathSteps('/foo/bar/baz') // ['foo', 'bar']
+ * parentPathSteps(['foo', 'bar']) // ['foo']
+ * parentPathSteps(['foo']) // []
+ */
+function parentPathSteps(path) {
+    const steps = pathSteps(path);
+    return steps.length > 0 ? steps.slice(0, steps.length - 1) : steps;
+}
+exports.parentPathSteps = parentPathSteps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hamak/shared-utils",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "private": false,
   "type": "module",
   "description": "Shared utilities for path navigation, filesystem operations, and common helpers",

package/src/core-utils-pathway.ts

@@ -230,3 +230,41 @@ export class Pathway {
   }
 
 }
+
+/**
+ * Converts a path (string or string array) to an array of path segments.
+ * If already an array, returns it as-is.
+ * If a string, splits by '/' and filters out empty segments.
+ *
+ * @param path - The path to convert to segments
+ * @returns Array of path segments
+ *
+ * @example
+ * pathSteps('/foo/bar/baz') // ['foo', 'bar', 'baz']
+ * pathSteps(['foo', 'bar']) // ['foo', 'bar']
+ * pathSteps('foo//bar/') // ['foo', 'bar']
+ */
+export function pathSteps(path: string | string[]): string[] {
+  if (Array.isArray(path)) {
+    return path;
+  }
+
+  return path.split('/').filter(s => s.trim().length > 0);
+}
+
+/**
+ * Returns the parent path segments by removing the last segment.
+ * Uses pathSteps internally to normalize the input path.
+ *
+ * @param path - The path to get parent segments from
+ * @returns Array of parent path segments (all but last segment)
+ *
+ * @example
+ * parentPathSteps('/foo/bar/baz') // ['foo', 'bar']
+ * parentPathSteps(['foo', 'bar']) // ['foo']
+ * parentPathSteps(['foo']) // []
+ */
+export function parentPathSteps(path: string | string[]): string[] {
+  const steps = pathSteps(path);
+  return steps.length > 0 ? steps.slice(0, steps.length - 1) : steps;
+}