@syncfusion/ej2-docx 0.0.0-stage → 35.1.39

package/src/features/content-controls/index.d.ts

@@ -0,0 +1,821 @@
+import { WordDocument, Body } from '../document/document';
+import { FeatureBlock } from '../document/feature-block';
+import { FeatureInline } from '../document/feature-inline';
+import { Paragraph, BlockContent, ParagraphOwner } from '../document/paragraph';
+import { BodyItem, BlockContentControlBodyItem } from '../document/body-item';
+import { CharacterFormat, CharacterFormatHost } from '../document/character-format';
+import { Color } from '../document/color';
+import { EntityType } from '../document/entity-type';
+import { LocaleIDs } from '../document/locale-ids';
+import { ParagraphItemCollection, ParagraphItemCollectionHost } from '../document/paragraph-item-collection';
+import { ParagraphItem, ParagraphItemOwner } from '../document/paragraph-item';
+import { ConcreteParagraphItem, FeatureInlineParagraphItem, TextRange } from '../document/text-range';
+import { FeatureInlineContent } from '../../core/registry/inline-handlers';
+import { NamespaceDeclaration, OpenXmlAttribute, OpenXmlElement } from '../../core/xml/index';
+declare const CONTENT_CONTROLS: import("../../core/registry").FeatureId;
+/**
+ * @private
+ * [MS-DOCX] WordprocessingML 2010 extension namespace
+ * (`http://schemas.microsoft.com/office/word/2010/wordml`) — checkbox / `w14`.
+ */
+export declare const WORDML_2010_NAMESPACE = "http://schemas.microsoft.com/office/word/2010/wordml";
+/**
+ * @private
+ * [MS-DOCX] WordprocessingML 2012 extension namespace
+ * (`http://schemas.microsoft.com/office/word/2012/wordml`) — appearance / color.
+ */
+export declare const WORDML_2012_NAMESPACE = "http://schemas.microsoft.com/office/word/2012/wordml";
+/** Internal SDT lock wire values (`ST_Lock`). @private */
+declare type LockWireValue = 'sdtLocked' | 'contentLocked' | 'unlocked' | 'sdtContentLocked';
+/**
+ * Authorable content-control kinds (customer public surface).
+ *
+ * Non-authorable kinds from load (equation, group, …) are preserved via residual XML.
+ *
+ * @public
+ */
+export declare type ContentControlType = 'richText' | 'plainText' | 'picture' | 'comboBox' | 'dropDownList' | 'date' | 'checkbox';
+/**
+ * Runtime values for {@link ContentControlType}.
+ * @public
+ */
+export declare const ContentControlType: {
+    readonly RichText: 'richText';
+    readonly Text: 'plainText';
+    readonly Picture: 'picture';
+    readonly ComboBox: 'comboBox';
+    readonly DropDownList: 'dropDownList';
+    readonly Date: 'date';
+    readonly CheckBox: 'checkbox';
+};
+/**
+ * [MS-DOCX] `ST_SdtAppearance` — `w15:appearance/@w15:val`.
+ * @public
+ */
+export declare type ContentControlAppearance = 'boundingBox' | 'tags' | 'hidden';
+/**
+ * Runtime values for {@link ContentControlAppearance}.
+ * @public
+ */
+export declare const ContentControlAppearance: {
+    readonly BoundingBox: 'boundingBox';
+    readonly Tags: 'tags';
+    readonly Hidden: 'hidden';
+};
+/**
+ * Calendar systems for date content controls (`w:calendar/@w:val`).
+ * @public
+ */
+export declare type CalendarType = 'gregorian' | 'hijri' | 'hebrew' | 'taiwan' | 'japan' | 'thai' | 'korea' | 'saka' | 'gregorianArabic' | 'gregorianMiddleEastFrench' | 'gregorianTransliteratedEnglish' | 'gregorianTransliteratedFrench' | 'gregorianUsLocale';
+/**
+ * Runtime values for {@link CalendarType}.
+ * @public
+ */
+export declare const CalendarType: {
+    readonly Gregorian: 'gregorian';
+    readonly Hijri: 'hijri';
+    readonly Hebrew: 'hebrew';
+    readonly Taiwan: 'taiwan';
+    readonly Japan: 'japan';
+    readonly Thai: 'thai';
+    readonly Korea: 'korea';
+    readonly Saka: 'saka';
+    readonly GregorianArabic: 'gregorianArabic';
+    readonly GregorianMiddleEastFrench: 'gregorianMiddleEastFrench';
+    readonly GregorianTransliteratedEnglish: 'gregorianTransliteratedEnglish';
+    readonly GregorianTransliteratedFrench: 'gregorianTransliteratedFrench';
+    readonly GregorianUsLocale: 'gregorianUsLocale';
+};
+/**
+ * How mapped date data is stored (`ST_SdtDateMappingType`).
+ * @public
+ */
+export declare type ContentControlDateStorageFormat = 'date' | 'dateTime' | 'text';
+/**
+ * Runtime values for {@link ContentControlDateStorageFormat}.
+ * @public
+ */
+export declare const ContentControlDateStorageFormat: {
+    readonly DateStorageDate: 'date';
+    readonly DateStorageDateTime: 'dateTime';
+    readonly DateStorageText: 'text';
+};
+/**
+ * Checkbox symbol (`w14:checkedState` / `w14:uncheckedState`) — mutable stable identity.
+ * @public
+ */
+export declare class ContentControlCheckBoxState {
+    private fontValue;
+    private valueValue;
+    private onChange;
+    /** @private */
+    constructor(init?: {
+        readonly font?: string;
+        readonly value?: string;
+    });
+    /** @private */
+    bind(onChange: () => void): void;
+    private dirty;
+    /** Font name for the checkbox glyph. @public */
+    font: string | undefined;
+    /** Glyph code point / short-hex value. @public */
+    value: string | undefined;
+}
+/**
+ * Combo-box or drop-down list entry.
+ * @public
+ */
+export declare class ContentControlListItem {
+    private displayTextValue;
+    private valueValue;
+    private onChange;
+    /** @public */
+    constructor();
+    /** @private */
+    bind(onChange: () => void): void;
+    private dirty;
+    /** Display label. @public */
+    displayText: string | undefined;
+    /** Stored value. @public */
+    value: string | undefined;
+}
+/**
+ * Mutable list of {@link ContentControlListItem} with stable identity.
+ * @public
+ */
+export declare class ContentControlListItemCollection {
+    private readonly items;
+    private onChange;
+    /** @private */
+    constructor(items?: ReadonlyArray<ContentControlListItem>);
+    /** @private */
+    bind(onChange: () => void): void;
+    private dirty;
+    /** Number of list items. @public */
+    readonly count: number;
+    /** Item at zero-based index. @public */
+    getItem(index: number): ContentControlListItem;
+    /** Snapshot array (copy). @public */
+    toArray(): ContentControlListItem[];
+    /** Add a list item. @public */
+    add(item: ContentControlListItem): void;
+    /** Remove all items. @public */
+    clear(): void;
+    /** @private */
+    asReadonly(): ReadonlyArray<ContentControlListItem>;
+}
+/**
+ * Custom XML data binding metadata from `w:sdtPr/w:dataBinding`.
+ *
+ * @private
+ */
+export interface ContentControlDataBinding {
+    readonly prefixMappings: string | undefined;
+    readonly xpath: string;
+    readonly storeItemID: string;
+}
+/** @private */
+interface ContentControlPropertiesOwner {
+    markSdtPrDirty(): void;
+    synchronizeCheckboxContent(): void;
+}
+/**
+ * Structured document tag properties (`w:sdtPr`).
+ *
+ * @public
+ */
+export declare class ContentControlProperties {
+    private tagValue;
+    private titleValue;
+    /** @private */
+    private idValue;
+    private lockContentControlValue;
+    private lockContentsValue;
+    /** @private */
+    private placeholderDocPartValue;
+    /** @private */
+    private dataBindingValue;
+    private typeValue;
+    private temporaryValue;
+    private appearanceValue;
+    private colorValue;
+    private themeColorValue;
+    private themeTintValue;
+    private themeShadeValue;
+    private isCheckedValue;
+    private readonly checkedStateValue;
+    private readonly uncheckedStateValue;
+    private fullDateValue;
+    private dateDisplayFormatValue;
+    private dateDisplayLocaleValue;
+    private dateStorageFormatValue;
+    private dateCalendarTypeValue;
+    private readonly contentControlListItemsValue;
+    private lastValueValue;
+    private multilineValue;
+    /** @private */
+    private residualChildrenValue;
+    private leftoverAttributesValue;
+    private namespaceDeclarationsValue;
+    private owner;
+    /**
+     * @private
+     */
+    constructor(init?: {
+        readonly tag?: string;
+        readonly title?: string;
+        readonly id?: number;
+        readonly lock?: LockWireValue;
+        readonly lockContentControl?: boolean;
+        readonly lockContents?: boolean;
+        readonly placeholderDocPart?: string;
+        readonly dataBinding?: ContentControlDataBinding;
+        readonly type?: ContentControlType;
+        readonly temporary?: boolean;
+        readonly appearance?: ContentControlAppearance;
+        readonly color?: Color;
+        readonly themeColor?: string;
+        readonly themeTint?: string;
+        readonly themeShade?: string;
+        readonly isChecked?: boolean;
+        readonly checkedState?: ContentControlCheckBoxState;
+        readonly uncheckedState?: ContentControlCheckBoxState;
+        readonly fullDate?: string;
+        readonly dateDisplayFormat?: string;
+        readonly dateDisplayLocale?: LocaleIDs;
+        readonly dateStorageFormat?: ContentControlDateStorageFormat;
+        readonly dateCalendarType?: CalendarType;
+        readonly listItems?: ReadonlyArray<ContentControlListItem>;
+        readonly lastValue?: string;
+        readonly multiline?: boolean;
+        readonly residualChildren?: ReadonlyArray<OpenXmlElement>;
+        readonly leftoverAttributes?: ReadonlyArray<OpenXmlAttribute>;
+        readonly namespaceDeclarations?: ReadonlyArray<NamespaceDeclaration>;
+    });
+    /**
+     * @private
+     * Bind owning control so property sets rebuild `sdtPr` on save.
+     */
+    bindOwner(owner: ContentControlPropertiesOwner): void;
+    private markDirty;
+    /**
+     * Drop type-specific payloads that do not belong to `type`.
+     */
+    private clearPayloadsForType;
+    /**
+     * Gets or sets the programmatic tag used to identify this content control in code.
+     *
+     * If undefined, no tag is explicitly specified.
+     *
+     * @public
+     */
+    tag: string | undefined;
+    /**
+     * Gets or sets the friendly display name shown as the content-control title in Word.
+     *
+     * If undefined, no title is explicitly specified.
+     *
+     * @public
+     */
+    title: string | undefined;
+    /**
+     * @private
+     * Numeric id (`w:sdtPr/w:id/@w:val`). Preserve-only identity from load or
+     * author options — not a general post-create editing knob.
+     */
+    readonly id: number | undefined;
+    /**
+     * Gets or sets whether the content-control definition is locked.
+     * @public
+     */
+    lockContentControl: boolean;
+    /**
+     * Gets or sets whether the content inside the control is locked.
+     * @public
+     */
+    lockContents: boolean;
+    /**
+     * @private
+     * Combined ST_Lock wire value for serialize.
+     */
+    readonly lockWire: LockWireValue | undefined;
+    /**
+     * @private
+     * Placeholder document-part name
+     * (`w:sdtPr/w:placeholder/w:docPart/@w:val`).
+     */
+    placeholderDocPart: string | undefined;
+    /**
+     * @private
+     * Custom XML data binding metadata. Detect/preserve only — never resolved
+     * against a store or network; no public setter.
+     */
+    readonly dataBinding: ContentControlDataBinding | undefined;
+    /**
+     * Gets or sets the content-control kind.
+     * @public
+     */
+    type: ContentControlType | undefined;
+    /**
+     * Gets or sets whether the control is removed after contents are edited once (`w:temporary`).
+     * @public
+     */
+    isTemporary: boolean;
+    /**
+     * @private Compatibility alias for load/serialize paths that used `temporary`.
+     */
+    temporary: boolean;
+    /**
+     * Gets or sets how the control chrome is shown.
+     * @public
+     */
+    appearance: ContentControlAppearance | undefined;
+    /**
+     * Gets or sets the border/chrome color (`Color` API).
+     * @public
+     */
+    color: Color | undefined;
+    /** @private */
+    readonly themeColor: string | undefined;
+    /** @private */
+    readonly themeTint: string | undefined;
+    /** @private */
+    readonly themeShade: string | undefined;
+    /**
+     * Gets or sets whether a checkbox control is checked.
+     * @public
+     */
+    isChecked: boolean;
+    /**
+     * Checked-state symbol (stable identity).
+     * @public
+     */
+    readonly checkedState: ContentControlCheckBoxState;
+    /**
+     * Unchecked-state symbol (stable identity).
+     * @public
+     */
+    readonly uncheckedState: ContentControlCheckBoxState;
+    /**
+     * Full date/time stored value.
+     * @public
+     */
+    fullDate: string | undefined;
+    /**
+     * Display format pattern for the date.
+     * @public
+     */
+    dateDisplayFormat: string | undefined;
+    /**
+     * Locale used for date display.
+     * @public
+     */
+    dateDisplayLocale: LocaleIDs | undefined;
+    /**
+     * How mapped date data is stored.
+     * @public
+     */
+    dateStorageFormat: ContentControlDateStorageFormat | undefined;
+    /**
+     * Calendar system for the date control.
+     * @public
+     */
+    dateCalendarType: CalendarType | undefined;
+    /**
+     * Combo-box / drop-down list items (stable identity).
+     * @public
+     */
+    readonly contentControlListItems: ContentControlListItemCollection;
+    /**
+     * Last selected list value.
+     * @public
+     */
+    lastValue: string | undefined;
+    /**
+     * Whether a plain-text control accepts multiple lines (`w:text/@w:multiLine`).
+     * @public
+     */
+    multiline: boolean | undefined;
+    /**
+     * @private
+     * Unmodeled `sdtPr` children (including extra kind markers). */
+    readonly residualChildren: ReadonlyArray<OpenXmlElement>;
+    /**
+     * @private
+     * Leftover attributes on `sdtPr` itself. */
+    readonly leftoverAttributes: ReadonlyArray<OpenXmlAttribute>;
+    /**
+     * @private
+     * Namespace declarations on `sdtPr`. */
+    readonly namespaceDeclarations: ReadonlyArray<NamespaceDeclaration>;
+}
+declare type ContentControlInlineItem = {
+    readonly type: 'textRange';
+    readonly run: TextRange;
+} | {
+    readonly type: 'opaque';
+    readonly xml: OpenXmlElement;
+} | FeatureInlineContent;
+/**
+ * Structured document tag (`w:sdt`) base — shared properties, facades, and
+ * serialize hooks for block and inline content controls.
+ *
+ * Prefer {@link BlockContentControl} / {@link InlineContentControl} for new
+ * code. This class remains the shared base and legacy facade surface.
+ *
+ * @public
+ */
+export declare class ContentControl implements FeatureInline, FeatureBlock, ContentControlPropertiesOwner, CharacterFormatHost {
+    /**
+     * Marks this instance as a block-level body content control when present on the body surface.
+     * Satisfies {@link BlockContentControlBodyItem} for direct {@link BodyItem} assignability.
+     */
+    readonly isBlockLevel?: boolean;
+    /**
+     * Typed `w:sdtPr` view. Always present after construction for authoring;
+     * load path may start without modeled properties until ensureProperties.
+     */
+    private propertiesValue;
+    /** Raw load-path `sdtPr` when present — preferred for lossless rewrite. */
+    private readonly sdtPr;
+    private sdtEndPrRaw;
+    private readonly preservedXml;
+    private documentOwner;
+    /** When true, rebuild `sdtPr` from {@link properties} (author / dirty path). */
+    private rebuildSdtPr;
+    /** When true, rebuild `sdtEndPr` from {@link breakCharacterFormat}. */
+    private rebuildSdtEndPr;
+    private readonly breakCharacterFormatInstance;
+    private breakFormatDirty;
+    /**
+     * @private
+     */
+    constructor(properties: ContentControlProperties | undefined, sdtPr: OpenXmlElement | undefined, sdtEndPr: OpenXmlElement | undefined, preservedXml: OpenXmlElement | undefined, rebuildSdtPr?: boolean);
+    /**
+     * Always-defined typed property bag (created on first access when missing).
+     *
+     * @public
+     */
+    readonly contentControlProperties: ContentControlProperties;
+    /**
+     * Gets the typed property bag for this content control.
+     *
+     * @public
+     */
+    readonly properties: ContentControlProperties | undefined;
+    /**
+     * Character formatting for the SDT end mark (`w:sdtEndPr/w:rPr`).
+     *
+     * @public
+     */
+    readonly breakCharacterFormat: CharacterFormat;
+    /**
+     * @private
+     */
+    notifyCharacterFormatMutation(): void;
+    private hydrateBreakCharacterFormat;
+    private serializeSdtEndPr;
+    /**
+     * @private
+     * Prefer modeled rebuild after any user-facing property write.
+     */
+    markSdtPrDirty(): void;
+    /** @private */
+    synchronizeCheckboxContent(): void;
+    /**
+     * Ensure a properties bag exists so facade setters can write fields on
+     * controls that loaded without a complete `sdtPr` model.
+     */
+    protected ensureProperties(): ContentControlProperties;
+    /**
+     * Gets or sets the friendly display name shown as the content-control title in Word.
+     *
+     * @public
+     */
+    title: string | undefined;
+    /**
+     * Gets or sets the programmatic tag used to identify this content control in code.
+     *
+     * @public
+     */
+    tag: string | undefined;
+    /**
+     * Gets or sets whether the content-control definition is locked.
+     *
+     * @public
+     */
+    lockContentControl: boolean;
+    /**
+     * Gets or sets whether the content inside the control is locked.
+     *
+     * @public
+     */
+    lockContents: boolean;
+    /**
+     * Gets or sets the placeholder document-part name used when the control shows placeholder content.
+     *
+     * @public
+     */
+    placeholderText: string | undefined;
+    /**
+     * Gets or sets the content-control kind.
+     *
+     * @public
+     */
+    type: ContentControlType | undefined;
+    /**
+     * Gets or sets whether the control is removed after its contents are edited once.
+     *
+     * @public
+     */
+    isTemporary: boolean;
+    /**
+     * Gets or sets how the control chrome is shown.
+     *
+     * @public
+     */
+    appearance: ContentControlAppearance | undefined;
+    /**
+     * Gets or sets the border/chrome color for the content control.
+     *
+     * @public
+     */
+    color: Color | undefined;
+    /**
+     * Gets or sets whether a checkbox control is checked.
+     *
+     * @public
+     */
+    isChecked: boolean;
+    /**
+     * Checked-state symbol (stable identity).
+     *
+     * @public
+     */
+    readonly checkedState: ContentControlCheckBoxState;
+    /**
+     * Unchecked-state symbol (stable identity).
+     *
+     * @public
+     */
+    readonly uncheckedState: ContentControlCheckBoxState;
+    /**
+     * Full date/time stored value.
+     *
+     * @public
+     */
+    fullDate: string | undefined;
+    /**
+     * Display format pattern for the date.
+     *
+     * @public
+     */
+    dateDisplayFormat: string | undefined;
+    /**
+     * Locale used for date display.
+     *
+     * @public
+     */
+    dateDisplayLocale: LocaleIDs | undefined;
+    /**
+     * How mapped date data is stored.
+     *
+     * @public
+     */
+    dateStorageFormat: ContentControlDateStorageFormat | undefined;
+    /**
+     * Calendar system for the date control.
+     *
+     * @public
+     */
+    dateCalendarType: CalendarType | undefined;
+    /**
+     * Combo-box / drop-down list items (stable identity).
+     *
+     * @public
+     */
+    readonly contentControlListItems: ContentControlListItemCollection;
+    /**
+     * Gets or sets the last selected value for a combo-box or drop-down list control.
+     *
+     * @public
+     */
+    lastValue: string | undefined;
+    /**
+     * Gets or sets whether a plain-text content control accepts multiple lines of text.
+     *
+     * @public
+     */
+    multiline: boolean | undefined;
+    /**
+     * Compatibility: block children projected as BodyItem[] (block controls only).
+     *
+     * @public
+     */
+    readonly blockContentControl: ReadonlyArray<BodyItem> | undefined;
+    /**
+     * Compatibility: inline bag children (inline controls only).
+     *
+     * @public
+     */
+    readonly inlineContentControl: ReadonlyArray<ContentControlInlineItem> | undefined;
+    /**
+     * @private
+     */
+    releaseContent(): void;
+    /**
+     * @private
+     * Bind owning document so nested content can mutate.
+     */
+    bindDocument(document: WordDocument): void;
+    /**
+     * @private
+     */
+    owningDocument(): WordDocument;
+    /**
+     * @private
+     */
+    protected buildSdtShell(contentChildren: OpenXmlElement[]): OpenXmlElement;
+    /**
+     * @private
+     */
+    toOpenXml(): OpenXmlElement;
+}
+/**
+ * Block-level structured document tag (`w:sdt` / `CT_SdtBlock`).
+ *
+ * Owns a nested {@link Body} whose {@link Body.items} are the live DOM for
+ * `w:sdtContent` children. Public identity is this instance (BodyItem).
+ *
+ * @public
+ */
+export declare class BlockContentControl extends ContentControl implements BlockContentControlBodyItem, ParagraphOwner {
+    readonly isBlockLevel: true;
+    private readonly bodyInstance;
+    /**
+     * @private
+     */
+    constructor(properties: ContentControlProperties | undefined, sdtPr: OpenXmlElement | undefined, sdtEndPr: OpenXmlElement | undefined, blocks: BlockContent[] | undefined, preservedXml: OpenXmlElement | undefined, rebuildSdtPr?: boolean, document?: WordDocument);
+    /**
+     * Nested body for block content-control children (`w:sdtContent`).
+     *
+     * @public
+     */
+    readonly body: Body;
+    /**
+     * Projected public children (compat with prior APIs).
+     *
+     * @public
+     */
+    readonly blockContentControl: ReadonlyArray<BodyItem>;
+    /**
+     * @private
+     */
+    releaseContent(): void;
+    /**
+     * @private
+     */
+    bindDocument(document: WordDocument): void;
+    /**
+     * @private
+     */
+    assertAttachedParagraph(target: Paragraph): void;
+    /**
+     * @private
+     */
+    toOpenXml(): OpenXmlElement;
+}
+/**
+ * Inline (run-level) structured document tag (`w:sdt` / `CT_SdtRun`).
+ *
+ * Owns a {@link ParagraphItemCollection} for `w:sdtContent` children.
+ * Projected as a public paragraph item via EntityType unwrap.
+ *
+ * @public
+ */
+export declare class InlineContentControl extends ContentControl implements FeatureInline, ParagraphItemOwner, ParagraphItemCollectionHost {
+    /**
+     * Discriminator for paragraph-item projection (`projectPublicItem`).
+     *
+     * @public
+     */
+    readonly entityType: EntityType.InlineContentControl;
+    private readonly paragraphItemsInstance;
+    private itemOwner;
+    /**
+     * @private
+     */
+    constructor(properties: ContentControlProperties | undefined, sdtPr: OpenXmlElement | undefined, sdtEndPr: OpenXmlElement | undefined, initialItems: ReadonlyArray<ConcreteParagraphItem> | undefined, preservedXml: OpenXmlElement | undefined, rebuildSdtPr?: boolean);
+    /**
+     * Live paragraph items inside this inline content control.
+     *
+     * @public
+     */
+    readonly paragraphItems: ParagraphItemCollection;
+    /**
+     * Compatibility bags for legacy tests (`{ type:'textRange', run }`).
+     *
+     * @public
+     */
+    readonly inlineContentControl: ReadonlyArray<ContentControlInlineItem>;
+    /**
+     * @private
+     */
+    readonly owner: ParagraphItemOwner | undefined;
+    /**
+     * @private
+     */
+    attach(owner: ParagraphItemOwner): void;
+    /**
+     * @private
+     */
+    detach(): void;
+    /**
+     * @private
+     */
+    assertAttachedItem(target: ParagraphItem): void;
+    /**
+     * @private
+     */
+    assertMutable(): void;
+    /**
+     * @private
+     */
+    releaseContent(): void;
+    /** @private */
+    synchronizeCheckboxContent(): void;
+    /**
+     * @private
+     */
+    bindDocument(document: WordDocument): void;
+    /**
+     * @private
+     */
+    toOpenXml(): OpenXmlElement;
+}
+/**
+ * Create a detached block-level content control (`w:sdt`) ready for append.
+ *
+ * @private
+ */
+export declare function createBlockContentControl(type?: ContentControlType): BlockContentControl;
+/**
+ * Create a detached run-level content control (`w:sdt`) ready for append.
+ *
+ * @private
+ */
+export declare function createInlineContentControl(type?: ContentControlType): InlineContentControl;
+/**
+ * @private
+ * Test hook */
+export declare function resetContentControlsFeatureForTests(): void;
+/**
+ * @private
+ * Register structured document tag handlers. Idempotent. */
+export declare function registerContentControlsFeature(): void;
+/**
+ * Block-level SDTs in a block list, in document order.
+ *
+ * @private
+ */
+export declare function structuredDocumentTagsInBlocks(blocks: ReadonlyArray<BlockContent | BodyItem>): ReadonlyArray<ContentControl>;
+/**
+ * Run-level SDTs in a paragraph, in document order.
+ *
+ * @private
+ */
+export declare function structuredDocumentTagsInParagraph(paragraph: Paragraph): ReadonlyArray<ContentControl>;
+/**
+ * Whether inline content is a modeled SDT from this module.
+ *
+ * @private
+ */
+export declare function isStructuredDocumentTagInline(inline: ParagraphItem): inline is FeatureInlineParagraphItem & {
+    value: ContentControl;
+};
+/**
+ * Feature id constant for the content-controls module (used by host features
+ * that embed SDT blocks, e.g. text box bodies in the drawing module).
+ *
+ * @private
+ */
+export declare const CONTENT_CONTROLS_FEATURE_ID: import("../../core/registry").FeatureId;
+/**
+ * Whether a body block is a modeled block-level SDT (`w:sdt`) from this module.
+ *
+ * Prefer with {@link elementTypeOf} when branching on body children:
+ * `elementTypeOf(item) === 'blockContentControl'` then narrow with this guard.
+ *
+ * @param block - Body child to test.
+ * @returns `true` when `block` is a modeled block {@link ContentControl}.
+ *
+ * @private
+ */
+export declare function isBlockContentControl(block: BodyItem | BlockContent | unknown): block is {
+    readonly type: 'feature';
+    readonly featureId: typeof CONTENT_CONTROLS;
+    readonly value: ContentControl;
+};
+/** True when `value` is a public block ContentControl body item. */
+export declare function isBlockContentControlBodyItem(value: unknown): value is ContentControl;
+export {};