flow-step-space-logic 0.1.0 → 0.1.2

package/src/filesystem.ts

@@ -11,6 +11,19 @@ import {
 export interface FilesystemDefinitionStepRuntimeOptions {
   /** Host policy lives in the runtime adapter, never in semantic Processor input. */
   readonly rootDir: string;
+  readonly extensionCodecs?: DefinitionStepAssemblyRuntime['extensionCodecs'];
+}
+
+export interface FilesystemDefinitionStepProfileRuntime extends DefinitionStepAssemblyRuntime {
+  readonly profileSources: {
+    readTopLevelXnlSources(): readonly { readonly ref: string; readonly content: string }[];
+  };
+}
+
+export interface AssembleDefinitionStepProfileDirectoryInput {}
+
+export interface AssembleDefinitionStepProfileDirectoryConfig extends DefinitionStepProfileLoadOptions {
+  readonly profileRoot: string;
 }
 
 export function createFilesystemDefinitionStepRuntime(
@@ -46,30 +59,59 @@ export function createFilesystemDefinitionStepRuntime(
         return new Uint8Array(fs.readFileSync(realFile));
       },
     }),
+    extensionCodecs: options.extensionCodecs ?? Object.freeze({ resolve: () => undefined }),
   });
 }
 
-/** Reads only top-level profile/facet files, then follows the exact declared closure. */
+export function createFilesystemDefinitionStepProfileRuntime(
+  options: FilesystemDefinitionStepRuntimeOptions,
+): FilesystemDefinitionStepProfileRuntime {
+  const absoluteRoot = path.resolve(options.rootDir);
+  const stepRuntime = createFilesystemDefinitionStepRuntime(options);
+  return Object.freeze({
+    ...stepRuntime,
+    profileSources: Object.freeze({
+      readTopLevelXnlSources() {
+        return fs.readdirSync(absoluteRoot, { withFileTypes: true })
+          .filter((entry) => entry.isFile() && entry.name.endsWith('.xnl'))
+          .sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0)
+          .map((entry) => Object.freeze({
+            ref: entry.name,
+            content: fs.readFileSync(path.join(absoluteRoot, entry.name), 'utf8'),
+          }));
+      },
+    }),
+  });
+}
+
+/** Processor authority; the host root is closed inside the runtime adapter. */
 export function assembleDefinitionStepProfileDirectory(
+  runtime: FilesystemDefinitionStepProfileRuntime,
+  _input: AssembleDefinitionStepProfileDirectoryInput,
+  config: AssembleDefinitionStepProfileDirectoryConfig,
+) {
+  if (!runtime?.profileSources || typeof runtime.profileSources.readTopLevelXnlSources !== 'function') {
+    throw diagnostic('step-profile-runtime-invalid', 'runtime.profileSources.readTopLevelXnlSources is required');
+  }
+  const sources = runtime.profileSources.readTopLevelXnlSources();
+  return assembleDefinitionStepProfileSourcesWithRuntime(
+    { sources: runtime.sources, extensionCodecs: runtime.extensionCodecs },
+    sources,
+    config.profileRoot,
+    config,
+  );
+}
+
+/** @deprecated Compatibility wrapper; new code must inject a filesystem runtime. */
+export function assembleDefinitionStepProfileDirectoryFromRoot(
   rootDir: string,
   profileRoot: string,
   options: DefinitionStepProfileLoadOptions = {},
 ) {
-  const absoluteRoot = path.resolve(rootDir);
-  const sources = fs.existsSync(absoluteRoot)
-    ? fs.readdirSync(absoluteRoot, { withFileTypes: true })
-        .filter((entry) => entry.isFile() && entry.name.endsWith('.xnl'))
-        .sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0)
-        .map((entry) => ({
-          name: entry.name,
-          content: fs.readFileSync(path.join(absoluteRoot, entry.name), 'utf8'),
-        }))
-    : [];
-  return assembleDefinitionStepProfileSourcesWithRuntime(
-    createFilesystemDefinitionStepRuntime({ rootDir: absoluteRoot }),
-    sources,
-    profileRoot,
-    options,
+  return assembleDefinitionStepProfileDirectory(
+    createFilesystemDefinitionStepProfileRuntime({ rootDir }),
+    {},
+    { ...options, profileRoot },
   );
 }