@open-press/cli 0.7.1 → 0.8.0

package/template/core/engine/runtime/file-walk.mjs

@@ -0,0 +1,22 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+
+export async function walkFiles(directory, visit) {
+  let entries;
+  try {
+    entries = await fs.readdir(directory, { withFileTypes: true });
+  } catch (error) {
+    if (error?.code === "ENOENT") return;
+    throw error;
+  }
+
+  for (const entry of entries) {
+    if (entry.name.startsWith(".")) continue;
+    const absolutePath = path.join(directory, entry.name);
+    if (entry.isDirectory()) {
+      await walkFiles(absolutePath, visit);
+    } else if (entry.isFile()) {
+      await visit(absolutePath);
+    }
+  }
+}

package/template/core/engine/runtime/inspection.mjs

@@ -2,6 +2,7 @@ import fs from "node:fs/promises";
 import path from "node:path";
 import { evaluateUrlWithChrome, stopChildProcess } from "../output/chrome-pdf.mjs";
 import { buildReactStatic, startStaticServer } from "../commands/_shared.mjs";
+import { walkFiles } from "./file-walk.mjs";
 import { createIssue, createIssueReport } from "./issue-report.mjs";
 import { collectActiveContentFiles, resolveActiveSourceWorkspace } from "./source-workspace.mjs";
 
@@ -217,26 +218,6 @@ async function readMediaFiles(directory) {
   return files;
 }
 
-async function walkFiles(directory, visit) {
-  let entries;
-  try {
-    entries = await fs.readdir(directory, { withFileTypes: true });
-  } catch (error) {
-    if (error?.code === "ENOENT") return;
-    throw error;
-  }
-
-  for (const entry of entries) {
-    if (entry.name.startsWith(".")) continue;
-    const absolutePath = path.join(directory, entry.name);
-    if (entry.isDirectory()) {
-      await walkFiles(absolutePath, visit);
-    } else if (entry.isFile()) {
-      await visit(absolutePath);
-    }
-  }
-}
-
 function summarizeComponentUsage(contentFiles) {
   const usages = new Map();
   for (const file of contentFiles) {

package/template/core/engine/runtime/path-utils.mjs

@@ -0,0 +1,20 @@
+import path from "node:path";
+
+export function rootRelativePath(config, absolutePath) {
+  return path.relative(config.root, absolutePath).replaceAll("\\", "/");
+}
+
+export function documentRelativePath(absolutePath, documentRoot) {
+  return path.relative(documentRoot, absolutePath).split(path.sep).join("/");
+}
+
+export function resolveDocumentRelativePath(documentRoot, rel, label) {
+  if (typeof rel !== "string" || !rel.trim()) throw new Error(`${label} must be a non-empty document-relative path.`);
+  if (rel.includes("..")) throw new Error(`${label} contains "..", rejected.`);
+  const absolutePath = path.resolve(documentRoot, rel);
+  const relCheck = path.relative(documentRoot, absolutePath);
+  if (relCheck.startsWith("..") || path.isAbsolute(relCheck)) {
+    throw new Error(`${label} escapes the document root.`);
+  }
+  return absolutePath;
+}

package/template/core/engine/runtime/source-text-tools.d.mts

@@ -0,0 +1,102 @@
+import type { ResolvedConfig } from "./config.mjs";
+
+export type SourceTextScope = "content" | "all";
+
+export type SourceTextMatch = {
+  id: string;
+  scope: string;
+  file: string;
+  path: string;
+  line: number;
+  column: number;
+  index: number;
+  text: string;
+  preview: string;
+};
+
+export type SourceTextFileSummary = {
+  scope: string;
+  file: string;
+  path: string;
+  matchCount: number;
+};
+
+export type SourceSearchReport = {
+  kind: "search";
+  query: string;
+  scope: SourceTextScope;
+  caseSensitive: boolean;
+  matchCount: number;
+  files: Array<SourceTextFileSummary>;
+  matches: Array<SourceTextMatch>;
+};
+
+export type SourceBlockTextEditInput = {
+  config: ResolvedConfig;
+  path: string;
+  source: {
+    line: number;
+    column?: number;
+    endLine?: number;
+    endColumn?: number;
+  };
+  text: string;
+  kind?: string;
+  name?: string;
+  blockId?: string;
+  cellIndex?: number;
+  sourceMode?: boolean;
+};
+
+export type SourceBlockTextEdit = {
+  blockId?: string;
+  path: string;
+  requestedPath: string;
+  file: string;
+  line: number;
+  column: number;
+  endLine: number;
+  endColumn: number;
+  before: string;
+  after: string;
+  text: string;
+  cellIndex?: number;
+};
+
+export function searchSourceText(options: {
+  config: ResolvedConfig;
+  query: string;
+  scope?: SourceTextScope;
+  caseSensitive?: boolean;
+}): Promise<SourceSearchReport>;
+
+export function applySourceBlockTextEdit(options: SourceBlockTextEditInput): Promise<SourceBlockTextEdit>;
+
+export function applySourceBlockTextEditToText(documentText: string, options: Omit<SourceBlockTextEditInput, "config" | "path">): {
+  text: string;
+  edit: Omit<SourceBlockTextEdit, "path" | "requestedPath" | "file">;
+};
+
+export function readSourceBlockText(options: Pick<SourceBlockTextEditInput, "config" | "path" | "source">): Promise<{
+  path: string;
+  requestedPath: string;
+  file: string;
+  text: string;
+}>;
+
+export function readSourceBlockTextFromText(documentText: string, options: Pick<SourceBlockTextEditInput, "source">): string;
+
+export function applySourceBlockSourceEditToText(documentText: string, options: Pick<SourceBlockTextEditInput, "source" | "text" | "blockId">): {
+  text: string;
+  edit: Omit<SourceBlockTextEdit, "path" | "requestedPath" | "file">;
+};
+
+export function collectSourceTextFiles(config: ResolvedConfig, options?: {
+  scope?: SourceTextScope;
+}): Promise<Array<{
+  scope: string;
+  name: string;
+  absolutePath: string;
+  relativePath: string;
+  text: string;
+}>>;