@poe-platform/safe-bash 0.1.756 → 0.1.757

package/dist/safe-bash-contracts/filesystem-descriptor.js

@@ -1,6 +1,6 @@
 import {
   openCommandFile
-} from "../safe-bash/command-chunks/chunk-7KS6PX4U.js";
+} from "../safe-bash/command-chunks/chunk-KSIGF4AG.js";
 import "../safe-bash/command-chunks/chunk-PTLDMI4O.js";
 import "../safe-bash/command-chunks/chunk-U6CJOXRY.js";
 import "../safe-bash/command-chunks/chunk-WYJTWJZ5.js";

package/dist/safe-bash-contracts/filesystem-output.js

@@ -1,6 +1,6 @@
 import {
   openCommandFile
-} from "../safe-bash/command-chunks/chunk-7KS6PX4U.js";
+} from "../safe-bash/command-chunks/chunk-KSIGF4AG.js";
 import {
   assertCountedFileOutput,
   bindFileOutputBudget,

package/dist/safe-bash-mcp/index.js

@@ -14397,7 +14397,7 @@ function forwardFileDescriptor(descriptor, operation, capabilities, snapshot = (
     write: (retained, buffer, position, options) => operation("write", options, () => retained.write(buffer, position, options)),
     truncate: (retained, length, options) => operation("ftruncate", options, () => retained.truncate(length, options)),
     sync: (retained, dataOnly, options) => operation(dataOnly ? "fdatasync" : "fsync", options, () => retained.sync(dataOnly, options)),
-    close: (retained) => operation("close", {}, () => retained.close())
+    close: (retained, options) => operation("close", {}, () => retained.close(options))
   };
 }
 function integer(value, syscall, path6) {
@@ -14565,10 +14565,10 @@ var ManagedFileDescriptor = class {
       await backend.sync(backend.resource, dataOnly, forwarded);
     });
   }
