@statewalker/webrun-files 0.3.1 → 0.4.0

package/src/utils/normalize-path.ts

@@ -0,0 +1,34 @@
+/**
+ * Path normalization utilities
+ */
+
+import type { FileRef } from "../types.js";
+
+/**
+ * Normalizes a file path to a consistent format.
+ * - Adds leading slash if missing
+ * - Removes trailing slash
+ * - Removes `.` segments
+ * - Collapses multiple slashes
+ */
+export function normalizePath(filePath: string): string {
+  const segments = filePath.split("/").filter((s) => !!s && s !== ".");
+  if (segments.length === 0) {
+    return "/";
+  }
+  return `/${segments.join("/")}`;
+}
+
+/**
+ * Extracts path string from FileRef.
+ */
+export function toPath(file: FileRef): string {
+  return typeof file === "object" ? file.path : String(file);
+}
+
+/**
+ * Normalizes FileRef to a path string.
+ */
+export function resolveFileRef(file: FileRef): string {
+  return normalizePath(toPath(file));
+}

package/src/utils/path-utils.ts

@@ -0,0 +1,46 @@
+/**
+ * Path manipulation utilities
+ */
+
+import { normalizePath } from "./normalize-path.js";
+
+/**
+ * Joins path segments with proper normalization.
+ */
+export function joinPath(...segments: string[]): string {
+  const combined = segments.join("/");
+  return normalizePath(combined);
+}
+
+/**
+ * Returns the directory portion of a path.
+ */
+export function dirname(path: string): string {
+  const normalized = normalizePath(path);
+  const lastSlash = normalized.lastIndexOf("/");
+  if (lastSlash <= 0) return "/";
+  return normalized.substring(0, lastSlash);
+}
+
+/**
+ * Returns the filename portion of a path.
+ */
+export function basename(path: string, ext?: string): string {
+  const normalized = normalizePath(path);
+  const lastSlash = normalized.lastIndexOf("/");
+  const name = lastSlash === -1 ? normalized : normalized.substring(lastSlash + 1);
+  if (ext && name.endsWith(ext)) {
+    return name.substring(0, name.length - ext.length);
+  }
+  return name;
+}
+
+/**
+ * Returns the file extension including the dot.
+ */
+export function extname(path: string): string {
+  const name = basename(path);
+  const dotIndex = name.lastIndexOf(".");
+  if (dotIndex <= 0) return "";
+  return name.substring(dotIndex);
+}

package/CHANGELOG.md

@@ -1,2 +0,0 @@
-# @statewalker/files
-

package/README.md

@@ -1,17 +0,0 @@
-
-# @statewalker/files
-
-Minimalistic cross-plateform files API implementation.
-
-## Usage
-
-```js
-
-
-```
-
-## Example
-
-```js
-
-```