@stacksjs/config 0.74.28 → 0.74.29

package/dist/discovered-resources.d.ts

@@ -1,3 +1,37 @@
+/**
+ * Migration directories each discovered package contributes.
+ *
+ * These are read, never written. The migration runner deletes and rewrites
+ * files in the corpus it runs - SQLite preprocessing drops statements it
+ * cannot execute and prunes duplicate CREATEs - so a package's own directory
+ * is copied out of before any of that happens. Doing otherwise would have the
+ * framework mutating an installed package's files, which a reinstall silently
+ * undoes.
+ */
+export declare function packageMigrationRoots(options?: PackageResourceOptions): PackageResourceRoot[];
+/**
+ * Job directories each discovered package contributes.
+ *
+ * Conventional, like models, rather than opt-in like components. A job is
+ * reached by its exported name from the barrel and is inert until something
+ * dispatches or schedules it, so a package shipping `app/Jobs` it did not mean
+ * to publish costs a name in the barrel and nothing else.
+ */
+export declare function packageJobRoots(options?: PackageResourceOptions): PackageResourceRoot[];
+/**
+ * Component directories each discovered package contributes.
+ *
+ * Opt-in, unlike every other surface here: a package contributes components
+ * only by declaring `"components"` in its `stacks` key. Components resolve by
+ * bare tag name across every template in the process, so a directory picked up
+ * by convention would silently enter that namespace.
+ *
+ * The caller decides precedence. Placing these AFTER the framework's own
+ * component directories makes a package purely additive, which is what the
+ * shipped stx plugin does - stx searches its component list in order and takes
+ * the first match.
+ */
+export declare function packageComponentRoots(options?: PackageResourceOptions): PackageResourceRoot[];
 /** View directories each discovered package contributes. */
 export declare function packageViewRoots(options?: PackageResourceOptions): PackageResourceRoot[];
 /**

package/dist/discovered-resources.js

@@ -1 +1 @@
-import{existsSync,readFileSync}from"node:fs";import{isAbsolute,join}from"node:path";import{path}from"@stacksjs/path";const IMPLIED_DIRS={views:["resources/views"],models:["app/Models"]};function readManifest(manifestPath){try{return JSON.parse(readFileSync(manifestPath,"utf8"))?.packages??{}}catch{return{}}}function resourceRoots(field,options={}){const manifestPath=options.manifestPath??path.storagePath("framework/discovered-packages.json"),projectRoot=options.projectRoot??path.projectPath(),exists=options.exists??existsSync,roots=[];for(const[name,meta]of Object.entries(readManifest(manifestPath))){const declared=meta?.[field]??IMPLIED_DIRS[field];if(!declared)continue;const root=meta.root;if(!root||typeof root!=="string")continue;const base=isAbsolute(root)?root:join(projectRoot,root);for(const entry of Array.isArray(declared)?declared:[declared]){if(typeof entry!=="string"||!entry)continue;const cleaned=entry.replace(/^[/\\]+/,"");if(!cleaned||cleaned.split(/[/\\]/).includes(".."))continue;const dir=join(base,cleaned);if(exists(dir))roots.push({package:name,dir})}}return roots.sort((a,b)=>a.package.localeCompare(b.package))}export function packageViewRoots(options={}){return resourceRoots("views",options)}export function packageModelRoots(options={}){return resourceRoots("models",options)}
+import{existsSync,readFileSync}from"node:fs";import{isAbsolute,join}from"node:path";import{path}from"@stacksjs/path";const IMPLIED_DIRS={views:["resources/views"],models:["app/Models"],migrations:["database/migrations"],jobs:["app/Jobs"]};function readManifest(manifestPath){try{return JSON.parse(readFileSync(manifestPath,"utf8"))?.packages??{}}catch{return{}}}function resourceRoots(field,options={}){const manifestPath=options.manifestPath??path.storagePath("framework/discovered-packages.json"),projectRoot=options.projectRoot??path.projectPath(),exists=options.exists??existsSync,roots=[];for(const[name,meta]of Object.entries(readManifest(manifestPath))){const declared=meta?.[field]??IMPLIED_DIRS[field];if(!declared)continue;const root=meta.root;if(!root||typeof root!=="string")continue;const base=isAbsolute(root)?root:join(projectRoot,root);for(const entry of Array.isArray(declared)?declared:[declared]){if(typeof entry!=="string"||!entry)continue;const cleaned=entry.replace(/^[/\\]+/,"");if(!cleaned||cleaned.split(/[/\\]/).includes(".."))continue;const dir=join(base,cleaned);if(exists(dir))roots.push({package:name,dir})}}return roots.sort((a,b)=>a.package.localeCompare(b.package))}export function packageMigrationRoots(options={}){return resourceRoots("migrations",options)}export function packageJobRoots(options={}){return resourceRoots("jobs",options)}export function packageComponentRoots(options={}){return resourceRoots("components",options)}export function packageViewRoots(options={}){return resourceRoots("views",options)}export function packageModelRoots(options={}){return resourceRoots("models",options)}

package/dist/index.d.ts

@@ -12,7 +12,7 @@ export * from './config';
 export { FRAMEWORK_DEFAULTS } from './defaults';
 export { validateConfig, reportConfigIssues, type ConfigValidationIssue } from './validators';
 export { feature, enableFeature, disableFeature, resetFeature, listFeatures } from './features';
-export { packageModelRoots, packageViewRoots, type PackageResourceOptions, type PackageResourceRoot } from './discovered-resources';
+export { packageComponentRoots, packageJobRoots, packageMigrationRoots, packageModelRoots, packageViewRoots, type PackageResourceOptions, type PackageResourceRoot } from './discovered-resources';
 export { resolveViewPatterns, type DefaultViewsSetting, type ViewPatternResolution } from './views';
 export {
   createRequestContext,

package/dist/index.js

@@ -1 +1 @@
-export*from"./config";export{FRAMEWORK_DEFAULTS}from"./defaults";export{validateConfig,reportConfigIssues}from"./validators";export{feature,enableFeature,disableFeature,resetFeature,listFeatures}from"./features";export{packageModelRoots,packageViewRoots}from"./discovered-resources";export{resolveViewPatterns}from"./views";export{createRequestContext,installRequestContext,parseCookieHeader,useRequestEvent}from"./request-context";export*from"./capabilities";
+export*from"./config";export{FRAMEWORK_DEFAULTS}from"./defaults";export{validateConfig,reportConfigIssues}from"./validators";export{feature,enableFeature,disableFeature,resetFeature,listFeatures}from"./features";export{packageComponentRoots,packageJobRoots,packageMigrationRoots,packageModelRoots,packageViewRoots}from"./discovered-resources";export{resolveViewPatterns}from"./views";export{createRequestContext,installRequestContext,parseCookieHeader,useRequestEvent}from"./request-context";export*from"./capabilities";

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/config",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.28",
+  "version": "0.74.29",
   "description": "The Stacks config helper methods.",
   "author": "Chris Breuer",
   "contributors": [
@@ -55,14 +55,14 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/events": "0.74.28",
-    "@stacksjs/path": "0.74.28",
-    "@stacksjs/tunnel": "0.74.28",
+    "@stacksjs/events": "0.74.29",
+    "@stacksjs/path": "0.74.29",
+    "@stacksjs/tunnel": "0.74.29",
     "ts-pantry": "^0.11.35"
   },
   "devDependencies": {
-    "@stacksjs/alias": "0.74.28",
-    "@stacksjs/types": "0.74.28",
+    "@stacksjs/alias": "0.74.29",
+    "@stacksjs/types": "0.74.29",
     "better-dx": "^0.2.24"
   }
 }