@ldgerrits/rogen 1.4.0

package/dist/tree.js

@@ -0,0 +1,182 @@
+import fs from "fs";
+import path from "path";
+function hasPathPrefix(p, dir) {
+    return p === dir || p.startsWith(dir + "/");
+}
+export const toPosix = (p) => p.split(path.sep).join("/");
+export function applyCasing(value, casing) {
+    if (value.length === 0)
+        return value;
+    const firstCharacter = casing === "PascalCase"
+        ? value[0].toUpperCase()
+        : value[0].toLowerCase();
+    return firstCharacter + value.slice(1);
+}
+export function getOrCreateNode(parent, key, className) {
+    if (!parent[key]) {
+        parent[key] = className == null ? {} : { $className: className };
+    }
+    return parent[key];
+}
+export function pruneObject(node, buildDir, outputDir, removed = [], treePath = "") {
+    for (const key in node) {
+        const val = node[key];
+        if (typeof val !== "object" || val === null)
+            continue;
+        const childTreePath = treePath ? `${treePath}.${key}` : key;
+        const childNode = val;
+        if (childNode.$path) {
+            if (hasPathPrefix(childNode.$path, buildDir))
+                continue;
+            const absolutePath = path.resolve(outputDir, childNode.$path);
+            if (!fs.existsSync(absolutePath)) {
+                delete node[key];
+                removed.push({
+                    treePath: childTreePath,
+                    rojoPath: childNode.$path,
+                });
+                continue;
+            }
+        }
+        pruneObject(childNode, buildDir, outputDir, removed, childTreePath);
+    }
+    return node;
+}
+export function sortObject(obj) {
+    if (obj === null || typeof obj !== "object" || Array.isArray(obj)) {
+        return obj;
+    }
+    const record = obj;
+    return Object.keys(record)
+        .sort()
+        .reduce((acc, key) => {
+        acc[key] = sortObject(record[key]);
+        return acc;
+    }, {});
+}
+export function findMissingPaths(node, buildDir, outputDir, missing = [], treePath = "") {
+    for (const key in node) {
+        const val = node[key];
+        if (typeof val !== "object" || val === null)
+            continue;
+        const childTreePath = treePath ? `${treePath}.${key}` : key;
+        const childNode = val;
+        if (childNode.$path && hasPathPrefix(childNode.$path, buildDir)) {
+            const absolutePath = path.resolve(outputDir, childNode.$path);
+            if (!fs.existsSync(absolutePath)) {
+                missing.push({
+                    parent: node,
+                    key,
+                    treePath: childTreePath,
+                    path: childNode.$path,
+                    absolutePath,
+                });
+            }
+        }
+        findMissingPaths(childNode, buildDir, outputDir, missing, childTreePath);
+    }
+    return missing;
+}
+const isScript = (filename) => /\.(tsx?|luau|lua)$/i.test(filename) &&
+    !filename.toLowerCase().endsWith(".d.ts");
+const isModel = (filename) => /\.(rbxm|rbxmx)$/i.test(filename);
+export function isData(filename) {
+    if (isScript(filename) || isModel(filename))
+        return false;
+    if (filename.startsWith("."))
+        return false;
+    return /\.[a-z0-9]+$/i.test(filename);
+}
+export const isValidSource = (filename) => isScript(filename) || isModel(filename) || isData(filename);
+export const isInitFile = (filename) => isScript(filename) && /^(index|init)([.-][a-z0-9_]+)?\./i.test(filename);
+function getRojoBaseName(filename) {
+    if (isScript(filename)) {
+        return filename
+            .replace(/\.(server|client)\.(luau?|lua|tsx?)$/i, "")
+            .replace(/\.(luau?|lua|tsx?)$/i, "");
+    }
+    if (isModel(filename)) {
+        return filename.replace(/\.(rbxmx?)$/i, "");
+    }
+    if (isData(filename)) {
+        return filename.replace(/\.[a-z0-9]+$/i, "");
+    }
+    return filename;
+}
+export function collapseFolders(node, buildDir, outputDir) {
+    let childCount = 0;
+    let canCollapse = true;
+    let commonDir = null;
+    for (const key in node) {
+        if (key.startsWith("$"))
+            continue;
+        const val = node[key];
+        if (typeof val !== "object" || val === null)
+            continue;
+        const childNode = val;
+        // Process deepest nested children first
+        collapseFolders(childNode, buildDir, outputDir);
+        childCount++;
+        if (!childNode.$path) {
+            canCollapse = false;
+        }
+        else {
+            const childAbsPath = path.resolve(outputDir, childNode.$path);
+            const parentDir = path.dirname(childAbsPath);
+            // All children should share the same directory
+            if (commonDir === null) {
+                commonDir = parentDir;
+            }
+            else if (commonDir !== parentDir) {
+                canCollapse = false;
+            }
+            const fileName = path.basename(childAbsPath);
+            if (getRojoBaseName(fileName) !== key) {
+                canCollapse = false;
+            }
+        }
+    }
+    if (childCount === 0 || !canCollapse || commonDir === null) {
+        return;
+    }
+    const absoluteBuildDir = path.resolve(outputDir, buildDir);
+    if (!hasPathPrefix(toPosix(commonDir), toPosix(absoluteBuildDir))) {
+        return;
+    }
+    try {
+        const diskItems = fs.readdirSync(commonDir);
+        // filter out marker files so they do not prevent folders from collapsing
+        const visibleDiskItems = diskItems.filter((item) => !item.startsWith("."));
+        if (visibleDiskItems.length !== childCount) {
+            return;
+        }
+    }
+    catch {
+        return;
+    }
+    // Replace all child files with a single folder $path
+    const relativeCommonDir = toPosix(path.relative(outputDir, commonDir));
+    for (const key in node) {
+        if (!key.startsWith("$")) {
+            delete node[key];
+        }
+    }
+    node.$path = relativeCommonDir;
+    delete node.$className;
+}
+export function findExposedDataFiles(node, exposed = []) {
+    for (const key in node) {
+        if (key.startsWith("$"))
+            continue;
+        const val = node[key];
+        if (typeof val !== "object" || val === null)
+            continue;
+        const childNode = val;
+        // Check if the current node exposes a raw data file path
+        if (childNode.$path && isData(childNode.$path)) {
+            exposed.push(childNode.$path);
+        }
+        findExposedDataFiles(childNode, exposed);
+    }
+    return exposed;
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,56 @@
+{
+	"name": "@ldgerrits/rogen",
+	"version": "1.4.0",
+	"publishConfig": {
+		"access": "public"
+	},
+	"description": "Feature-based folder routing for Roblox",
+	"author": "ldgerrits",
+	"license": "MIT",
+	"type": "module",
+	"workspaces": [
+		"docs"
+	],
+	"files": [
+		"dist",
+		"README.md",
+		"LICENSE.md"
+	],
+	"scripts": {
+		"clean": "node -e \"fs.rmSync('dist', { recursive: true, force: true })\"",
+		"build": "tsc",
+		"bundle": "esbuild bin/rogen.ts --bundle --platform=node --format=cjs --external:*.node --outfile=dist/bundle.cjs",
+		"prepublishOnly": "npm run clean && npm run build && npm run bundle",
+		"test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
+		"test:watch": "node --experimental-vm-modules node_modules/jest/bin/jest.js --watch",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"release:local": "npm run bundle && npx pkg dist/bundle.cjs --targets node18-win-x64,node18-linux-x64,node18-macos-x64 --out-path releases/"
+	},
+	"main": "dist/index.js",
+	"bin": {
+		"rogen": "dist/bundle.cjs"
+	},
+	"devDependencies": {
+		"@eslint/js": "^10.0.1",
+		"@types/jest": "^30.0.0",
+		"@types/node": "^26.0.1",
+		"@types/picomatch": "^4.0.3",
+		"esbuild": "^0.28.1",
+		"eslint": "^10.6.0",
+		"eslint-plugin-jest": "^29.15.4",
+		"jest": "^30.4.2",
+		"ts-jest": "^29.4.11",
+		"typescript": "^6.0.3",
+		"typescript-eslint": "^8.62.1"
+	},
+	"dependencies": {
+		"chokidar": "^3.6.0",
+		"picomatch": "^4.0.5"
+	},
+	"allowScripts": {
+		"esbuild@0.28.1": true,
+		"sharp@0.34.5": true,
+		"unrs-resolver@1.12.2": true
+	}
+}