@dsh-stack/workspace-files 0.0.0-stage → 0.1.1

package/README.md

@@ -1,3 +1,3 @@
-# Temporary Holding Version
+# workspace-files
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Workspace file abstractions and client-facing file operations for Stack.

package/lib/index.d.ts

@@ -0,0 +1,30 @@
+export type FileNodeKind = "file" | "directory" | "workspace" | "repository";
+export type FileRowAction = "open" | "open-new-tab" | "reveal" | "copy-path" | "rename" | "duplicate" | "delete";
+export interface FileNode {
+    readonly id: string;
+    readonly kind: FileNodeKind;
+    readonly name: string;
+    readonly path: string;
+    readonly parentId?: string;
+    readonly hidden?: boolean;
+}
+export interface FileRowModel extends FileNode {
+    readonly actions: readonly FileRowAction[];
+    readonly iconRequest: {
+        readonly fileName?: string;
+        readonly extension?: string;
+        readonly languageId?: string;
+        readonly folderName?: string;
+        readonly isRoot?: boolean;
+        readonly expanded?: boolean;
+    };
+}
+export declare const defaultFileRowActions: readonly FileRowAction[];
+export interface FileSection {
+    readonly id: "pinned" | "active" | "host-root" | "container-root" | "ungrouped" | "archived";
+    readonly label: string;
+    readonly iconTone: "default" | "muted";
+}
+export declare const defaultFileSections: readonly FileSection[];
+/** createFileRow implementation. */
+export declare function createFileRow(node: FileNode, expanded?: boolean): FileRowModel;

package/lib/index.js

@@ -0,0 +1,48 @@
+export const defaultFileRowActions = [
+    "open",
+    "open-new-tab",
+    "reveal",
+    "copy-path",
+    "rename",
+    "duplicate",
+    "delete",
+];
+// jscpd:ignore-start -- index/tab-building mirrors composition/src/sidebar.ts's shape for a different domain; not extracted to keep each package's export self-contained
+export const defaultFileSections = [
+    { id: "pinned", label: "Pinned", iconTone: "default" },
+    { id: "active", label: "Active", iconTone: "default" },
+    { id: "host-root", label: "Host Root", iconTone: "muted" },
+    { id: "container-root", label: "Container", iconTone: "muted" },
+    { id: "ungrouped", label: "Ungrouped", iconTone: "muted" },
+    { id: "archived", label: "Archived", iconTone: "muted" },
+];
+/** createFileRow implementation. */
+export function createFileRow(node, expanded = false) {
+    // jscpd:ignore-end
+    const extension = extensionOf(node.name);
+    const folder = node.kind === "directory" || node.kind === "workspace" || node.kind === "repository"
+        ? node.name
+        : undefined;
+    return {
+        ...node,
+        actions: [...defaultFileRowActions],
+        iconRequest: {
+            fileName: node.kind === "file" ? node.name : undefined,
+            extension: extension ?? undefined,
+            folderName: folder,
+            isRoot: node.kind === "workspace" || node.kind === "repository",
+            expanded,
+        },
+    };
+}
+/**
+ * Returns the extension of the given file name if it contains exactly one dot.
+ * @param name - The file name to extract the extension from.
+ * @returns The lowercased extension if present; otherwise, undefined.
+ */
+function extensionOf(name) {
+    const dot = name.lastIndexOf(".");
+    if (dot <= 0 || dot === name.length - 1)
+        return undefined;
+    return name.slice(dot + 1).toLowerCase();
+}

package/package.json

@@ -1,6 +1,37 @@
 {
   "name": "@dsh-stack/workspace-files",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "verify": "node verify.mjs"
+  },
+  "devDependencies": {
+    "typescript": "^6.0.3"
+  },
+  "stack": {
+    "kind": "plugin",
+    "id": "stack.workspace.files"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marius-patrik/dsh-stack.git",
+    "directory": "plugins/workspace-files"
+  }
+}