@stacksjs/path 0.75.255 → 0.75.257

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { appPath, frameworkDefaultsRoot, frameworkPath, projectPath, storagePath, usesVendoredDefaults } from './project';
+import { appPath, defaultsPath, frameworkDefaultsRoot, frameworkPath, projectPath, storagePath, usesVendoredDefaults } from './project';
 import { basename, delimiter, dirname, extname, isAbsolute, join, normalize, parse, relative, resolve, sep, toNamespacedPath } from 'node:path';
 import type { ParsedPath } from 'node:path';
 /**
@@ -1221,6 +1221,7 @@ export declare interface Path {
   browserPath: (path?: string) => string
   storagePath: (path?: string) => string
   frameworkDefaultsRoot: (projectRoot?: string) => string
+  defaultsPath: (path?: string, options?: { relative?: boolean, cwd?: string }) => string
   usesVendoredDefaults: (projectRoot?: string) => boolean
   functionsPath: (path?: string) => string
   gitPath: (path?: string) => string
@@ -1321,6 +1322,6 @@ export declare interface Path {
  *   comparison can say whether it is current.
  */
 export type DefaultsProvenance = 'not-applicable' | 'current' | 'stale' | 'unstamped';
-export { appPath, frameworkDefaultsRoot, frameworkPath, isCompiledBinary, isInstalledDefaultsRoot, linkPackagedDefaults, packagedDefaultsRoot, projectPath, storagePath, usesVendoredDefaults } from './project';
+export { appPath, defaultsPath, frameworkDefaultsRoot, frameworkPath, isCompiledBinary, isInstalledDefaultsRoot, linkPackagedDefaults, packagedDefaultsRoot, projectPath, storagePath, usesVendoredDefaults } from './project';
 export { resolveModulePath } from './module-resolution';
 export { basename, delimiter, dirname, extname, isAbsolute, join, normalize, relative, resolve, sep, toNamespacedPath };

package/dist/index.js

@@ -143,6 +143,12 @@ function storagePath(path) {
     return resolve(frameworkDefaultsRoot(), `.${sub.slice(VENDORED_DEFAULTS.length)}`);
   return projectPath(`storage/${sub}`);
 }
+function defaultsPath(path = "", options) {
+  const absolutePath = resolve(frameworkDefaultsRoot(), path);
+  if (options?.relative)
+    return relative(options.cwd || process.cwd(), absolutePath);
+  return absolutePath;
+}
 function frameworkPath(path, options) {
   const absolutePath = storagePath(`framework/${path || ""}`);
   if (options?.relative)
@@ -784,6 +790,7 @@ var path = {
   browserPath,
   storagePath,
   frameworkDefaultsRoot,
+  defaultsPath,
   usesVendoredDefaults,
   functionsPath,
   gitPath,
@@ -913,6 +920,7 @@ export {
   datetimePath,
   defaultsAppPath,
   defaultsPackagePath,
+  defaultsPath,
   defaultsResourcesPath,
   delimiter,
   desktopPath,

package/dist/project.d.ts

@@ -67,4 +67,18 @@ export declare function frameworkDefaultsRoot(projectRoot?: string): string;
  * works the same whether the app vendors the tree or not.
  */
 export declare function storagePath(path?: string): string;
+/**
+ * A path inside the scaffold defaults tree, wherever that tree is.
+ *
+ * `frameworkDefaultsRoot()` already answers that question, and `storagePath`
+ * and `frameworkPath` already route `framework/defaults/...` through it, so
+ * this adds no resolution of its own. It exists because a caller that means
+ * "a file in the defaults" reads better saying so, and because
+ * stacksjs/stacks#2941 converted a number of call sites to it.
+ *
+ * Deliberately a wrapper rather than a second resolver. Two answers to "where
+ * are the defaults" is the failure in #2927, where two sources for one
+ * component name picked the wrong one by readdir order.
+ */
+export declare function defaultsPath(path?: string, options?: { relative?: boolean, cwd?: string }): string;
 export declare function frameworkPath(path?: string, options?: { relative?: boolean, cwd?: string }): string;

package/dist/project.js

@@ -113,6 +113,12 @@ function storagePath(path) {
     return resolve(frameworkDefaultsRoot(), `.${sub.slice(VENDORED_DEFAULTS.length)}`);
   return projectPath(`storage/${sub}`);
 }
+function defaultsPath(path = "", options) {
+  const absolutePath = resolve(frameworkDefaultsRoot(), path);
+  if (options?.relative)
+    return relative(options.cwd || process.cwd(), absolutePath);
+  return absolutePath;
+}
 function frameworkPath(path, options) {
   const absolutePath = storagePath(`framework/${path || ""}`);
   if (options?.relative)
@@ -121,6 +127,7 @@ function frameworkPath(path, options) {
 }
 export {
   appPath,
+  defaultsPath,
   frameworkDefaultsRoot,
   frameworkPath,
   isCompiledBinary,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/path",
   "type": "module",
-  "version": "0.75.255",
+  "version": "0.75.257",
   "description": "The Stacks path.",
   "author": "Chris Breuer",
   "contributors": [