/** Durable Studio text-reference metadata and plain opaque-id transport. */
export declare const STUDIO_TEXT_REFERENCE_SOURCE = "croco-studio-text-reference";
/** One selected Studio text range attached to a user instruction. */
export interface StudioTextReference {
    readonly projectFolder: string;
    readonly location: string;
    readonly selectedText: string;
}
/** Direct-user source extended with durable Studio reference cards. */
export interface StudioReferenceUserSource {
    readonly kind: "user";
    readonly crocoStudioReferences: readonly StudioTextReference[];
}
/** Validate one browser-generated opaque reference id. */
export declare function validateStudioReferenceId(value: string): string;
/** Validate the durable reference data retained by the Host. */
export declare function normalizeStudioTextReference(value: Partial<StudioTextReference>): StudioTextReference;
/** Serialize only an opaque UUID; the selected text remains in Host memory. */
export declare function serializeStudioReferenceId(referenceId: string): string;
/** Remove submitted opaque ids from ordinary message text. */
export declare function consumeStudioReferenceIds(text: string): {
    text: string;
    referenceIds: string[];
};
/** Validate durable Studio references read from user-message source metadata. */
export declare function studioTextReferencesFromSource(source: unknown): readonly StudioTextReference[] | null;