@particle-academy/holy-sheet 2.10.1 → 2.10.2

package/dist/index.d.cts

@@ -264,7 +264,7 @@ interface SetMetaOp {
 }
 
 /** This package's own version, pinned to package.json by `version.test.ts`. */
-declare const VERSION = "2.10.1";
+declare const VERSION = "2.10.2";
 type Any$6 = any;
 /**
  * Agent — the structured-tool surface for Holy Sheet. Mirrors PHP `Agent`.
@@ -342,7 +342,7 @@ type Any$5 = any;
  * over `Agent`. Provided for parity / DI ergonomics; most callers use `Agent`.
  */
 declare class HolySheet {
-    static readonly VERSION = "2.10.1";
+    static readonly VERSION = "2.10.2";
     validate(schema: Any$5): ValidationError[];
     toBytes(schema: Any$5): Uint8Array;
     write(schema: Any$5, path: string): Promise<WriteResult>;
@@ -357,6 +357,11 @@ declare class HolySheet {
     static version(): string;
 }
 
+/** Bounded archive/security refusal; contains no document names or content. */
+declare class ArchiveRefused extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
 /** Thrown when a Holy Sheet schema fails validation. Mirrors PHP `SchemaException`. */
 declare class SchemaException extends Error {
     readonly errors: ValidationError[];
@@ -382,6 +387,14 @@ declare class UnsupportedFormatException extends Error {
     static unknownPackage(path: string | null, mimetype: string | null): UnsupportedFormatException;
 }
 
+interface ArchiveLimits {
+    maxArchiveBytes?: number;
+    maxEntries?: number;
+    maxPartBytes?: number;
+    maxExpandedBytes?: number;
+    maxCompressionRatio?: number;
+}
+
 type Any$4 = any;
 /** Hand-rolled schema validator. Mirrors PHP `Schema\Validator`. */
 declare class Validator {
@@ -909,6 +922,7 @@ interface ZipFile {
 }
 declare function zipSync(files: ZipFile[]): Uint8Array;
 
-declare function unzipSync(data: Uint8Array): Record<string, Uint8Array>;
+/** STORE/DEFLATE reader with metadata, CRC, duplicate and expansion checks. */
+declare function unzipSync(data: Uint8Array, limits?: ArchiveLimits): Record<string, Uint8Array>;
 
-export { type AddSheetOp, Agent, type AggOp, ArrayBuilder, type BuilderOptions, CellAddress, type CellData, type CellFormatInput, type CellPrimitive, type ChartSchema, type ClearCellOp, type ColumnSchema, type ColumnType, type CommentInput, CsvBuilder, type DeleteColumnsOp, type DeleteRowsOp, type DisplayFormat, FormatSniffer, FormulaLinter, type FormulaProblem, HolySheet, type HolySheetSchema, Inference, type InsertColumnsOp, type InsertRowsOp, type MoveSheetOp, Normalizer, OdsReader, type RemoveSheetOp, type RenameSheetOp, type RepairResult, Repairer, type ReplaceSheetOp, type RowCell, SchemaException, type SetCellOp, type SetColumnWidthsOp, type SetFrozenOp, type SetMergedRegionsOp, type SetMetaOp, type SetRangeOp, type SetWorkbookOp, SheetDiff, type SheetOp, SheetOpSchema, type SheetOpType, SheetReducer, type SheetSchema, type SpreadsheetFormat, Theme, type ThemeKey, UnsupportedFormatException, VERSION, type ValidationError, Validator, type WriteResult, XlsxReader, XlsxWriter, type ZipFile, unzipSync, zipSync };
+export { type AddSheetOp, Agent, type AggOp, type ArchiveLimits, ArchiveRefused, ArrayBuilder, type BuilderOptions, CellAddress, type CellData, type CellFormatInput, type CellPrimitive, type ChartSchema, type ClearCellOp, type ColumnSchema, type ColumnType, type CommentInput, CsvBuilder, type DeleteColumnsOp, type DeleteRowsOp, type DisplayFormat, FormatSniffer, FormulaLinter, type FormulaProblem, HolySheet, type HolySheetSchema, Inference, type InsertColumnsOp, type InsertRowsOp, type MoveSheetOp, Normalizer, OdsReader, type RemoveSheetOp, type RenameSheetOp, type RepairResult, Repairer, type ReplaceSheetOp, type RowCell, SchemaException, type SetCellOp, type SetColumnWidthsOp, type SetFrozenOp, type SetMergedRegionsOp, type SetMetaOp, type SetRangeOp, type SetWorkbookOp, SheetDiff, type SheetOp, SheetOpSchema, type SheetOpType, SheetReducer, type SheetSchema, type SpreadsheetFormat, Theme, type ThemeKey, UnsupportedFormatException, VERSION, type ValidationError, Validator, type WriteResult, XlsxReader, XlsxWriter, type ZipFile, unzipSync, zipSync };

package/dist/index.d.ts

@@ -264,7 +264,7 @@ interface SetMetaOp {
 }
 
 /** This package's own version, pinned to package.json by `version.test.ts`. */
-declare const VERSION = "2.10.1";
+declare const VERSION = "2.10.2";
 type Any$6 = any;
 /**
  * Agent — the structured-tool surface for Holy Sheet. Mirrors PHP `Agent`.
@@ -342,7 +342,7 @@ type Any$5 = any;
  * over `Agent`. Provided for parity / DI ergonomics; most callers use `Agent`.
  */
 declare class HolySheet {
-    static readonly VERSION = "2.10.1";
+    static readonly VERSION = "2.10.2";
     validate(schema: Any$5): ValidationError[];
     toBytes(schema: Any$5): Uint8Array;
     write(schema: Any$5, path: string): Promise<WriteResult>;
@@ -357,6 +357,11 @@ declare class HolySheet {
     static version(): string;
 }
 
+/** Bounded archive/security refusal; contains no document names or content. */
+declare class ArchiveRefused extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
 /** Thrown when a Holy Sheet schema fails validation. Mirrors PHP `SchemaException`. */
 declare class SchemaException extends Error {
     readonly errors: ValidationError[];
@@ -382,6 +387,14 @@ declare class UnsupportedFormatException extends Error {
     static unknownPackage(path: string | null, mimetype: string | null): UnsupportedFormatException;
 }
 
+interface ArchiveLimits {
+    maxArchiveBytes?: number;
+    maxEntries?: number;
+    maxPartBytes?: number;
+    maxExpandedBytes?: number;
+    maxCompressionRatio?: number;
+}
+
 type Any$4 = any;
 /** Hand-rolled schema validator. Mirrors PHP `Schema\Validator`. */
 declare class Validator {
@@ -909,6 +922,7 @@ interface ZipFile {
 }
 declare function zipSync(files: ZipFile[]): Uint8Array;
 
-declare function unzipSync(data: Uint8Array): Record<string, Uint8Array>;
+/** STORE/DEFLATE reader with metadata, CRC, duplicate and expansion checks. */
+declare function unzipSync(data: Uint8Array, limits?: ArchiveLimits): Record<string, Uint8Array>;
 
-export { type AddSheetOp, Agent, type AggOp, ArrayBuilder, type BuilderOptions, CellAddress, type CellData, type CellFormatInput, type CellPrimitive, type ChartSchema, type ClearCellOp, type ColumnSchema, type ColumnType, type CommentInput, CsvBuilder, type DeleteColumnsOp, type DeleteRowsOp, type DisplayFormat, FormatSniffer, FormulaLinter, type FormulaProblem, HolySheet, type HolySheetSchema, Inference, type InsertColumnsOp, type InsertRowsOp, type MoveSheetOp, Normalizer, OdsReader, type RemoveSheetOp, type RenameSheetOp, type RepairResult, Repairer, type ReplaceSheetOp, type RowCell, SchemaException, type SetCellOp, type SetColumnWidthsOp, type SetFrozenOp, type SetMergedRegionsOp, type SetMetaOp, type SetRangeOp, type SetWorkbookOp, SheetDiff, type SheetOp, SheetOpSchema, type SheetOpType, SheetReducer, type SheetSchema, type SpreadsheetFormat, Theme, type ThemeKey, UnsupportedFormatException, VERSION, type ValidationError, Validator, type WriteResult, XlsxReader, XlsxWriter, type ZipFile, unzipSync, zipSync };
+export { type AddSheetOp, Agent, type AggOp, type ArchiveLimits, ArchiveRefused, ArrayBuilder, type BuilderOptions, CellAddress, type CellData, type CellFormatInput, type CellPrimitive, type ChartSchema, type ClearCellOp, type ColumnSchema, type ColumnType, type CommentInput, CsvBuilder, type DeleteColumnsOp, type DeleteRowsOp, type DisplayFormat, FormatSniffer, FormulaLinter, type FormulaProblem, HolySheet, type HolySheetSchema, Inference, type InsertColumnsOp, type InsertRowsOp, type MoveSheetOp, Normalizer, OdsReader, type RemoveSheetOp, type RenameSheetOp, type RepairResult, Repairer, type ReplaceSheetOp, type RowCell, SchemaException, type SetCellOp, type SetColumnWidthsOp, type SetFrozenOp, type SetMergedRegionsOp, type SetMetaOp, type SetRangeOp, type SetWorkbookOp, SheetDiff, type SheetOp, SheetOpSchema, type SheetOpType, SheetReducer, type SheetSchema, type SpreadsheetFormat, Theme, type ThemeKey, UnsupportedFormatException, VERSION, type ValidationError, Validator, type WriteResult, XlsxReader, XlsxWriter, type ZipFile, unzipSync, zipSync };