import type { ChartSpace } from '../chart/chart';
import type { CxChartSpace } from '../chart/cx/chartex';
import type { DrawingAnchor } from './anchor';
import type { ShapeProperties } from './dml/shape-properties';
import type { XlsxImage } from './image';
/** Reference to a chart part — the chart's drawing-rels rId resolves to xl/charts/chartN.xml. */
export interface ChartReference {
    /** Drawing-rels rId pointing at the chart part. Populated on read; the writer assigns its own. */
    rId?: string;
    /**
     * Legacy ECMA-376 chart payload (`c:chartSpace`). Stage-1 supports BarChart
     * end-to-end; other chart kinds populate this field as their parsers /
     * writers land.
     */
    space?: ChartSpace;
    /**
     * Excel-2016 chartex payload (`cx:chartSpace`). Mutually exclusive with
     * {@link space} for any given drawing item; the parser sniffs the root
     * element and populates whichever is appropriate.
     */
    cxSpace?: CxChartSpace;
    /**
     * `true` when the resolved chart part is a chartex (`cx:`) chart. Set by the
     * package writer so the drawing emitter knows to use the chartex
     * `<a:graphicData uri>` instead of the legacy chart URI — Excel rejects the
     * workbook when the URI doesn't match the chart's actual root namespace.
     */
    isCx?: boolean;
}
/** Reference to an embedded picture inside a worksheet drawing. */
export interface PictureReference {
    /** Drawing-rels rId pointing at the embedded image. Populated on read; the writer assigns its own. */
    rId?: string;
    /** Resolved image bytes + metadata. Populated on read; the writer reads it back. */
    image?: XlsxImage;
    /** Picture display name (`<xdr:cNvPr name="...">`). */
    name?: string;
    /** Optional alt-text description. */
    descr?: string;
    /** Hidden flag (`<xdr:cNvPr hidden="1"/>`). */
    hidden?: boolean;
    /** Per-picture shape properties (extra fill / line / rotation). */
    spPr?: ShapeProperties;
}
export interface DrawingItem {
    anchor: DrawingAnchor;
    content: {
        kind: 'chart';
        chart: ChartReference;
    } | {
        kind: 'picture';
        picture: PictureReference;
    } | {
        kind: 'unsupported';
        rawTag: string;
    };
}
export interface Drawing {
    items: DrawingItem[];
}
export declare function makeDrawing(items?: DrawingItem[]): Drawing;
export declare function makeChartDrawingItem(anchor: DrawingAnchor, chart?: ChartReference): DrawingItem;
export declare function makePictureDrawingItem(anchor: DrawingAnchor, picture: PictureReference | XlsxImage): DrawingItem;
import type { Worksheet } from '../worksheet/worksheet';
/**
 * Drop an image onto a worksheet at a single-cell anchor. Lazy-allocates
 * `ws.drawing` (as `makeDrawing([])`) on first call and appends a picture
 * DrawingItem.
 *
 * `image` accepts either an `XlsxImage` (already loaded via `loadImage`) or raw
 * image bytes — in the bytes case, this helper sniffs the format with
 * `loadImage` itself.
 *
 * `at` is a cell ref like `"C3"`. Override `widthPx` / `heightPx` to scale;
 * otherwise the helper uses 96×96 defaults that look fine for typical icons.
 */
export declare const addImageAt: (ws: Worksheet, at: string, image: XlsxImage | Uint8Array, opts?: {
    widthPx?: number;
    heightPx?: number;
}) => DrawingItem;
/**
 * Anchor a chart to a worksheet at a single-cell ref. Lazy-allocates
 * `ws.drawing`. `chart` is the same `ChartReference` shape `makeChart
 * DrawingItem` accepts (`{ space }` for legacy chart, `{ cxSpace }` for
 * chartex).
 */
export declare const addChartAt: (ws: Worksheet, at: string, chart: ChartReference, opts?: {
    widthPx?: number;
    heightPx?: number;
}) => DrawingItem;
/**
 * Read-only snapshot of every picture DrawingItem on the sheet. Returns the
 * matching items (each with its anchor + picture reference). Empty array when
 * the sheet has no drawing or only non-picture items.
 */
export declare const listImagesOnSheet: (ws: Worksheet) => ReadonlyArray<DrawingItem>;
/**
 * Read-only snapshot of every chart DrawingItem on the sheet. Each item has its
 * anchor + chart reference.
 */
export declare const listChartsOnSheet: (ws: Worksheet) => ReadonlyArray<DrawingItem>;
/**
 * Drop every DrawingItem from the worksheet. Returns the count removed. The
 * `ws.drawing` field itself is left in place (empty) so subsequent `addImageAt`
 * / `addChartAt` calls don't have to re-allocate.
 */
export declare const removeAllDrawingItems: (ws: Worksheet) => number;
/**
 * Drop every picture DrawingItem from the worksheet, leaving charts and any
 * other content kinds untouched. Returns the count removed.
 */
export declare const removeAllImages: (ws: Worksheet) => number;
/**
 * Drop every chart DrawingItem from the worksheet, leaving pictures and any
 * other content kinds untouched. Returns the count removed.
 */
export declare const removeAllCharts: (ws: Worksheet) => number;