@defold-typescript/transpiler 0.36.0 → 0.37.0

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export type { ExtensionDependency, LibraryIncludedEntries, LibrarySceneDocument,
 export { archiveWrapperOf, isContainedResourcePath, LIBRARY_DEPENDENCY_ROOT, libraryIncludedEntries, readGameProjectDependencies, readLibrarySceneDocuments, } from "./library-dependencies";
 export { findMainEntryFactoryImports } from "./main-entry-factory-imports";
 export type { BuildConfig, ScriptKind, SourceOutputKind } from "./output-paths";
-export { computeOutputRel, DEFAULT_INCLUDE, parseBuildConfig, requirePathForRel, SCRIPT_SUFFIX_BY_KIND, stripIncludeBase, } from "./output-paths";
+export { computeOutputRel, DEFAULT_INCLUDE, parseBuildConfig, projectRelativeBase, requirePathForRel, SCRIPT_SUFFIX_BY_KIND, stripIncludeBase, } from "./output-paths";
 export { getProgramDiagnostics } from "./program-diagnostics";
 export { isDefignoredPath, SCAFFOLDED_DEFIGNORE_LINES } from "./project-resources";
 export { rewriteEmittedRequires } from "./require-rewrite";

package/dist/index.js

@@ -1993,6 +1993,17 @@ function stripIncludeBase(pattern) {
   const lastSlash = upToWildcard.lastIndexOf("/");
   return lastSlash === -1 ? "" : upToWildcard.slice(0, lastSlash + 1);
 }
+var ABSOLUTE_SPELLING_RE = /^(\/|\\\\|[A-Za-z]:[\\/])/;
+function projectRelativeBase(pattern) {
+  if (ABSOLUTE_SPELLING_RE.test(pattern)) {
+    return;
+  }
+  const base = path.posix.normalize(stripIncludeBase(pattern.split("\\").join("/")));
+  if (base === ".." || base.startsWith("../")) {
+    return;
+  }
+  return base === "." || base === "./" ? "" : base;
+}
 function relUnderOutDir(rel, config) {
   const { outDir, include } = config;
   if (outDir === undefined || outDir === "" || outDir === ".") {
@@ -3901,6 +3912,7 @@ export {
   listProjectResourcePaths,
   parseBuildConfig,
   parseSceneTextFormat,
+  projectRelativeBase,
   readGameProjectDependencies,
   readGameProjectSetting,
   readLibrarySceneDocuments,

package/dist/output-paths.d.ts

@@ -8,6 +8,7 @@ export declare const DEFAULT_INCLUDE: string[];
 export declare const SCRIPT_SUFFIX_BY_KIND: Record<ScriptKind, string>;
 export declare function parseBuildConfig(raw: string): BuildConfig;
 export declare function stripIncludeBase(pattern: string): string;
+export declare function projectRelativeBase(pattern: string): string | undefined;
 /**
  * The `require` path Lua reaches a rel by, mirroring the segment math TSTL
  * applies when it emits one: the extension comes off the last segment, then

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@defold-typescript/transpiler",
-  "version": "0.36.0",
+  "version": "0.37.0",
   "description": "TypeScript-to-Lua build pipeline tuned for Defold's runtime.",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,7 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@defold-typescript/types": "0.36.0",
+    "@defold-typescript/types": "0.37.0",
     "@typescript-to-lua/language-extensions": "1.19.0",
     "typescript-to-lua": "^1.36.0"
   }

package/src/index.ts

@@ -42,6 +42,7 @@ export {
   computeOutputRel,
   DEFAULT_INCLUDE,
   parseBuildConfig,
+  projectRelativeBase,
   requirePathForRel,
   SCRIPT_SUFFIX_BY_KIND,
   stripIncludeBase,

package/src/output-paths.ts

@@ -46,6 +46,30 @@ export function stripIncludeBase(pattern: string): string {
   return lastSlash === -1 ? "" : upToWildcard.slice(0, lastSlash + 1);
 }
 
+// A root is a folder inside the project a tool can safely speak for, so a
+// pattern that resolves to the project root, escapes `cwd`, or is absolute in
+// any spelling yields nothing. Escape is the normalized `..` *segment*, not a
+// two-period prefix: `..local` is an ordinary folder name. Absoluteness is
+// decided by string shape, never by `path.isAbsolute`, which answers for the
+// host OS and would wave a Windows drive or UNC path through on a POSIX runner.
+const ABSOLUTE_SPELLING_RE = /^(\/|\\\\|[A-Za-z]:[\\/])/;
+
+// The folder an include pattern speaks for, as a project-relative posix base
+// (`""` for the project root itself), or `undefined` when the pattern reaches
+// outside the project. The scaffold-rule roots, the starter target and the
+// debug launch derivation all answer "which project folder does this pattern
+// speak for" here, so the three cannot drift.
+export function projectRelativeBase(pattern: string): string | undefined {
+  if (ABSOLUTE_SPELLING_RE.test(pattern)) {
+    return undefined;
+  }
+  const base = path.posix.normalize(stripIncludeBase(pattern.split("\\").join("/")));
+  if (base === ".." || base.startsWith("../")) {
+    return undefined;
+  }
+  return base === "." || base === "./" ? "" : base;
+}
+
 function relUnderOutDir(rel: string, config: BuildConfig): string {
   const { outDir, include } = config;
   if (outDir === undefined || outDir === "" || outDir === ".") {