-  close() {
+  close(options = {}) {
     this.#closing ??= this.#pending.then(async () => {
       try {
-        await this.#backend.close(this.#backend.resource);
+        await this.#backend.close(this.#backend.resource, options);
       } finally {
         this.#backend = void 0;
         this.#getPosition = void 0;
@@ -14626,7 +14626,7 @@ async function openFileDescriptor(path6, options, capabilities, acquire) {
     signal?.throwIfAborted();
     return descriptor;
   } catch (error) {
-    await finishCleanup(() => backend.close(backend.resource), true);
+    await finishCleanup(() => backend.close(backend.resource, {}), true);
     signal?.throwIfAborted();
     throw error;
   }

package/dist/spreadsheet-engine/formulas/ast.d.ts

@@ -13,6 +13,17 @@ export interface Axis {
     readonly value: number;
     readonly relative: boolean;
 }
+/** A binary-format name use retains identity while copies displace its definition.
+ * Offsets apply to references resolved at the current definition's declaration
+ * anchor. Copy adds row/column deltas only in relative mode and always adds tab
+ * displacement unless sheetRelative is false; moving leaves offsets intact. */
+export interface NameRelocation {
+    readonly relative: boolean;
+    readonly row: number;
+    readonly column: number;
+    readonly sheet: number;
+    readonly sheetRelative?: boolean;
+}
 export interface ReferenceEndpoint {
     readonly row?: Axis;
     readonly column?: Axis;
@@ -62,6 +73,7 @@ export type FormulaNode = Span & ({
     readonly kind: "name";
     readonly name: string;
     readonly sheet?: string;
+    readonly relocation?: NameRelocation;
     /** Empty means the current workbook; without a sheet it selects only global names. */
     readonly workbook?: string;
 } | {
@@ -117,6 +129,7 @@ export interface FormulaGrammar {
     readonly quotedLabels?: "openformula" | "calc";
     /** Permit ssconvert's live label anchors in internal workbook expressions. */
     readonly internalLabels?: boolean;
+    readonly internalNames?: boolean;
     readonly quotedErrors?: boolean;
     readonly rangeSeparator?: string;
     readonly sheetSpans?: boolean;

package/dist/spreadsheet-engine/formulas/conventions.js

@@ -25,7 +25,7 @@ export const odfGrammar = Object.freeze({ ...gnumericGrammar,
     prefixes: Object.freeze(["of:=", "oooc:=", "="]), functionPrefixes: Object.freeze(["ORG.GNUMERIC.", "COM.MICROSOFT."])
 });
 /** Internal OpenFormula preserves relative sheets alongside live label anchors. */
-export const internalOdfGrammar = Object.freeze({ ...odfGrammar, internalLabels: true });
+export const internalOdfGrammar = Object.freeze({ ...odfGrammar, internalLabels: true, internalNames: true });
 export const sylkGrammar = Object.freeze({ ...gnumericGrammar, id: "sylk", address: "r1c1" });
 /** Native SYLK output quotes strings without escaping; its reader does not invert that operation. */
 export const sylkWriterGrammar = Object.freeze({ ...sylkGrammar, id: "sylk-writer", stringEscape: "raw" });

package/dist/spreadsheet-engine/formulas/dependencies.js

@@ -80,7 +80,7 @@ export function buildDependencyGraph(book, roots, resolve, parse, tick, onRange,
             const name = named(node, position);
             if (!name || names.has(name))
                 return [];
-            return staticRanges(parseNamedExpression(name, book, parse, tick, maximumDepth), position, new Set([...names, name]), depth + 1);
+            return staticRanges(parseNamedExpression(name, book, parse, tick, maximumDepth, node.relocation), position, new Set([...names, name]), depth + 1);
         }
         if (node.kind === "call" && (node.name === "IF" || node.name === "CHOOSE")) {
             const ranges = [];
@@ -188,7 +188,7 @@ export function buildDependencyGraph(book, roots, resolve, parse, tick, onRange,
             if (node.kind === "name" && (node.workbook === undefined || node.workbook === "")) {
                 const name = named(node, position);
                 if (name && !names.has(name)) {
-                    pending.push({ node: parseNamedExpression(name, book, parse, tick, maximumDepth), position, names: new Set([...names, name]), depth: depth + 1 });
+                    pending.push({ node: parseNamedExpression(name, book, parse, tick, maximumDepth, node.relocation), position, names: new Set([...names, name]), depth: depth + 1 });
                 }
             }
             const children = node.kind === "unary" || node.kind === "parentheses" ? [node.child] : node.kind === "binary" ? [node.left, node.right] : node.kind === "call" ? node.args : node.kind === "array" ? node.rows.flat() : [];

package/dist/spreadsheet-engine/formulas/evaluator.js

@@ -175,7 +175,7 @@ export function* recalculateWorkbookSteps(input, context, options = false, onDia
         const name = book.names?.find(entry => entry.sheet === sheet && matches(entry)) ?? book.names?.find(entry => entry.sheet === undefined && matches(entry));
         if (!name || names.has(name))
             return error("#REF!");
-        return indirectRange(parseNamedExpression(name, book, parse, tick, context.limits.formulaDependencyDepth ?? Infinity), position, new Set([...names, name]), depth + 1);
+        return indirectRange(parseNamedExpression(name, book, parse, tick, context.limits.formulaDependencyDepth ?? Infinity, node.relocation), position, new Set([...names, name]), depth + 1);
     }
     function scalar(value, position) {
         // OpenFormula §5.10.4 selects at the formula position when the consumer
@@ -264,7 +264,7 @@ export function* recalculateWorkbookSteps(input, context, options = false, onDia
                 const name = book.names?.find(entry => entry.sheet === sheet && matches(entry)) ?? book.names?.find(entry => entry.sheet === undefined && matches(entry));
                 if (!name || names.has(name))
                     return error("#NAME?");
-                return evaluate(parseNamedExpression(name, book, parse, tick, context.limits.formulaDependencyDepth ?? Infinity), position, array, new Set([...names, name]), wantReference);
+                return evaluate(parseNamedExpression(name, book, parse, tick, context.limits.formulaDependencyDepth ?? Infinity, node.relocation), position, array, new Set([...names, name]), wantReference);
             }
             if (node.kind === "unary") {
                 const apply = (value) => {

package/dist/spreadsheet-engine/formulas/named-expressions.d.ts

@@ -1,6 +1,6 @@
 import { type NamedExpression, type Workbook } from "../../spreadsheet-ast/index.js";
-import type { FormulaNode, ParsePosition } from "./ast.js";
+import type { FormulaNode, NameRelocation, ParsePosition } from "./ast.js";
 /** Parse relative offsets at the declaration anchor and bind nested names there.
  * References and functions in the resulting expression still use the caller's
  * evaluation position, as in native expr_name_eval. */
-export declare function parseNamedExpression(name: NamedExpression, book: Workbook, parse: (source: string, position: ParsePosition, arrayStringLiterals?: boolean) => FormulaNode, tick: () => void, maximumDepth?: number): FormulaNode;
+export declare function parseNamedExpression(name: NamedExpression, book: Workbook, parse: (source: string, position: ParsePosition, arrayStringLiterals?: boolean) => FormulaNode, tick: () => void, maximumDepth?: number, relocation?: NameRelocation): FormulaNode;

package/dist/spreadsheet-engine/formulas/named-expressions.js

@@ -4,23 +4,49 @@ import { foldSheetName } from "../../spreadsheet-ast/case-fold.js";
 /** Parse relative offsets at the declaration anchor and bind nested names there.
  * References and functions in the resulting expression still use the caller's
  * evaluation position, as in native expr_name_eval. */
-export function parseNamedExpression(name, book, parse, tick, maximumDepth = Infinity) {
+export function parseNamedExpression(name, book, parse, tick, maximumDepth = Infinity, relocation) {
     if (name.expression === "" || name.expression === "=") {
         tick();
         return { kind: "literal", value: { kind: "blank" }, start: 0, end: 0 };
     }
     const position = name.position ?? { sheet: name.sheet ?? book.sheets[0]?.id ?? "", row: 0, column: 0 };
+    function displace(ref, fallback) {
+        if (!relocation || ref.workbook !== undefined)
+            return ref;
+        const origin = book.sheets.findIndex(sheet => sheet.id === position.sheet);
+        const index = ref.sheetRelative ? origin + (ref.sheetOffset ?? 0) : ref.sheet !== undefined || fallback !== undefined
+            ? book.sheets.findIndex(sheet => foldSheetName(sheet.name) === foldSheetName(ref.sheet ?? fallback)) : origin;
+        const target = index >= 0 ? book.sheets[index + relocation.sheet] : undefined;
+        if (!target)
+            return undefined;
+        const axis = (value, key) => ({ value: value.value + (value.relative ? position[key] : 0) + relocation[key], relative: false });
+        return { ...ref, sheet: target.name, sheetRelative: false, ...(ref.row ? { row: axis(ref.row, "row") } : {}), ...(ref.column ? { column: axis(ref.column, "column") } : {}) };
+    }
     function bind(node, depth = 0) {
         tick();
         if (depth > maximumDepth)
             throw new SsconvertError("resource-limit", "ssconvert formula dependency depth limit exceeded");
-        if (node.kind === "name" && (node.workbook === undefined || node.workbook === "" && node.sheet !== undefined)) {
+        if (node.kind === "reference" && relocation) {
+            const first = displace(node.first), last = node.last ? displace(node.last, node.first.sheet) : undefined;
+            if (!first || node.last && !last)
+                return { kind: "literal", value: { kind: "error", value: "#REF!" }, start: node.start, end: node.end };
+            return { ...node, first, ...(last ? { last } : {}) };
+        }
+        if (node.kind === "name" && (node.workbook === undefined || node.workbook === "")) {
+            const inherited = relocation ? { ...relocation,
+                row: relocation.row + (node.relocation?.row ?? 0), column: relocation.column + (node.relocation?.column ?? 0),
+                sheet: relocation.sheet + (node.relocation?.sheet ?? 0) } : node.relocation;
+            const bound = inherited ? { ...node, relocation: inherited } : node;
+            if (node.workbook === "" && node.sheet === undefined)
+                return bound;
             const scope = node.sheet === undefined ? name.sheet : book.sheets.find(sheet => foldSheetName(sheet.name) === foldSheetName(node.sheet))?.id;
             const target = resolveName(book, node.name, scope);
-            if (target?.sheet === undefined)
-                return { kind: "name", name: node.name, workbook: "", start: node.start, end: node.end };
+            if (target?.sheet === undefined) {
+                const { sheet: ignoredSheet, ...global } = bound;
+                return { ...global, workbook: "" };
+            }
             const sheet = book.sheets.find(sheet => sheet.id === target.sheet);
-            return sheet ? { ...node, sheet: sheet.name } : node;
+            return sheet ? { ...bound, sheet: sheet.name } : bound;
         }
         if (node.kind === "parentheses" || node.kind === "unary")
             return { ...node, child: bind(node.child, depth + 1) };

package/dist/spreadsheet-engine/formulas/parser.js

@@ -335,6 +335,40 @@ export function parseExpression(source, options) {
             throw new SsconvertError("resource-limit", "ssconvert formula node limit exceeded");
         try {
             const c = source[offset];
+            if (source.startsWith("@name.", offset)) {
+                if (grammar.id !== "gnumeric" && !grammar.internalNames)
+                    fail("Internal live name in native formula");
+                offset += 6;
+                const relative = source.startsWith("relative", offset);
+                if (!relative && !source.startsWith("absolute", offset))
+                    fail("Invalid live name mode");
+                offset += 8;
+                const fixedSheet = source.startsWith(".fixed-sheet", offset);
+                if (fixedSheet)
+                    offset += 12;
+                if (source[offset++] !== "[")
+                    fail("Invalid live name mode");
+                const displacement = (separator) => {
+                    const start = offset;
+                    if (source[offset] === "-")
+                        offset++;
+                    const begin = offset;
+                    while (digit(source[offset]))
+                        offset++;
+                    const value = Number(source.slice(start, offset));
+                    if (offset === begin || !Number.isSafeInteger(value) || source[offset++] !== separator)
+                        fail("Invalid live name displacement");
+                    return value;
+                };
+                const row = displacement(","), column = displacement(","), sheet = displacement("]");
+                if (!relative && (row !== 0 || column !== 0) || source[offset++] !== ":" || source[offset] !== '"')
+                    fail("Invalid live name");
+                const name = quoted('"', grammar.stringEscape);
+                if (!name)
+                    fail("Empty live name");
+                options.onName?.(name);
+                return node({ kind: "name", name, workbook: "", relocation: { relative, row, column, sheet, ...(fixedSheet ? { sheetRelative: false } : {}) }, start, end: offset });
+            }
             if (c === "@" && !internalLabels)
                 fail("Internal label reference in native formula");
             if (c === "@" && internalLabels) {

package/dist/spreadsheet-engine/formulas/rewriting.js

@@ -1,6 +1,6 @@
 import { SsconvertError } from "../contracts.js";
 import { foldSheetName } from "../../spreadsheet-ast/case-fold.js";
-import { serializeReference, serializeLabelReference, quoteFormulaString } from "./serialization.js";
+import { serializeExpression, serializeReference, serializeLabelReference, quoteFormulaString } from "./serialization.js";
 export function visitFormula(node, visitor) {
     visitor(node);
     if (node.kind === "unary" || node.kind === "parentheses")
@@ -106,6 +106,24 @@ export function rewriteReferences(document, edit) {
                         : serializeReference(first, last, document.grammar, position) });
             }
         }
+        else if (node.kind === "name" && node.relocation && edit.translation === "copy") {
+            const relocation = { ...node.relocation };
+            if (relocation.relative) {
+                relocation.row += target.row - document.position.row;
+                relocation.column += target.column - document.position.column;
+            }
+            if (relocation.sheetRelative !== false && target.sheet !== document.position.sheet) {
+                const origin = document.sheetOrder?.indexOf(document.position.sheet) ?? -1;
+                const destination = document.sheetOrder?.indexOf(target.sheet) ?? -1;
+                if (origin < 0 || destination < 0)
+                    throw new SsconvertError("invalid-request", "Cross-sheet formula copy requires workbook tab order");
+                relocation.sheet += destination - origin;
+            }
+            if (![relocation.row, relocation.column, relocation.sheet].every(Number.isSafeInteger))
+                throw new SsconvertError("invalid-request", "Invalid live name displacement");
+            const text = serializeExpression({ ...document, root: { ...node, relocation } }, document.grammar, false).slice(document.grammar.prefixes[0]?.length ?? 0);
+            changes.push({ start: node.start, end: node.end, text });
+        }
         else if (node.kind === "name" && (node.workbook === undefined || node.workbook === "") && node.sheet && renamedSheet(node.sheet) !== undefined) {
             const text = quoteFormulaString(renamedSheet(node.sheet), "'", document.grammar) + document.grammar.sheetSeparator + node.name;
             changes.push({ start: node.start, end: node.end, text: document.grammar.bracketReferences ? "[" + text + "]" : text });

package/dist/spreadsheet-engine/formulas/serialization.js

@@ -161,6 +161,12 @@ export function serializeExpression(document, grammar = document.grammar, preser
             case "reference": return value.label ? grammar.quotedLabels === "openformula" && options.quotedLabel
                 ? quoteFormulaString(options.quotedLabel(value), "'", grammar) : serializeLabelReference(value, grammar, position) : serializeReference(options.relativeSheets === "fixed" ? { ...value.first, sheetRelative: false } : value.first, options.relativeSheets === "fixed" && value.last ? { ...value.last, sheetRelative: false } : value.last, grammar, position);
             case "name": {
+                if (value.relocation) {
+                    if (grammar.id !== "gnumeric" && !grammar.internalNames)
+                        throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: live name relocation in target grammar");
+                    const { relative, row, column, sheet } = value.relocation;
+                    return `@name.${relative ? "relative" : "absolute"}${value.relocation.sheetRelative === false ? ".fixed-sheet" : ""}[${row},${column},${sheet}]:` + quoteFormulaString(value.name, '"', grammar);
+                }
                 if (grammar.qualifiedNames === false && (value.sheet !== undefined || value.workbook !== undefined))
                     throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: qualified formula name in target grammar");
                 if (value.workbook === "" && grammar.bracketReferences && value.sheet === undefined)

package/dist/spreadsheet-format-xls/biff-write-formulas.js

@@ -366,6 +366,8 @@ export class BiffFormulaWriter {
                     push(first);
             }
             else if (node.kind === "name") {
+                if (node.relocation)
+                    throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: live name relocation in BIFF output");
                 if (node.workbook) {
                     const bookIndex = this.externalBook(node.workbook), book = this.externalBooks[bookIndex];
                     const scope = node.sheet === undefined ? undefined : this.externalScope(bookIndex, node.sheet);

package/dist/xlsx-ast/formula-semantics.js

@@ -19,6 +19,8 @@ export function nativeOpenFormula(source, position, context, arrayStringLiterals
             throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: automatic label intersection in Gnumeric output");
         if (node.kind === "reference" && node.label)
             throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: live label reference in Gnumeric output");
+        if (node.kind === "name" && node.relocation)
+            throw new SsconvertError("unsupported-feature", "Unsupported ssconvert feature: live name relocation in Gnumeric output");
     });
     if (!source.startsWith("of:="))
         return source;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@poe-platform/safe-bash",
-  "version": "0.1.756",
+  "version": "0.1.757",
   "description": "Extensible virtual shell with pluggable filesystems and streaming commands",
   "type": "module",
   "license": "MIT",
@@ -837,7 +837,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.756",
+    "@poe-platform/safe-fs": "0.1.757",
     "pdf-lib": "1.17.1",
     "@noble/hashes": "2.4.0",
     "pako": "3.0.1",