@poe-platform/safe-bash 0.1.756 → 0.1.758

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.758",
   "description": "Extensible virtual shell with pluggable filesystems and streaming commands",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,10 @@
       "types": "./dist/pdf-ast/index.d.ts",
       "import": "./dist/pdf-ast/index.js"
     },
+    "./ssconvert/commands": {
+      "types": "./dist/safe-bash-command-ssconvert/commands.d.ts",
+      "import": "./dist/safe-bash-command-ssconvert/commands.js"
+    },
     "./mcp": {
       "types": "./dist/safe-bash-mcp/index.d.ts",
       "import": "./dist/safe-bash-mcp/index.js"
@@ -837,7 +841,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@poe-platform/safe-fs": "0.1.756",
+    "@poe-platform/safe-fs": "0.1.758",
     "pdf-lib": "1.17.1",
     "@noble/hashes": "2.4.0",
     "pako": "3.0.1",

package/third-party/pdf-ast/THIRD_PARTY_NOTICES.md

@@ -295,3 +295,19 @@ tables and clear the high byte only for F000–F0FF. The TrueType reader records
 the selected cmap's encoding. Tests in `src/fonts/cid-to-gid.test.ts` cover
 raw and prefixed symbol codes plus the original issue2948 fixture at the
 same pinned PDF.js revision documented above.
+
+Pattern-painted stencils follow PDF.js `CanvasGraphics._createMaskCanvas`:
+the current pattern is painted in page coordinates through transformed mask
+alpha, rather than coloring the source mask pixels. `stencil-pattern.test.ts`
+ports the original `issue13372` equality fixture and adds memory-only coverage
+for inline masks, rotation, inverted Decode, alpha, one-pixel masks, and tiling.
+The source fixture and hashes are recorded in `src/fixtures/SOURCES.md`.
+The one-pixel gradient expectation is independently verified by Poppler and
+MuPDF; PDF.js's `paintSolidColorImageMask` optimization loses that pattern.
+
+Malformed dictionary-key recovery follows PDF.js `Parser.getObj`, skipping
+stray non-Name tokens only in local repair mode. Damaged optional ToUnicode
+streams follow `PartialEvaluator.readToUnicode` error recovery while retaining
+local resource-limit errors. `dictionary-recovery.test.ts` ports the original
+`issue11549` equality fixture and covers ordinary/compressed dictionaries,
+trailer metadata, strict mode, and explicit limits.