@stacksjs/path 0.74.42 → 0.74.43

package/dist/index.d.ts

@@ -458,14 +458,21 @@ export declare function desktopPath(path?: string): string;
  */
 export declare function docsPath(path?: string): string;
 /**
- * Returns the path to the `domains` directory within the core directory.
+ * Returns the path to the `dns` directory within the core directory.
  *
- * @param path - The relative path to the file or directory within the `domains` directory.
- * @returns The absolute path to the specified file or directory within the `domains` directory.
+ * The package is `core/dns`. This said `core/domains` - a directory that has
+ * not existed for as long as the package has been called `@stacksjs/dns`.
+ *
+ * @param path - The relative path to the file or directory within the `dns` directory.
+ * @returns The absolute path to the specified file or directory within the `dns` directory.
  */
 export declare function dnsPath(path?: string): string;
 /**
- * Returns the path to the `email` directory within the `notifications` directory.
+ * Returns the path to the `email` directory within the core directory.
+ *
+ * `core/email`, not `core/notifications/email`. Email, push and sms were all
+ * nested under `notifications` once and were promoted to top-level packages;
+ * these three helpers kept pointing at where they used to be.
  *
  * @param path - The relative path to the file or directory within the email directory.
  * @returns The absolute path to the specified file or directory within the email directory.
@@ -560,10 +567,14 @@ export declare function functionsPath(path?: string): string;
  */
 export declare function gitPath(path?: string): string;
 /**
- * Returns the path to the `lang` directory, optionally relative to the project directory.
+ * Returns the path to the translations directory, optionally relative to the project directory.
  *
- * @param path - The relative path to the file or directory within the lang directory.
- * @returns The absolute path to the specified file or directory within the lang directory.
+ * That directory is `locales/` at the project root - `en.yml`, `de.yml`. This
+ * returned `resources/lang/`, which is Laravel's convention and has never been
+ * where Stacks keeps translations.
+ *
+ * @param path - The relative path to the file or directory within the translations directory.
+ * @returns The absolute path to the specified file or directory within the translations directory.
  */
 export declare function langPath(path?: string): string;
 /**
@@ -624,10 +635,18 @@ export declare function loggingPath(path?: string): string;
  */
 export declare function logsPath(path?: string): string;
 /**
- * Returns the path to the `models` directory within the app directory.
+ * Returns the path to the `Models` directory within the app directory.
+ *
+ * Capital `M`. This built `app/models`, the only one of the twelve
+ * `appPath`-relative helpers that did not match the directory it names -
+ * which resolves anyway on a case-insensitive filesystem, so it worked on
+ * macOS and Windows and found nothing on Linux.
  *
- * @param path - The relative path to the file or directory within the `models` directory.
- * @returns The absolute path to the specified file or directory within the `models` directory.
+ * Delegates to {@link userModelsPath} rather than repeating the segment, so
+ * the two cannot disagree again.
+ *
+ * @param path - The relative path to the file or directory within the `Models` directory.
+ * @returns The absolute path to the specified file or directory within the `Models` directory.
  */
 export declare function modelsPath(path?: string): string;
 /**
@@ -744,7 +763,9 @@ export declare function installedDefaultsVersion(projectRoot?: string): string |
  */
 export declare function inspectDefaultsProvenance(projectRoot?: string): DefaultsSkew;
 /**
- * Returns the path to the `push` directory within the `notifications` directory.
+ * Returns the path to the `push` directory within the core directory.
+ *
+ * `core/push`, not `core/notifications/push` - see {@link emailPath}.
  *
  * @param path - The relative path to the file or directory within the push directory.
  * @returns The absolute path to the specified file or directory within the push directory.
@@ -877,7 +898,9 @@ export declare function actionRunnerPath(path?: string): string;
  */
 export declare function slugPath(path?: string): string;
 /**
- * Returns the path to the `sms` directory within the `notifications` directory.
+ * Returns the path to the `sms` directory within the core directory.
+ *
+ * `core/sms`, not `core/notifications/sms` - see {@link emailPath}.
  *
  * @param path - The relative path to the file or directory within the `sms` directory.
  * @returns The absolute path to the specified file or directory within the `sms` directory.

package/dist/index.js

@@ -251,10 +251,10 @@ function docsPath(path) {
   return corePath(`docs/${path || ""}`);
 }
 function dnsPath(path) {
-  return corePath(`domains/${path || ""}`);
+  return corePath(`dns/${path || ""}`);
 }
 function emailPath(path) {
-  return notificationsPath(`email/${path || ""}`);
+  return corePath(`email/${path || ""}`);
 }
 function enumsPath(path) {
   return corePath(`enums/${path || ""}`);
@@ -293,7 +293,7 @@ function gitPath(path) {
   return corePath(`git/${path || ""}`);
 }
 function langPath(path) {
-  return resourcesPath(`lang/${path || ""}`);
+  return projectPath(`locales/${path || ""}`);
 }
 function layoutsPath(path, options) {
   let absolutePath;
@@ -324,7 +324,7 @@ function logsPath(path) {
   return storagePath(`logs/${path || ""}`);
 }
 function modelsPath(path) {
-  return appPath(`models/${path || ""}`);
+  return userModelsPath(path);
 }
 function modulesPath(path) {
   return resourcesPath(`modules/${path || ""}`);
@@ -424,7 +424,7 @@ function inspectDefaultsProvenance(projectRoot = projectPath()) {
   };
 }
 function pushPath(path) {
-  return notificationsPath(`push/${path || ""}`);
+  return corePath(`push/${path || ""}`);
 }
 function queryBuilderPath(path) {
   return corePath(`query-builder/${path || ""}`);
@@ -485,7 +485,7 @@ function slugPath(path) {
   return corePath(`slug/${path || ""}`);
 }
 function smsPath(path) {
-  return notificationsPath(`sms/${path || ""}`);
+  return corePath(`sms/${path || ""}`);
 }
 function coreStoragePath(path) {
   return corePath(`storage/${path || ""}`);

package/package.json

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