@cesarandreslopez/occ 0.3.1 → 0.4.1

package/dist/src/sheet/types.d.ts

@@ -0,0 +1,472 @@
+import { z } from 'zod';
+export declare const SheetVisibilitySchema: z.ZodEnum<{
+    visible: "visible";
+    hidden: "hidden";
+    very_hidden: "very_hidden";
+}>;
+export type SheetVisibility = z.infer<typeof SheetVisibilitySchema>;
+export declare const HeaderSelectionModeSchema: z.ZodEnum<{
+    auto: "auto";
+    none: "none";
+    explicit: "explicit";
+}>;
+export type HeaderSelectionMode = z.infer<typeof HeaderSelectionModeSchema>;
+export declare const ColumnValueTypeSchema: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    unknown: "unknown";
+    date: "date";
+    error: "error";
+    blank_stub: "blank_stub";
+}>;
+export type ColumnValueType = z.infer<typeof ColumnValueTypeSchema>;
+export declare const InspectSheetOptionsSchema: z.ZodObject<{
+    sheet: z.ZodOptional<z.ZodString>;
+    sampleRows: z.ZodNumber;
+    headerRow: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"none">, z.ZodNumber]>;
+    maxColumns: z.ZodNumber;
+}, z.core.$strip>;
+export type InspectSheetOptions = z.infer<typeof InspectSheetOptionsSchema>;
+export declare const DefinedNameInfoSchema: z.ZodObject<{
+    name: z.ZodString;
+    ref: z.ZodString;
+    scope: z.ZodEnum<{
+        sheet: "sheet";
+        workbook: "workbook";
+    }>;
+    sheetIndex: z.ZodOptional<z.ZodNumber>;
+    sheetName: z.ZodOptional<z.ZodString>;
+    external: z.ZodBoolean;
+}, z.core.$strip>;
+export type DefinedNameInfo = z.infer<typeof DefinedNameInfoSchema>;
+export declare const WorkbookPropertiesSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    subject: z.ZodOptional<z.ZodString>;
+    author: z.ZodOptional<z.ZodString>;
+    company: z.ZodOptional<z.ZodString>;
+    manager: z.ZodOptional<z.ZodString>;
+    createdDate: z.ZodOptional<z.ZodString>;
+    modifiedDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type WorkbookProperties = z.infer<typeof WorkbookPropertiesSchema>;
+export declare const WorkbookRiskFlagsSchema: z.ZodObject<{
+    hiddenSheets: z.ZodBoolean;
+    formulas: z.ZodBoolean;
+    comments: z.ZodBoolean;
+    hyperlinks: z.ZodBoolean;
+    mergedCells: z.ZodBoolean;
+    protectedSheets: z.ZodBoolean;
+    externalFormulaRefs: z.ZodBoolean;
+}, z.core.$strip>;
+export type WorkbookRiskFlags = z.infer<typeof WorkbookRiskFlagsSchema>;
+export declare const CellTypeCountsSchema: z.ZodObject<{
+    string: z.ZodNumber;
+    number: z.ZodNumber;
+    boolean: z.ZodNumber;
+    date: z.ZodNumber;
+    error: z.ZodNumber;
+    blankStub: z.ZodNumber;
+}, z.core.$strip>;
+export type CellTypeCounts = z.infer<typeof CellTypeCountsSchema>;
+export declare const ColumnProfileSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    letter: z.ZodString;
+    name: z.ZodString;
+    dominantType: z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        unknown: "unknown";
+        date: "date";
+        error: "error";
+        blank_stub: "blank_stub";
+    }>;
+    nonEmptyCount: z.ZodNumber;
+    nonEmptyRatio: z.ZodNumber;
+    examples: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ColumnProfile = z.infer<typeof ColumnProfileSchema>;
+export declare const SampleRowSchema: z.ZodObject<{
+    rowNumber: z.ZodNumber;
+    values: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strip>;
+export type SampleRow = z.infer<typeof SampleRowSchema>;
+export declare const SheetProfileSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    name: z.ZodString;
+    visibility: z.ZodEnum<{
+        visible: "visible";
+        hidden: "hidden";
+        very_hidden: "very_hidden";
+    }>;
+    usedRange: z.ZodNullable<z.ZodString>;
+    totalRows: z.ZodNumber;
+    totalCols: z.ZodNumber;
+    rectangularRangeCellCount: z.ZodNumber;
+    nonEmptyCellCount: z.ZodNumber;
+    cellTypeCounts: z.ZodObject<{
+        string: z.ZodNumber;
+        number: z.ZodNumber;
+        boolean: z.ZodNumber;
+        date: z.ZodNumber;
+        error: z.ZodNumber;
+        blankStub: z.ZodNumber;
+    }, z.core.$strip>;
+    formulaCellCount: z.ZodNumber;
+    commentCellCount: z.ZodNumber;
+    hyperlinkCellCount: z.ZodNumber;
+    mergedRangeCount: z.ZodNumber;
+    hiddenRowCount: z.ZodNumber;
+    hiddenColumnCount: z.ZodNumber;
+    autoFilterRef: z.ZodNullable<z.ZodString>;
+    protected: z.ZodBoolean;
+    definedNames: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        ref: z.ZodString;
+        scope: z.ZodEnum<{
+            sheet: "sheet";
+            workbook: "workbook";
+        }>;
+        sheetIndex: z.ZodOptional<z.ZodNumber>;
+        sheetName: z.ZodOptional<z.ZodString>;
+        external: z.ZodBoolean;
+    }, z.core.$strip>>;
+    externalFormulaRefCount: z.ZodNumber;
+    headerSelection: z.ZodObject<{
+        requested: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"none">, z.ZodNumber]>;
+        mode: z.ZodEnum<{
+            auto: "auto";
+            none: "none";
+            explicit: "explicit";
+        }>;
+        rowNumber: z.ZodNullable<z.ZodNumber>;
+    }, z.core.$strip>;
+    schema: z.ZodObject<{
+        truncated: z.ZodBoolean;
+        columns: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            letter: z.ZodString;
+            name: z.ZodString;
+            dominantType: z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                unknown: "unknown";
+                date: "date";
+                error: "error";
+                blank_stub: "blank_stub";
+            }>;
+            nonEmptyCount: z.ZodNumber;
+            nonEmptyRatio: z.ZodNumber;
+            examples: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    sample: z.ZodObject<{
+        truncatedRows: z.ZodBoolean;
+        truncatedColumns: z.ZodBoolean;
+        rows: z.ZodArray<z.ZodObject<{
+            rowNumber: z.ZodNumber;
+            values: z.ZodRecord<z.ZodString, z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    sampleTokenEstimate: z.ZodNumber;
+    fullTokenEstimate: z.ZodNumber;
+    estimateMethod: z.ZodLiteral<"full_scan">;
+}, z.core.$strip>;
+export type SheetProfile = z.infer<typeof SheetProfileSchema>;
+export declare const WorkbookInspectionSchema: z.ZodObject<{
+    file: z.ZodString;
+    format: z.ZodLiteral<"xlsx">;
+    size: z.ZodNumber;
+    properties: z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        subject: z.ZodOptional<z.ZodString>;
+        author: z.ZodOptional<z.ZodString>;
+        company: z.ZodOptional<z.ZodString>;
+        manager: z.ZodOptional<z.ZodString>;
+        createdDate: z.ZodOptional<z.ZodString>;
+        modifiedDate: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    customPropertyCount: z.ZodNumber;
+    customProperties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    sheetCount: z.ZodNumber;
+    visibleSheetCount: z.ZodNumber;
+    hiddenSheetCount: z.ZodNumber;
+    veryHiddenSheetCount: z.ZodNumber;
+    definedNames: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        ref: z.ZodString;
+        scope: z.ZodEnum<{
+            sheet: "sheet";
+            workbook: "workbook";
+        }>;
+        sheetIndex: z.ZodOptional<z.ZodNumber>;
+        sheetName: z.ZodOptional<z.ZodString>;
+        external: z.ZodBoolean;
+    }, z.core.$strip>>;
+    riskFlags: z.ZodObject<{
+        hiddenSheets: z.ZodBoolean;
+        formulas: z.ZodBoolean;
+        comments: z.ZodBoolean;
+        hyperlinks: z.ZodBoolean;
+        mergedCells: z.ZodBoolean;
+        protectedSheets: z.ZodBoolean;
+        externalFormulaRefs: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type WorkbookInspection = z.infer<typeof WorkbookInspectionSchema>;
+export declare const SheetInspectionResultSchema: z.ZodObject<{
+    workbook: z.ZodObject<{
+        file: z.ZodString;
+        format: z.ZodLiteral<"xlsx">;
+        size: z.ZodNumber;
+        properties: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+            subject: z.ZodOptional<z.ZodString>;
+            author: z.ZodOptional<z.ZodString>;
+            company: z.ZodOptional<z.ZodString>;
+            manager: z.ZodOptional<z.ZodString>;
+            createdDate: z.ZodOptional<z.ZodString>;
+            modifiedDate: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        customPropertyCount: z.ZodNumber;
+        customProperties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        sheetCount: z.ZodNumber;
+        visibleSheetCount: z.ZodNumber;
+        hiddenSheetCount: z.ZodNumber;
+        veryHiddenSheetCount: z.ZodNumber;
+        definedNames: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            ref: z.ZodString;
+            scope: z.ZodEnum<{
+                sheet: "sheet";
+                workbook: "workbook";
+            }>;
+            sheetIndex: z.ZodOptional<z.ZodNumber>;
+            sheetName: z.ZodOptional<z.ZodString>;
+            external: z.ZodBoolean;
+        }, z.core.$strip>>;
+        riskFlags: z.ZodObject<{
+            hiddenSheets: z.ZodBoolean;
+            formulas: z.ZodBoolean;
+            comments: z.ZodBoolean;
+            hyperlinks: z.ZodBoolean;
+            mergedCells: z.ZodBoolean;
+            protectedSheets: z.ZodBoolean;
+            externalFormulaRefs: z.ZodBoolean;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+    sheets: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        name: z.ZodString;
+        visibility: z.ZodEnum<{
+            visible: "visible";
+            hidden: "hidden";
+            very_hidden: "very_hidden";
+        }>;
+        usedRange: z.ZodNullable<z.ZodString>;
+        totalRows: z.ZodNumber;
+        totalCols: z.ZodNumber;
+        rectangularRangeCellCount: z.ZodNumber;
+        nonEmptyCellCount: z.ZodNumber;
+        cellTypeCounts: z.ZodObject<{
+            string: z.ZodNumber;
+            number: z.ZodNumber;
+            boolean: z.ZodNumber;
+            date: z.ZodNumber;
+            error: z.ZodNumber;
+            blankStub: z.ZodNumber;
+        }, z.core.$strip>;
+        formulaCellCount: z.ZodNumber;
+        commentCellCount: z.ZodNumber;
+        hyperlinkCellCount: z.ZodNumber;
+        mergedRangeCount: z.ZodNumber;
+        hiddenRowCount: z.ZodNumber;
+        hiddenColumnCount: z.ZodNumber;
+        autoFilterRef: z.ZodNullable<z.ZodString>;
+        protected: z.ZodBoolean;
+        definedNames: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            ref: z.ZodString;
+            scope: z.ZodEnum<{
+                sheet: "sheet";
+                workbook: "workbook";
+            }>;
+            sheetIndex: z.ZodOptional<z.ZodNumber>;
+            sheetName: z.ZodOptional<z.ZodString>;
+            external: z.ZodBoolean;
+        }, z.core.$strip>>;
+        externalFormulaRefCount: z.ZodNumber;
+        headerSelection: z.ZodObject<{
+            requested: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"none">, z.ZodNumber]>;
+            mode: z.ZodEnum<{
+                auto: "auto";
+                none: "none";
+                explicit: "explicit";
+            }>;
+            rowNumber: z.ZodNullable<z.ZodNumber>;
+        }, z.core.$strip>;
+        schema: z.ZodObject<{
+            truncated: z.ZodBoolean;
+            columns: z.ZodArray<z.ZodObject<{
+                index: z.ZodNumber;
+                letter: z.ZodString;
+                name: z.ZodString;
+                dominantType: z.ZodEnum<{
+                    string: "string";
+                    number: "number";
+                    boolean: "boolean";
+                    unknown: "unknown";
+                    date: "date";
+                    error: "error";
+                    blank_stub: "blank_stub";
+                }>;
+                nonEmptyCount: z.ZodNumber;
+                nonEmptyRatio: z.ZodNumber;
+                examples: z.ZodArray<z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        sample: z.ZodObject<{
+            truncatedRows: z.ZodBoolean;
+            truncatedColumns: z.ZodBoolean;
+            rows: z.ZodArray<z.ZodObject<{
+                rowNumber: z.ZodNumber;
+                values: z.ZodRecord<z.ZodString, z.ZodString>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        sampleTokenEstimate: z.ZodNumber;
+        fullTokenEstimate: z.ZodNumber;
+        estimateMethod: z.ZodLiteral<"full_scan">;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type SheetInspectionResult = z.infer<typeof SheetInspectionResultSchema>;
+export declare const SheetInspectPayloadSchema: z.ZodObject<{
+    file: z.ZodString;
+    query: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    results: z.ZodObject<{
+        workbook: z.ZodObject<{
+            file: z.ZodString;
+            format: z.ZodLiteral<"xlsx">;
+            size: z.ZodNumber;
+            properties: z.ZodObject<{
+                title: z.ZodOptional<z.ZodString>;
+                subject: z.ZodOptional<z.ZodString>;
+                author: z.ZodOptional<z.ZodString>;
+                company: z.ZodOptional<z.ZodString>;
+                manager: z.ZodOptional<z.ZodString>;
+                createdDate: z.ZodOptional<z.ZodString>;
+                modifiedDate: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>;
+            customPropertyCount: z.ZodNumber;
+            customProperties: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            sheetCount: z.ZodNumber;
+            visibleSheetCount: z.ZodNumber;
+            hiddenSheetCount: z.ZodNumber;
+            veryHiddenSheetCount: z.ZodNumber;
+            definedNames: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                ref: z.ZodString;
+                scope: z.ZodEnum<{
+                    sheet: "sheet";
+                    workbook: "workbook";
+                }>;
+                sheetIndex: z.ZodOptional<z.ZodNumber>;
+                sheetName: z.ZodOptional<z.ZodString>;
+                external: z.ZodBoolean;
+            }, z.core.$strip>>;
+            riskFlags: z.ZodObject<{
+                hiddenSheets: z.ZodBoolean;
+                formulas: z.ZodBoolean;
+                comments: z.ZodBoolean;
+                hyperlinks: z.ZodBoolean;
+                mergedCells: z.ZodBoolean;
+                protectedSheets: z.ZodBoolean;
+                externalFormulaRefs: z.ZodBoolean;
+            }, z.core.$strip>;
+        }, z.core.$strip>;
+        sheets: z.ZodArray<z.ZodObject<{
+            index: z.ZodNumber;
+            name: z.ZodString;
+            visibility: z.ZodEnum<{
+                visible: "visible";
+                hidden: "hidden";
+                very_hidden: "very_hidden";
+            }>;
+            usedRange: z.ZodNullable<z.ZodString>;
+            totalRows: z.ZodNumber;
+            totalCols: z.ZodNumber;
+            rectangularRangeCellCount: z.ZodNumber;
+            nonEmptyCellCount: z.ZodNumber;
+            cellTypeCounts: z.ZodObject<{
+                string: z.ZodNumber;
+                number: z.ZodNumber;
+                boolean: z.ZodNumber;
+                date: z.ZodNumber;
+                error: z.ZodNumber;
+                blankStub: z.ZodNumber;
+            }, z.core.$strip>;
+            formulaCellCount: z.ZodNumber;
+            commentCellCount: z.ZodNumber;
+            hyperlinkCellCount: z.ZodNumber;
+            mergedRangeCount: z.ZodNumber;
+            hiddenRowCount: z.ZodNumber;
+            hiddenColumnCount: z.ZodNumber;
+            autoFilterRef: z.ZodNullable<z.ZodString>;
+            protected: z.ZodBoolean;
+            definedNames: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                ref: z.ZodString;
+                scope: z.ZodEnum<{
+                    sheet: "sheet";
+                    workbook: "workbook";
+                }>;
+                sheetIndex: z.ZodOptional<z.ZodNumber>;
+                sheetName: z.ZodOptional<z.ZodString>;
+                external: z.ZodBoolean;
+            }, z.core.$strip>>;
+            externalFormulaRefCount: z.ZodNumber;
+            headerSelection: z.ZodObject<{
+                requested: z.ZodUnion<readonly [z.ZodLiteral<"auto">, z.ZodLiteral<"none">, z.ZodNumber]>;
+                mode: z.ZodEnum<{
+                    auto: "auto";
+                    none: "none";
+                    explicit: "explicit";
+                }>;
+                rowNumber: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$strip>;
+            schema: z.ZodObject<{
+                truncated: z.ZodBoolean;
+                columns: z.ZodArray<z.ZodObject<{
+                    index: z.ZodNumber;
+                    letter: z.ZodString;
+                    name: z.ZodString;
+                    dominantType: z.ZodEnum<{
+                        string: "string";
+                        number: "number";
+                        boolean: "boolean";
+                        unknown: "unknown";
+                        date: "date";
+                        error: "error";
+                        blank_stub: "blank_stub";
+                    }>;
+                    nonEmptyCount: z.ZodNumber;
+                    nonEmptyRatio: z.ZodNumber;
+                    examples: z.ZodArray<z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            sample: z.ZodObject<{
+                truncatedRows: z.ZodBoolean;
+                truncatedColumns: z.ZodBoolean;
+                rows: z.ZodArray<z.ZodObject<{
+                    rowNumber: z.ZodNumber;
+                    values: z.ZodRecord<z.ZodString, z.ZodString>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            sampleTokenEstimate: z.ZodNumber;
+            fullTokenEstimate: z.ZodNumber;
+            estimateMethod: z.ZodLiteral<"full_scan">;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type SheetInspectPayload = z.infer<typeof SheetInspectPayloadSchema>;

package/dist/src/sheet/types.js

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+export const SheetVisibilitySchema = z.enum(['visible', 'hidden', 'very_hidden']);
+export const HeaderSelectionModeSchema = z.enum(['auto', 'none', 'explicit']);
+export const ColumnValueTypeSchema = z.enum(['string', 'number', 'boolean', 'date', 'error', 'blank_stub', 'unknown']);
+export const InspectSheetOptionsSchema = z.object({
+    sheet: z.string().optional(),
+    sampleRows: z.number(),
+    headerRow: z.union([z.literal('auto'), z.literal('none'), z.number()]),
+    maxColumns: z.number(),
+});
+export const DefinedNameInfoSchema = z.object({
+    name: z.string(),
+    ref: z.string(),
+    scope: z.enum(['workbook', 'sheet']),
+    sheetIndex: z.number().optional(),
+    sheetName: z.string().optional(),
+    external: z.boolean(),
+});
+export const WorkbookPropertiesSchema = z.object({
+    title: z.string().optional(),
+    subject: z.string().optional(),
+    author: z.string().optional(),
+    company: z.string().optional(),
+    manager: z.string().optional(),
+    createdDate: z.string().optional(),
+    modifiedDate: z.string().optional(),
+});
+export const WorkbookRiskFlagsSchema = z.object({
+    hiddenSheets: z.boolean(),
+    formulas: z.boolean(),
+    comments: z.boolean(),
+    hyperlinks: z.boolean(),
+    mergedCells: z.boolean(),
+    protectedSheets: z.boolean(),
+    externalFormulaRefs: z.boolean(),
+});
+export const CellTypeCountsSchema = z.object({
+    string: z.number(),
+    number: z.number(),
+    boolean: z.number(),
+    date: z.number(),
+    error: z.number(),
+    blankStub: z.number(),
+});
+export const ColumnProfileSchema = z.object({
+    index: z.number(),
+    letter: z.string(),
+    name: z.string(),
+    dominantType: ColumnValueTypeSchema,
+    nonEmptyCount: z.number(),
+    nonEmptyRatio: z.number(),
+    examples: z.array(z.string()),
+});
+export const SampleRowSchema = z.object({
+    rowNumber: z.number(),
+    values: z.record(z.string(), z.string()),
+});
+export const SheetProfileSchema = z.object({
+    index: z.number(),
+    name: z.string(),
+    visibility: SheetVisibilitySchema,
+    usedRange: z.string().nullable(),
+    totalRows: z.number(),
+    totalCols: z.number(),
+    rectangularRangeCellCount: z.number(),
+    nonEmptyCellCount: z.number(),
+    cellTypeCounts: CellTypeCountsSchema,
+    formulaCellCount: z.number(),
+    commentCellCount: z.number(),
+    hyperlinkCellCount: z.number(),
+    mergedRangeCount: z.number(),
+    hiddenRowCount: z.number(),
+    hiddenColumnCount: z.number(),
+    autoFilterRef: z.string().nullable(),
+    protected: z.boolean(),
+    definedNames: z.array(DefinedNameInfoSchema),
+    externalFormulaRefCount: z.number(),
+    headerSelection: z.object({
+        requested: z.union([z.literal('auto'), z.literal('none'), z.number()]),
+        mode: HeaderSelectionModeSchema,
+        rowNumber: z.number().nullable(),
+    }),
+    schema: z.object({
+        truncated: z.boolean(),
+        columns: z.array(ColumnProfileSchema),
+    }),
+    sample: z.object({
+        truncatedRows: z.boolean(),
+        truncatedColumns: z.boolean(),
+        rows: z.array(SampleRowSchema),
+    }),
+    sampleTokenEstimate: z.number(),
+    fullTokenEstimate: z.number(),
+    estimateMethod: z.literal('full_scan'),
+});
+export const WorkbookInspectionSchema = z.object({
+    file: z.string(),
+    format: z.literal('xlsx'),
+    size: z.number(),
+    properties: WorkbookPropertiesSchema,
+    customPropertyCount: z.number(),
+    customProperties: z.record(z.string(), z.unknown()),
+    sheetCount: z.number(),
+    visibleSheetCount: z.number(),
+    hiddenSheetCount: z.number(),
+    veryHiddenSheetCount: z.number(),
+    definedNames: z.array(DefinedNameInfoSchema),
+    riskFlags: WorkbookRiskFlagsSchema,
+});
+export const SheetInspectionResultSchema = z.object({
+    workbook: WorkbookInspectionSchema,
+    sheets: z.array(SheetProfileSchema),
+});
+export const SheetInspectPayloadSchema = z.object({
+    file: z.string(),
+    query: z.record(z.string(), z.unknown()),
+    results: SheetInspectionResultSchema,
+});
+//# sourceMappingURL=types.js.map

package/dist/src/sheet/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sheet/types.ts"],"names":[],"mappings":"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"}

package/dist/src/slide/command.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerSlideCommands(program: Command): void;

package/dist/src/slide/command.js

@@ -0,0 +1,54 @@
+import { writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { z } from 'zod';
+import { inspectPresentation } from './inspect.js';
+import { formatSlideInspection, formatSlidePayloadJson } from './output.js';
+import { createInspectPayload } from '../inspect/shared.js';
+import { writeStream } from '../utils.js';
+import { parsePositiveInt } from '../cli-validation.js';
+const SlideCommandOptionsSchema = z.object({
+    format: z.string().optional(),
+    output: z.string().optional(),
+    ci: z.boolean().optional(),
+    sampleSlides: z.string().optional(),
+    slide: z.string().optional(),
+}).passthrough();
+function getOptions(command) {
+    return SlideCommandOptionsSchema.parse(command.optsWithGlobals());
+}
+async function emit(output, options) {
+    if (options.output) {
+        await writeFile(options.output, output);
+        return;
+    }
+    await writeStream(process.stdout, output);
+}
+export function registerSlideCommands(program) {
+    const slide = program.command('slide').description('Inspect presentation structure and content before deep reading');
+    const inspect = slide.command('inspect <file>').description('Inspect PPTX or ODP presentation metadata, slides, and content preview');
+    inspect
+        .option('--format <type>', 'output format: tabular or json', 'tabular')
+        .option('-o, --output <file>', 'write output to file')
+        .option('--ci', 'ASCII-only output, no colors')
+        .option('--sample-slides <n>', 'preview slide count', '3')
+        .option('--slide <number>', 'inspect specific slide (1-based index)');
+    inspect.action(async (file, _options, command) => {
+        const options = getOptions(command);
+        const resolved = path.resolve(file);
+        const inspectOptions = {
+            sampleSlides: parsePositiveInt(options.sampleSlides, 3, 'sample slide count'),
+            slide: options.slide ? parsePositiveInt(options.slide, 1, 'slide number') : undefined,
+        };
+        const result = await inspectPresentation(resolved, inspectOptions);
+        const payload = createInspectPayload(resolved, {
+            command: 'slide.inspect',
+            sampleSlides: inspectOptions.sampleSlides,
+            slide: inspectOptions.slide,
+        }, result);
+        const output = options.format === 'json'
+            ? formatSlidePayloadJson(payload)
+            : formatSlideInspection(result, options.ci);
+        await emit(output.endsWith('\n') ? output : `${output}\n`, options);
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/src/slide/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/slide/command.ts"],"names":[],"mappings":"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"}

package/dist/src/slide/inspect-odp.d.ts

@@ -0,0 +1,7 @@
+import type { DocumentProperties } from '../inspect/shared.js';
+import type { SlideRiskFlags, SlideProfile } from './types.js';
+export declare function inspectOdp(buffer: Buffer): Promise<{
+    properties: DocumentProperties;
+    riskFlags: SlideRiskFlags;
+    slideProfiles: SlideProfile[];
+}>;