@plasius/schema 1.3.0 → 1.4.0

package/dist/index.d.ts

@@ -1,287 +1,7 @@
-type PIIClassification = "none" | "low" | "high";
-type PIIAction = "encrypt" | "hash" | "clear" | "none";
-type PIILogHandling = "redact" | "omit" | "pseudonym" | "plain";
-interface PII {
-    classification: PIIClassification;
-    action: PIIAction;
-    logHandling?: PIILogHandling;
-    purpose?: string;
-}
-
-interface ValidationIssueInput {
-    code: string;
-    message: string;
-    path?: string;
-}
-interface ValidationIssue {
-    path: string;
-    code: string;
-    message: string;
-}
-type FieldValidatorResult = boolean | string | ValidationIssueInput | ValidationIssueInput[];
-type FieldValidator<T = unknown> = {
-    bivarianceHack(value: T): FieldValidatorResult;
-}["bivarianceHack"];
-
-type FieldType$1 = "string" | "number" | "boolean" | "object" | "array" | "ref";
-
-type FieldExposure = "public" | "internal";
-declare class FieldBuilder<TExternal = unknown, TInternal = TExternal> {
-    type: FieldType$1;
-    _type: TExternal;
-    _storageType: TInternal;
-    isSystem: boolean;
-    isImmutable: boolean;
-    isRequired: boolean;
-    _validator?: FieldValidator<TInternal>;
-    _description: string;
-    _version: string;
-    _default?: TInternal | (() => TInternal);
-    _upgrade?: (value: any, ctx: {
-        entityFrom: string;
-        entityTo: string;
-        fieldTo: string;
-        fieldName: string;
-    }) => {
-        ok: boolean;
-        value?: any;
-        error?: string;
-    };
-    _shape?: Record<string, FieldBuilder<any>>;
-    itemType?: FieldBuilder<any>;
-    refType?: string;
-    _pii: PII;
-    _exposure: FieldExposure;
-    enumValues?: readonly TInternal[];
-    constructor(type: FieldType$1, options?: {
-        shape?: Record<string, FieldBuilder<any>>;
-        itemType?: FieldBuilder<any>;
-        refType?: string;
-    });
-    immutable(): FieldBuilder<TExternal, TInternal>;
-    system(): FieldBuilder<TExternal, TInternal>;
-    exposure(exposure: FieldExposure): FieldBuilder<TExternal, TInternal>;
-    internal(): FieldBuilder<TExternal, TInternal>;
-    public(): FieldBuilder<TExternal, TInternal>;
-    required(): FieldBuilder<TExternal, TInternal>;
-    optional(): FieldBuilder<TExternal, TInternal>;
-    validator(fn: FieldValidator<TInternal>): FieldBuilder<TExternal, TInternal>;
-    description(desc: string): FieldBuilder<TExternal, TInternal>;
-    default(value: TInternal | (() => TInternal)): FieldBuilder<TExternal, TInternal>;
-    /**
-     * Configure an upgrader used when validating older entities against a newer schema.
-     * The upgrader receives the current field value and version context, and should
-     * return { ok: true, value } with the upgraded value, or { ok: false, error }.
-     */
-    upgrade(fn: (value: any, ctx: {
-        entityFrom: string;
-        entityTo: string;
-        fieldTo: string;
-        fieldName: string;
-    }) => {
-        ok: boolean;
-        value?: any;
-        error?: string;
-    }): FieldBuilder<TExternal, TInternal>;
-    getDefault(): TInternal | undefined;
-    version(ver: string): FieldBuilder<TExternal, TInternal>;
-    PID(pii: PII): FieldBuilder<TExternal, TInternal>;
-    min(min: number): FieldBuilder<TExternal, TInternal>;
-    max(max: number): FieldBuilder<TExternal, TInternal>;
-    pattern(regex: RegExp): FieldBuilder<TExternal, TInternal>;
-    enum<const U extends readonly TInternal[]>(values: U): FieldBuilder<U[number]>;
-    /**
-     * Create a shallow clone with a different external type parameter.
-     * Note: shape and itemType are passed by reference (shallow). If you need
-     * deep isolation of nested FieldBuilders, clone them explicitly.
-     */
-    as<U>(): FieldBuilder<U, TInternal>;
-}
-
-type FieldTypeMap = {
-    string: string;
-    number: number;
-    boolean: boolean;
-    object: Record<string, unknown>;
-    "string[]": string[];
-    "number[]": number[];
-    "boolean[]": boolean[];
-    "object[]": Record<string, unknown>[];
-    ref: RefEntityId;
-    "ref[]": RefEntityId[];
-};
-type FieldType = keyof FieldTypeMap;
-type PIIEnforcement = "strict" | "warn" | "none";
-/** Result returned by a schema upgrade function. */
-type SchemaUpgradeResult = {
-    ok: boolean;
-    /** Upgraded entity (must include all required fields for the new schema). */
-    value?: Record<string, any>;
-    /** Optional human-readable errors if upgrade fails. */
-    errors?: string[];
-};
-/**
- * A function that upgrades an entity from an older schema version to a newer one.
- * It should be **pure** and not mutate its arguments.
- */
-type SchemaUpgradeFunction = (input: Record<string, any>, ctx: {
-    from: string;
-    to: string;
-    entityType: string;
-    /** Describe function for the target schema – useful for dynamic migrations. */
-    describe: () => {
-        entityType: string;
-        version: string;
-        shape: Record<string, any>;
-    };
-    log?: (msg: string) => void;
-}) => SchemaUpgradeResult;
-type SchemaUpgradeStep = {
-    /** The target version this step upgrades to (e.g., "1.1.0"). */
-    to: string;
-    /** The migration function that upgrades from the previous step's version to `to`. */
-    run: SchemaUpgradeFunction;
-};
-/**
- * Schema-level upgrade specification can be either:
- *  - a single `SchemaUpgradeFunction` that handles any from->to, OR
- *  - an ordered array of steps, each targeting a specific `to` version, which
- *    will be applied sequentially to cascade from the oldest known version to the latest.
- */
-type SchemaUpgradeSpec = SchemaUpgradeFunction | SchemaUpgradeStep[];
-interface SchemaOptions {
-    version?: string;
-    table?: string;
-    schemaValidator?: (value: any) => boolean;
-    piiEnforcement?: PIIEnforcement;
-    schemaUpgrade?: SchemaUpgradeStep[] | SchemaUpgradeFunction | undefined;
-}
-interface SerializeOptions {
-    includeInternal?: boolean;
-}
-type SchemaShape = Record<string, FieldBuilder<any>>;
-interface FieldDefinition<T = unknown> {
-    type: FieldType;
-    __valueType?: T;
-    optional?: boolean;
-    immutable?: boolean;
-    description?: string;
-    refType?: string;
-    version?: string;
-    deprecated?: boolean;
-    deprecatedVersion?: string;
-    system?: boolean;
-    autoValidate?: boolean;
-    refPolicy?: "eager" | "lazy";
-    enum?: string[];
-    _shape?: SchemaShape;
-    pii?: PII;
-    exposure?: FieldExposure;
-    validator?: FieldValidator<T>;
-}
-interface ValidateCompositionOptions {
-    resolveEntity: (type: string, id: string) => Promise<any | null>;
-    validatorContext?: {
-        visited: Set<string>;
-    };
-    maxDepth?: number;
-    log?: (msg: string) => void;
-    onlyFields?: string[];
-}
-interface Schema<T extends SchemaShape> {
-    _shape: T;
-    meta: {
-        entityType: string;
-        version: string;
-    };
-    schemaValidator: (entity: Infer<T>) => boolean;
-    /**
-     * Runs the optional schema-level upgrade function once, without validating.
-     * Useful for offline migrations or testing migration logic.
-     */
-    upgrade(input: Record<string, any>, log?: (msg: string) => void): {
-        ok: boolean;
-        value?: Record<string, any>;
-        errors?: string[];
-    };
-    validate: (input: unknown, existing?: Record<string, any>) => ValidationResult<Infer<T>>;
-    validateComposition: (entity: Infer<T>, options: ValidateCompositionOptions) => Promise<void>;
-    serialize: (input: Record<string, any>, options?: SerializeOptions) => Record<string, any>;
-    tableName?: () => string | undefined;
-    prepareForRead(stored: Record<string, any>, decryptFn: (value: string) => any | null): Record<string, any>;
-    prepareForStorage(input: Record<string, any>, encryptFn: (value: any) => string, hashFn: (value: any) => string): Record<string, any>;
-    sanitizeForLog(data: Record<string, any>, pseudonymFn: (value: any) => string): Record<string, any>;
-    getPiiAudit(): Array<{
-        field: string;
-        classification: PIIClassification;
-        action: PIIAction;
-        logHandling?: PIILogHandling;
-        purpose?: string;
-    }> | null;
-    scrubPiiForDelete(stored: Record<string, any>): Record<string, any>;
-    describe(): {
-        entityType: string;
-        version: string;
-        shape: Record<string, {
-            type: FieldType;
-            optional: boolean;
-            immutable: boolean;
-            description: string;
-            version: string;
-            deprecated: boolean;
-            deprecatedVersion: string | null;
-            system: boolean;
-            enum: string[] | null;
-            refType: string | null;
-            pii: PII | null;
-            exposure: FieldExposure;
-        }>;
-    };
-}
-type DeepReadonly<T> = {
-    readonly [K in keyof T]: T[K] extends object ? T[K] extends (...args: any[]) => any ? T[K] : DeepReadonly<T[K]> : T[K];
-};
-interface ValidationResult<T> {
-    valid: boolean;
-    value?: DeepReadonly<T>;
-    errors?: string[];
-    issues?: ValidationIssue[];
-}
-type RefEntityId<T extends string = string> = {
-    type: T;
-    id: string;
-};
-
-type InferField<T> = T extends {
-    _type: infer U;
-} ? U : T extends {
-    type: "string";
-} ? string : T extends {
-    type: "number";
-} ? number : T extends {
-    type: "boolean";
-} ? boolean : T extends {
-    type: "array";
-    itemType: infer Item;
-} ? InferField<Item>[] : T extends {
-    type: "object";
-    shape: infer Shape extends SchemaShape;
-} ? InferFromShape<Shape> : unknown;
-type IsOptional<T> = T extends {
-    isRequired: false;
-} ? true : false;
-type InferFromShape<S extends SchemaShape> = {
-    [K in keyof S]: IsOptional<S[K]> extends true ? InferField<S[K]> | undefined : InferField<S[K]>;
-};
-type InferFromSchema<T extends {
-    shape: SchemaShape;
-}> = InferFromShape<T["shape"]>;
-type IsSchema<T> = T extends {
-    shape: SchemaShape;
-} ? true : false;
-type Infer<T> = IsSchema<T> extends true ? InferFromSchema<T & {
-    shape: SchemaShape;
-}> : InferFromShape<T & SchemaShape>;
+import { F as FieldBuilder, S as SchemaShape, I as Infer, a as SchemaOptions, b as Schema, c as FieldType, V as ValidationIssue } from './feedback-diagnostics-CnsI0B9-.js';
+export { D as DeepReadonly, d as FeedbackGameDiagnosticsSchema, e as FeedbackGameDiagnosticsValidationResult, f as FieldDefinition, g as FieldExposure, h as FieldTypeMap, i as FieldValidator, j as FieldValidatorResult, P as PIIEnforcement, R as RefEntityId, k as SCHEMA_IDENTITY_POLICIES, l as SCHEMA_UNKNOWN_FIELDS_POLICIES, m as SchemaIdentityPolicy, n as SchemaUpgradeFunction, o as SchemaUpgradeResult, p as SchemaUpgradeSpec, q as SchemaUpgradeStep, r as SchemaValidationContext, s as SerializeOptions, U as UnknownFieldsPolicy, t as ValidateCompositionOptions, u as ValidationIssueInput, v as ValidationResult, w as validateFeedbackGameDiagnostics } from './feedback-diagnostics-CnsI0B9-.js';
+import { FEEDBACK_CONTRACT_VERSION, FeedbackGameDiagnostics } from './feedback-diagnostics-vocabulary.js';
+export { FEEDBACK_BACKEND_BUCKETS, FEEDBACK_FRAME_RATE_BUCKETS, FEEDBACK_FRAME_TIME_BUCKETS, FEEDBACK_GAME_COUNTER_CODES, FEEDBACK_GAME_COUNTER_MAX_COUNT, FEEDBACK_GAME_COUNTER_MAX_ITEMS, FEEDBACK_GAME_ERROR_CODES, FEEDBACK_GAME_FEATURE_IDS, FEEDBACK_GAME_PROVENANCE_CONTRACTS, FEEDBACK_GAME_PROVENANCE_CONTRACT_IDS, FEEDBACK_GAME_SURFACE_IDS, FEEDBACK_RENDERER_BUCKETS, FEEDBACK_VIEWPORT_BUCKETS } from './feedback-diagnostics-vocabulary.js';
 
 declare const field: {
     string: () => FieldBuilder<string, string>;
@@ -422,10 +142,24 @@ declare function validatePercentage(value: unknown): boolean;
 declare function validateRichText(value: unknown): boolean;
 
 /**
- * Validates that a name is safe, culturally inclusive, and matches global best practice.
+ * Validates that a personal name is safe and culturally inclusive.
+ *
+ * Decimal digits remain unsupported because first, middle, and last names are
+ * personal-name components rather than public display identifiers.
+ *
  * Global Standard: OWASP Input Validation Cheat Sheet + ICAO Doc 9303 + IETF PRECIS
  */
 declare function validateName(value: unknown): boolean;
+/**
+ * Validates a public display name independently from personal-name fields.
+ *
+ * Unicode decimal digits are supported alongside letters and combining marks
+ * so legitimate display names such as `Player 2` remain representable without
+ * relaxing first, middle, or last-name validation.
+ *
+ * Global Standard: OWASP Input Validation Cheat Sheet + IETF PRECIS
+ */
+declare function validateDisplayName(value: unknown): boolean;
 
 /**
  * Validates that a user ID is a valid `sub` from one of the supported identity providers.
@@ -763,4 +497,863 @@ type PlayerSystemCuratedSnapshotEntity = PlayerSystemCuratedSnapshot & {
     version: "1.0.0";
 };
 
-export { type DeepReadonly, FieldBuilder, type FieldDefinition, type FieldExposure, type FieldType, type FieldTypeMap, type FieldValidator, type FieldValidatorResult, type Infer, IsoLanguageCode, type PIIEnforcement, PLAYER_SYSTEM_ACHIEVEMENT_TIERS, PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES, PLAYER_SYSTEM_EVENT_KINDS, type PlayerSystemAchievementEntry, type PlayerSystemAchievementTier, type PlayerSystemAchievementTrack, type PlayerSystemAchievementTrackStatus, type PlayerSystemCuratedSnapshot, type PlayerSystemCuratedSnapshotEntity, PlayerSystemCuratedSnapshotSchema, type PlayerSystemEventEntry, type PlayerSystemEventHighlight, type PlayerSystemEventKind, type PlayerSystemNormalizedEventBatch, type PlayerSystemNormalizedEventBatchEntity, PlayerSystemNormalizedEventBatchSchema, type PlayerSystemNormalizedObservedEvent, type PlayerSystemObservedEvent, type PlayerSystemObservedEventBatch, type PlayerSystemObservedEventBatchEntity, PlayerSystemObservedEventBatchSchema, type RefEntityId, type Schema, type SchemaOptions, type SchemaShape, type SchemaUpgradeFunction, type SchemaUpgradeResult, type SchemaUpgradeSpec, type SchemaUpgradeStep, type SerializeOptions, type ValidateCompositionOptions, type ValidationIssue, type ValidationIssueInput, type ValidationResult, createComponentSchema, createSchema, field, getAllComponentSchemas, getAllSchemas, getComponentSchema, getSchemaForType, isExtensionSingleton, isExtensionSubtag, isIsoLanguageCode, isPrivateUseSingleton, isPrivateUseSubtag, isRegionSubtag, isScriptSubtag, isVariantSubtag, isoCountryCodes, isoCurrencyCodes, registerComponentSchema, renderSchemaDescription, validateCountryCode, validateCurrencyCode, validateDateTimeISO, validateEmail, validateLanguage, validateName, validatePercentage, validatePhone, validateRichText, validateSafeText, validateSemVer, validateUUID, validateUrl, validateUserId, validateUserIdArray };
+/**
+ * Canonical Unicode normalization data shared by every v1 narrative
+ * processor.
+ */
+declare const FEEDBACK_UNICODE_NORMALIZATION_PROFILE: "unicode-15.1.0-nfkc-v1";
+/** Exact progressive bug cooldown ladder, in seconds. */
+declare const FEEDBACK_BUG_COOLDOWN_SECONDS: readonly [number, number, number, number, number];
+/** Exact post-review suppression period, in seconds. */
+declare const FEEDBACK_REVIEW_COOLDOWN_SECONDS: number;
+/** Stable issue types accepted by bug-report intake. */
+declare const FEEDBACK_ISSUE_TYPES: readonly ["visual-layout", "functionality", "gameplay", "performance-stability", "accessibility", "content-localisation", "account-access", "privacy-security", "other"];
+/** Issue types that may be persisted after intake routing. */
+declare const FEEDBACK_PERSISTABLE_ISSUE_TYPES: ("visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "other")[];
+/** Stable severity scale and translation keys for accessible star controls. */
+declare const FEEDBACK_SEVERITY_LEVELS: readonly [{
+    readonly value: 1;
+    readonly id: "cosmetic";
+    readonly labelKey: "feedback.severity.cosmetic";
+}, {
+    readonly value: 2;
+    readonly id: "minor";
+    readonly labelKey: "feedback.severity.minor";
+}, {
+    readonly value: 3;
+    readonly id: "disruptive";
+    readonly labelKey: "feedback.severity.disruptive";
+}, {
+    readonly value: 4;
+    readonly id: "blocking";
+    readonly labelKey: "feedback.severity.blocking";
+}, {
+    readonly value: 5;
+    readonly id: "critical";
+    readonly labelKey: "feedback.severity.critical";
+}];
+/** Stable satisfaction scale and translation keys for accessible stars. */
+declare const FEEDBACK_SATISFACTION_LEVELS: readonly [{
+    readonly value: 1;
+    readonly id: "very-poor";
+    readonly labelKey: "feedback.satisfaction.very-poor";
+}, {
+    readonly value: 2;
+    readonly id: "poor";
+    readonly labelKey: "feedback.satisfaction.poor";
+}, {
+    readonly value: 3;
+    readonly id: "fair";
+    readonly labelKey: "feedback.satisfaction.fair";
+}, {
+    readonly value: 4;
+    readonly id: "good";
+    readonly labelKey: "feedback.satisfaction.good";
+}, {
+    readonly value: 5;
+    readonly id: "excellent";
+    readonly labelKey: "feedback.satisfaction.excellent";
+}];
+/** Closed sentiment output from the transient English classifier. */
+declare const FEEDBACK_SENTIMENT_BUCKETS: readonly ["very-negative", "negative", "mixed", "neutral", "positive", "very-positive", "not-detected"];
+/** Closed intent output from the transient classifier. */
+declare const FEEDBACK_INTENT_IDS: readonly ["visual-layout", "functionality", "gameplay", "performance-stability", "accessibility", "content-localisation", "account-access", "other", "praise", "suggestion", "confusion", "frustration"];
+/** Closed theme output from the transient classifier. */
+declare const FEEDBACK_THEME_IDS: readonly ["navigation", "visual-design", "game-controls", "rendering", "responsiveness", "stability", "accessibility", "localisation", "account-access", "overall-experience", "other"];
+/** Closed site-section identifiers; arbitrary routes and URLs are forbidden. */
+declare const FEEDBACK_SURFACE_IDS: readonly ["site.about", "admin.analytics", "admin.capabilities", "admin.feature-flags", "admin.feedback", "admin.moderation", "admin.users", "site.chatbot", "site.generator", "site.gpu-demo", "site.home", "game.player-system", "account.profile", "site.video"];
+/** Canonical capability-projection metadata for every feedback surface. */
+declare const FEEDBACK_SURFACE_DEFINITIONS: readonly [{
+    readonly id: "site.about";
+    readonly labelKey: "feedback.surface.about";
+    readonly kind: "public";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "admin.analytics";
+    readonly labelKey: "feedback.surface.adminAnalytics";
+    readonly kind: "admin";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "admin.capabilities";
+    readonly labelKey: "feedback.surface.adminCapabilities";
+    readonly kind: "admin";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "admin.feature-flags";
+    readonly labelKey: "feedback.surface.adminFeatureFlags";
+    readonly kind: "admin";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "admin.feedback";
+    readonly labelKey: "feedback.surface.adminFeedback";
+    readonly kind: "admin";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "admin.moderation";
+    readonly labelKey: "feedback.surface.adminModeration";
+    readonly kind: "admin";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "admin.users";
+    readonly labelKey: "feedback.surface.adminUsers";
+    readonly kind: "admin";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "site.chatbot";
+    readonly labelKey: "feedback.surface.chatbot";
+    readonly kind: "public";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "site.generator";
+    readonly labelKey: "feedback.surface.generator";
+    readonly kind: "game";
+    readonly gameDiagnosticsEligible: true;
+}, {
+    readonly id: "site.gpu-demo";
+    readonly labelKey: "feedback.surface.gpuDemo";
+    readonly kind: "game";
+    readonly gameDiagnosticsEligible: true;
+}, {
+    readonly id: "site.home";
+    readonly labelKey: "feedback.surface.home";
+    readonly kind: "public";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "game.player-system";
+    readonly labelKey: "feedback.surface.playerSystem";
+    readonly kind: "game";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "account.profile";
+    readonly labelKey: "feedback.surface.profile";
+    readonly kind: "authenticated";
+    readonly gameDiagnosticsEligible: false;
+}, {
+    readonly id: "site.video";
+    readonly labelKey: "feedback.surface.video";
+    readonly kind: "public";
+    readonly gameDiagnosticsEligible: false;
+}];
+/** Closed reasons for falling back to explicit structured-only submission. */
+declare const FEEDBACK_STRUCTURED_ONLY_REASON_CODES: readonly ["analysis-unavailable", "invalid-envelope", "invalid-sensitive-payload", "language-not-enabled", "request-too-large", "length-required"];
+/** Pinned privacy policy versions permitted in retained analysis. */
+declare const FEEDBACK_PRIVACY_POLICY_VERSIONS: readonly ["feedback-privacy-en-v1"];
+/** Pinned local model versions permitted in retained analysis. */
+declare const FEEDBACK_ANALYSIS_MODEL_VERSIONS: readonly ["feedback-en-rules-v1"];
+/** Bug issue-type identifier. */
+type FeedbackIssueType = (typeof FEEDBACK_ISSUE_TYPES)[number];
+/** Persistable issue type after confidential security routing. */
+type FeedbackPersistableIssueType = (typeof FEEDBACK_PERSISTABLE_ISSUE_TYPES)[number];
+/** One-to-five bug severity. */
+type FeedbackSeverity = (typeof FEEDBACK_SEVERITY_LEVELS)[number]["value"];
+/** One-to-five satisfaction score. */
+type FeedbackSatisfaction = (typeof FEEDBACK_SATISFACTION_LEVELS)[number]["value"];
+/** Closed transient sentiment bucket. */
+type FeedbackSentiment = (typeof FEEDBACK_SENTIMENT_BUCKETS)[number];
+/** Closed transient intent identifier. */
+type FeedbackIntentId = (typeof FEEDBACK_INTENT_IDS)[number];
+/** Closed transient theme identifier. */
+type FeedbackThemeId = (typeof FEEDBACK_THEME_IDS)[number];
+/** Closed site-section identifier eligible for capability projection. */
+type FeedbackSurfaceId = (typeof FEEDBACK_SURFACE_IDS)[number];
+/** Supported rich-text mark. */
+type FeedbackRichTextMark = "bold" | "italic" | "underline";
+/** Text leaf in the transient rich-text AST. */
+interface FeedbackRichTextNode {
+    type: "text";
+    text: string;
+    marks?: readonly FeedbackRichTextMark[];
+}
+/** Paragraph or bullet-list item in the transient rich-text AST. */
+type FeedbackRichTextBlock = {
+    type: "paragraph";
+    depth: number;
+    children: readonly FeedbackRichTextNode[];
+} | {
+    type: "listItem";
+    listType: "bullet";
+    depth: number;
+    children: readonly FeedbackRichTextNode[];
+};
+/** Browser/scanner interoperable transient document. */
+interface FeedbackRichTextDocument {
+    type: "doc";
+    schemaVersion: "1";
+    children: readonly FeedbackRichTextBlock[];
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+}
+/** Browser/scanner interoperable encrypted narrative envelope. */
+interface FeedbackEncryptedNarrativeEnvelope {
+    type: "feedback-encrypted-narrative-envelope";
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+    schemaVersion: "1";
+    keyId: string;
+    algorithm: "RSA-OAEP-256+A256GCM";
+    wrappedKey: string;
+    iv: string;
+    ciphertext: string;
+    authenticationTag: string;
+}
+interface FeedbackTransientAnalysisRequestBase {
+    type: "feedback-transient-analysis-request";
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+    schemaVersion: "1";
+    requestId: string;
+    deterministicRedactionCount: number;
+    envelope: FeedbackEncryptedNarrativeEnvelope;
+}
+/**
+ * One-use bug analysis request bound to a closed surface that the service
+ * must authorise before handing ciphertext to the private scanner.
+ */
+interface FeedbackBugTransientAnalysisRequest extends FeedbackTransientAnalysisRequestBase {
+    purpose: "bug";
+    surfaceId: FeedbackSurfaceId;
+}
+/** One-use satisfaction-review analysis request with no site surface. */
+interface FeedbackReviewTransientAnalysisRequest extends FeedbackTransientAnalysisRequestBase {
+    purpose: "review";
+    surfaceId?: never;
+}
+/** Closed purpose-discriminated request that must never be persisted or logged. */
+type FeedbackTransientAnalysisRequest = FeedbackBugTransientAnalysisRequest | FeedbackReviewTransientAnalysisRequest;
+/** Typed result for the purpose-discriminated transient request validator. */
+type FeedbackTransientAnalysisRequestValidationResult = {
+    readonly valid: true;
+    readonly value: FeedbackTransientAnalysisRequest;
+    readonly errors?: never;
+    readonly issues?: never;
+} | {
+    readonly valid: false;
+    readonly value?: never;
+    readonly errors: readonly string[];
+    readonly issues?: readonly ValidationIssue[];
+};
+/** Closed classifier fields that may be persisted. */
+interface FeedbackDerivedAnalysis {
+    type: "feedback-derived-analysis";
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+    status: "analyzed" | "structured-only";
+    sentiment?: FeedbackSentiment;
+    intentIds: readonly FeedbackIntentId[];
+    themeIds: readonly FeedbackThemeId[];
+    confidence?: "low" | "medium" | "high";
+    policyVersion: string;
+    modelVersion: string;
+    deterministicRedactionCount: number;
+    scannerRedactionCount: number;
+}
+/** Ephemeral one-use scanner receipt. */
+interface FeedbackAnalysisReceipt extends Omit<FeedbackDerivedAnalysis, "type" | "status"> {
+    type: "feedback-analysis-receipt";
+    status: "analyzed";
+    receiptId: string;
+    analyzedAt: string;
+}
+/** Identifier-free immutable bug packet. */
+interface FeedbackBugPacket {
+    type: "feedback-bug-packet";
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+    packetId: string;
+    acceptedAt: string;
+    surfaceId: string;
+    issueType: FeedbackPersistableIssueType;
+    severity: FeedbackSeverity;
+    releaseId: string;
+    buildId: string;
+    analysis?: FeedbackDerivedAnalysis;
+    gameDiagnostics?: FeedbackGameDiagnostics;
+}
+/** Identifier-free immutable satisfaction packet. */
+interface FeedbackReviewPacket {
+    type: "feedback-review-packet";
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+    packetId: string;
+    acceptedAt: string;
+    satisfaction: FeedbackSatisfaction;
+    analysis?: FeedbackDerivedAnalysis;
+}
+/** Count bucket used by materialized feedback reports. */
+interface FeedbackCountBucket {
+    id: string;
+    count: number;
+}
+/** A weekly public point that reveals nothing when the privacy threshold fails. */
+type FeedbackPublicWeeklyPoint = {
+    weekStart: string;
+    state: "suppressed";
+} | {
+    weekStart: string;
+    state: "published";
+    acceptedReviewCount: number;
+    averageStars: number;
+};
+/** Thresholded preceding-window facts used to derive the public trend. */
+interface FeedbackPublicComparison {
+    previousAcceptedReviewCount: number;
+    previousAverageStars: number;
+    deltaStars: number;
+}
+interface FeedbackPublicSummaryBase {
+    type: "feedback-public-summary";
+    version: typeof FEEDBACK_CONTRACT_VERSION;
+    snapshotId: string;
+    generatedAt: string;
+    asOf: string;
+    freshness: "fresh" | "stale";
+    reportAgeSeconds: number;
+    rollingWindowDays: 90;
+    weeklyPoints: readonly FeedbackPublicWeeklyPoint[];
+}
+/** Daily read model that omits every public metric below ten reviews. */
+type FeedbackPublicSummary = (FeedbackPublicSummaryBase & {
+    state: "suppressed";
+}) | (FeedbackPublicSummaryBase & {
+    state: "published";
+    acceptedReviewCount: number;
+    averageStars: number;
+    comparison?: FeedbackPublicComparison;
+    trend?: "up" | "flat" | "down";
+});
+/** AST used only inside the transient no-retention narrative scanner. */
+declare const FeedbackRichTextAstSchema: Schema<{
+    schemaVersion: FieldBuilder<"1", "1">;
+    children: FieldBuilder<unknown, unknown>;
+}>;
+/** Encrypted outer envelope accepted by privacy-specific middleware. */
+declare const FeedbackEncryptedNarrativeEnvelopeSchema: Schema<{
+    schemaVersion: FieldBuilder<"1", "1">;
+    keyId: FieldBuilder<string, string>;
+    algorithm: FieldBuilder<"RSA-OAEP-256+A256GCM", "RSA-OAEP-256+A256GCM">;
+    wrappedKey: FieldBuilder<string, string>;
+    iv: FieldBuilder<string, string>;
+    ciphertext: FieldBuilder<string, string>;
+    authenticationTag: FieldBuilder<string, string>;
+    type?: FieldBuilder<"feedback-encrypted-narrative-envelope", "feedback-encrypted-narrative-envelope"> | undefined;
+    version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+}>;
+/** Transient scanner request; this contract must never be stored or logged. */
+declare const FeedbackTransientAnalysisRequestSchema: Schema<{
+    schemaVersion: FieldBuilder<"1", "1">;
+    requestId: FieldBuilder<string, string>;
+    purpose: FieldBuilder<"bug" | "review", "bug" | "review">;
+    surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video", "site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video">;
+    deterministicRedactionCount: FieldBuilder<number, number>;
+    envelope: FieldBuilder<{
+        schemaVersion: FieldBuilder<"1", "1">;
+        keyId: FieldBuilder<string, string>;
+        algorithm: FieldBuilder<"RSA-OAEP-256+A256GCM", "RSA-OAEP-256+A256GCM">;
+        wrappedKey: FieldBuilder<string, string>;
+        iv: FieldBuilder<string, string>;
+        ciphertext: FieldBuilder<string, string>;
+        authenticationTag: FieldBuilder<string, string>;
+        type?: FieldBuilder<"feedback-encrypted-narrative-envelope", "feedback-encrypted-narrative-envelope"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        schemaVersion: FieldBuilder<"1", "1">;
+        keyId: FieldBuilder<string, string>;
+        algorithm: FieldBuilder<"RSA-OAEP-256+A256GCM", "RSA-OAEP-256+A256GCM">;
+        wrappedKey: FieldBuilder<string, string>;
+        iv: FieldBuilder<string, string>;
+        ciphertext: FieldBuilder<string, string>;
+        authenticationTag: FieldBuilder<string, string>;
+        type?: FieldBuilder<"feedback-encrypted-narrative-envelope", "feedback-encrypted-narrative-envelope"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+}>;
+/**
+ * Validate and clone a transient request while preserving its purpose
+ * discriminator for TypeScript consumers.
+ */
+declare const validateFeedbackTransientAnalysisRequest: (input: unknown) => FeedbackTransientAnalysisRequestValidationResult;
+/** Identifier-free, closed classifier output safe to copy into a packet. */
+declare const FeedbackAnalysisReceiptSchema: Schema<{
+    analyzedAt: FieldBuilder<string, string>;
+    status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+    sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+    intentIds: FieldBuilder<unknown, unknown>;
+    themeIds: FieldBuilder<unknown, unknown>;
+    confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+    policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+    modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+    deterministicRedactionCount: FieldBuilder<number, number>;
+    scannerRedactionCount: FieldBuilder<number, number>;
+    type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+    version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    receiptId: FieldBuilder<string, string>;
+}>;
+/**
+ * Persistable classifier projection. Unlike the transient receipt it contains
+ * no receipt identifier or scanner timestamp that could enable cross-boundary
+ * joining.
+ */
+declare const FeedbackDerivedAnalysisSchema: Schema<{
+    status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+    sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+    intentIds: FieldBuilder<unknown, unknown>;
+    themeIds: FieldBuilder<unknown, unknown>;
+    confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+    policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+    modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+    deterministicRedactionCount: FieldBuilder<number, number>;
+    scannerRedactionCount: FieldBuilder<number, number>;
+    type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+    version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+}>;
+/** Capability-filtered surface catalog with no hidden entitlement metadata. */
+declare const FeedbackSurfaceCatalogSchema: Schema<{
+    generatedAt: FieldBuilder<string, string>;
+    catalogVersion: FieldBuilder<string, string>;
+    surfaces: FieldBuilder<unknown, unknown>;
+}>;
+/** Capability-filtered surface catalog and effective feedback eligibility. */
+declare const FeedbackContextSchema: Schema<{
+    generatedAt: FieldBuilder<string, string>;
+    catalogVersion: FieldBuilder<string, string>;
+    surfaces: FieldBuilder<unknown, unknown>;
+    selectedSurfaceId: FieldBuilder<"site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video", "site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video">;
+    flags: FieldBuilder<{
+        bugReport: FieldBuilder<boolean, boolean>;
+        review: FieldBuilder<boolean, boolean>;
+        transientAnalysis: FieldBuilder<boolean, boolean>;
+        reporting: FieldBuilder<boolean, boolean>;
+        admin: FieldBuilder<boolean, boolean>;
+        mcp: FieldBuilder<boolean, boolean>;
+        publicHonesty: FieldBuilder<boolean, boolean>;
+        gameDiagnostics: FieldBuilder<boolean, boolean>;
+        anonymous: FieldBuilder<boolean, boolean>;
+    }, {
+        bugReport: FieldBuilder<boolean, boolean>;
+        review: FieldBuilder<boolean, boolean>;
+        transientAnalysis: FieldBuilder<boolean, boolean>;
+        reporting: FieldBuilder<boolean, boolean>;
+        admin: FieldBuilder<boolean, boolean>;
+        mcp: FieldBuilder<boolean, boolean>;
+        publicHonesty: FieldBuilder<boolean, boolean>;
+        gameDiagnostics: FieldBuilder<boolean, boolean>;
+        anonymous: FieldBuilder<boolean, boolean>;
+    }>;
+    eligibility: FieldBuilder<{
+        bugReport: FieldBuilder<boolean, boolean>;
+        review: FieldBuilder<boolean, boolean>;
+        gameDiagnostics: FieldBuilder<boolean, boolean>;
+        bugAvailableAt: FieldBuilder<string, string>;
+        reviewAvailableAt: FieldBuilder<string, string>;
+        bugRetryAfterSeconds: FieldBuilder<number, number>;
+    }, {
+        bugReport: FieldBuilder<boolean, boolean>;
+        review: FieldBuilder<boolean, boolean>;
+        gameDiagnostics: FieldBuilder<boolean, boolean>;
+        bugAvailableAt: FieldBuilder<string, string>;
+        reviewAvailableAt: FieldBuilder<string, string>;
+        bugRetryAfterSeconds: FieldBuilder<number, number>;
+    }>;
+    ingestionKey: FieldBuilder<{
+        keyId: FieldBuilder<string, string>;
+        algorithm: FieldBuilder<"RSA-OAEP-256", "RSA-OAEP-256">;
+        publicJwk: FieldBuilder<{
+            kty: FieldBuilder<"RSA", "RSA">;
+            alg: FieldBuilder<"RSA-OAEP-256", "RSA-OAEP-256">;
+            use: FieldBuilder<"enc", "enc">;
+            key_ops: FieldBuilder<unknown, unknown>;
+            n: FieldBuilder<string, string>;
+            e: FieldBuilder<string, string>;
+            ext: FieldBuilder<boolean, boolean>;
+        }, {
+            kty: FieldBuilder<"RSA", "RSA">;
+            alg: FieldBuilder<"RSA-OAEP-256", "RSA-OAEP-256">;
+            use: FieldBuilder<"enc", "enc">;
+            key_ops: FieldBuilder<unknown, unknown>;
+            n: FieldBuilder<string, string>;
+            e: FieldBuilder<string, string>;
+            ext: FieldBuilder<boolean, boolean>;
+        }>;
+        expiresAt: FieldBuilder<string, string>;
+    }, {
+        keyId: FieldBuilder<string, string>;
+        algorithm: FieldBuilder<"RSA-OAEP-256", "RSA-OAEP-256">;
+        publicJwk: FieldBuilder<{
+            kty: FieldBuilder<"RSA", "RSA">;
+            alg: FieldBuilder<"RSA-OAEP-256", "RSA-OAEP-256">;
+            use: FieldBuilder<"enc", "enc">;
+            key_ops: FieldBuilder<unknown, unknown>;
+            n: FieldBuilder<string, string>;
+            e: FieldBuilder<string, string>;
+            ext: FieldBuilder<boolean, boolean>;
+        }, {
+            kty: FieldBuilder<"RSA", "RSA">;
+            alg: FieldBuilder<"RSA-OAEP-256", "RSA-OAEP-256">;
+            use: FieldBuilder<"enc", "enc">;
+            key_ops: FieldBuilder<unknown, unknown>;
+            n: FieldBuilder<string, string>;
+            e: FieldBuilder<string, string>;
+            ext: FieldBuilder<boolean, boolean>;
+        }>;
+        expiresAt: FieldBuilder<string, string>;
+    }>;
+}>;
+/** Dirty structured fields sent by focus-loss autosave. */
+declare const FeedbackDraftUpsertRequestSchema: Schema<{
+    surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video", "site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video">;
+    issueType: FieldBuilder<"visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "privacy-security" | "other", "visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "privacy-security" | "other">;
+    severity: FieldBuilder<number, number>;
+    satisfaction: FieldBuilder<number, number>;
+    analysisReceiptId: FieldBuilder<string, string>;
+    draftId: FieldBuilder<string, string>;
+    kind: FieldBuilder<"bug" | "review", "bug" | "review">;
+    revision: FieldBuilder<number, number>;
+}>;
+/** Short-lived structured draft packet; narrative and ciphertext are excluded. */
+declare const FeedbackDraftPacketSchema: Schema<{
+    draftId: FieldBuilder<string, string>;
+    kind: FieldBuilder<"bug" | "review", "bug" | "review">;
+    revision: FieldBuilder<number, number>;
+    surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video", "site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video">;
+    issueType: FieldBuilder<"visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "privacy-security" | "other", "visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "privacy-security" | "other">;
+    severity: FieldBuilder<number, number>;
+    satisfaction: FieldBuilder<number, number>;
+    analysis: FieldBuilder<{
+        status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+        sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+        intentIds: FieldBuilder<unknown, unknown>;
+        themeIds: FieldBuilder<unknown, unknown>;
+        confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+        policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+        modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+        deterministicRedactionCount: FieldBuilder<number, number>;
+        scannerRedactionCount: FieldBuilder<number, number>;
+        type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+        sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+        intentIds: FieldBuilder<unknown, unknown>;
+        themeIds: FieldBuilder<unknown, unknown>;
+        confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+        policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+        modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+        deterministicRedactionCount: FieldBuilder<number, number>;
+        scannerRedactionCount: FieldBuilder<number, number>;
+        type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+    serverUpdatedAt: FieldBuilder<string, string>;
+    expiresAt: FieldBuilder<string, string>;
+}>;
+/** ETag-external response after a structured draft is durably saved. */
+declare const FeedbackDraftReceiptSchema: Schema<{
+    draftId: FieldBuilder<string, string>;
+    revision: FieldBuilder<number, number>;
+    savedAt: FieldBuilder<string, string>;
+    expiresAt: FieldBuilder<string, string>;
+}>;
+/**
+ * Explicit final bug submission request. Transport idempotency belongs only
+ * in the HTTP Idempotency-Key header and is not part of this JSON contract.
+ */
+declare const FeedbackBugSubmissionRequestSchema: Schema<{
+    draftId: FieldBuilder<string, string>;
+    surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video", "site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video">;
+    issueType: FieldBuilder<"visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "privacy-security" | "other", "visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "privacy-security" | "other">;
+    severity: FieldBuilder<number, number>;
+    analysisReceiptId: FieldBuilder<string, string>;
+    gameDiagnostics: FieldBuilder<{
+        surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo", "site.generator" | "site.gpu-demo">;
+        consentConfirmed: FieldBuilder<boolean, boolean>;
+        provenanceContractId: FieldBuilder<"generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1", "generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1">;
+        renderer: FieldBuilder<"webgl2" | "webgpu" | "canvas2d" | "unknown", "webgl2" | "webgpu" | "canvas2d" | "unknown">;
+        backend: FieldBuilder<"unknown" | "browser" | "worker", "unknown" | "browser" | "worker">;
+        viewportBucket: FieldBuilder<"unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape", "unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape">;
+        frameRateBucket: FieldBuilder<"unknown" | "under-15" | "15-29" | "30-59" | "60-plus", "unknown" | "under-15" | "15-29" | "30-59" | "60-plus">;
+        frameTimeBucket: FieldBuilder<"unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms", "unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms">;
+        featureIds: FieldBuilder<unknown, unknown>;
+        counters: FieldBuilder<unknown, unknown>;
+        errorCodes: FieldBuilder<unknown, unknown>;
+        type?: FieldBuilder<"feedback-game-diagnostics", "feedback-game-diagnostics"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo", "site.generator" | "site.gpu-demo">;
+        consentConfirmed: FieldBuilder<boolean, boolean>;
+        provenanceContractId: FieldBuilder<"generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1", "generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1">;
+        renderer: FieldBuilder<"webgl2" | "webgpu" | "canvas2d" | "unknown", "webgl2" | "webgpu" | "canvas2d" | "unknown">;
+        backend: FieldBuilder<"unknown" | "browser" | "worker", "unknown" | "browser" | "worker">;
+        viewportBucket: FieldBuilder<"unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape", "unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape">;
+        frameRateBucket: FieldBuilder<"unknown" | "under-15" | "15-29" | "30-59" | "60-plus", "unknown" | "under-15" | "15-29" | "30-59" | "60-plus">;
+        frameTimeBucket: FieldBuilder<"unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms", "unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms">;
+        featureIds: FieldBuilder<unknown, unknown>;
+        counters: FieldBuilder<unknown, unknown>;
+        errorCodes: FieldBuilder<unknown, unknown>;
+        type?: FieldBuilder<"feedback-game-diagnostics", "feedback-game-diagnostics"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+}>;
+/**
+ * Explicit authenticated satisfaction-review submission request. Transport
+ * idempotency belongs only in the HTTP Idempotency-Key header.
+ */
+declare const FeedbackReviewSubmissionRequestSchema: Schema<{
+    draftId: FieldBuilder<string, string>;
+    satisfaction: FieldBuilder<number, number>;
+    analysisReceiptId: FieldBuilder<string, string>;
+}>;
+/** Identifier-free response after an immutable packet is accepted. */
+declare const FeedbackAcceptanceReceiptSchema: Schema<{
+    packetId: FieldBuilder<string, string>;
+    kind: FieldBuilder<"bug" | "review", "bug" | "review">;
+    acceptedAt: FieldBuilder<string, string>;
+    nextEligibleAt: FieldBuilder<string, string>;
+}>;
+/** Safe analysis fallback; it contains neither a receipt nor narrative. */
+declare const FeedbackStructuredOnlyAnalysisResultSchema: Schema<{
+    status: FieldBuilder<"structured-only-required", "structured-only-required">;
+    reasonCode: FieldBuilder<"analysis-unavailable" | "invalid-envelope" | "invalid-sensitive-payload" | "language-not-enabled" | "request-too-large" | "length-required", "analysis-unavailable" | "invalid-envelope" | "invalid-sensitive-payload" | "language-not-enabled" | "request-too-large" | "length-required">;
+}>;
+/** Immutable structured bug packet for private blob storage. */
+declare const FeedbackBugPacketSchema: Schema<{
+    packetId: FieldBuilder<string, string>;
+    acceptedAt: FieldBuilder<string, string>;
+    surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video", "site.generator" | "site.gpu-demo" | "site.about" | "admin.analytics" | "admin.capabilities" | "admin.feature-flags" | "admin.feedback" | "admin.moderation" | "admin.users" | "site.chatbot" | "site.home" | "game.player-system" | "account.profile" | "site.video">;
+    issueType: FieldBuilder<"visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "other", "visual-layout" | "functionality" | "gameplay" | "performance-stability" | "accessibility" | "content-localisation" | "account-access" | "other">;
+    severity: FieldBuilder<number, number>;
+    releaseId: FieldBuilder<string, string>;
+    buildId: FieldBuilder<string, string>;
+    analysis: FieldBuilder<{
+        status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+        sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+        intentIds: FieldBuilder<unknown, unknown>;
+        themeIds: FieldBuilder<unknown, unknown>;
+        confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+        policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+        modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+        deterministicRedactionCount: FieldBuilder<number, number>;
+        scannerRedactionCount: FieldBuilder<number, number>;
+        type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+        sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+        intentIds: FieldBuilder<unknown, unknown>;
+        themeIds: FieldBuilder<unknown, unknown>;
+        confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+        policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+        modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+        deterministicRedactionCount: FieldBuilder<number, number>;
+        scannerRedactionCount: FieldBuilder<number, number>;
+        type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+    gameDiagnostics: FieldBuilder<{
+        surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo", "site.generator" | "site.gpu-demo">;
+        consentConfirmed: FieldBuilder<boolean, boolean>;
+        provenanceContractId: FieldBuilder<"generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1", "generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1">;
+        renderer: FieldBuilder<"webgl2" | "webgpu" | "canvas2d" | "unknown", "webgl2" | "webgpu" | "canvas2d" | "unknown">;
+        backend: FieldBuilder<"unknown" | "browser" | "worker", "unknown" | "browser" | "worker">;
+        viewportBucket: FieldBuilder<"unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape", "unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape">;
+        frameRateBucket: FieldBuilder<"unknown" | "under-15" | "15-29" | "30-59" | "60-plus", "unknown" | "under-15" | "15-29" | "30-59" | "60-plus">;
+        frameTimeBucket: FieldBuilder<"unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms", "unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms">;
+        featureIds: FieldBuilder<unknown, unknown>;
+        counters: FieldBuilder<unknown, unknown>;
+        errorCodes: FieldBuilder<unknown, unknown>;
+        type?: FieldBuilder<"feedback-game-diagnostics", "feedback-game-diagnostics"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo", "site.generator" | "site.gpu-demo">;
+        consentConfirmed: FieldBuilder<boolean, boolean>;
+        provenanceContractId: FieldBuilder<"generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1", "generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1">;
+        renderer: FieldBuilder<"webgl2" | "webgpu" | "canvas2d" | "unknown", "webgl2" | "webgpu" | "canvas2d" | "unknown">;
+        backend: FieldBuilder<"unknown" | "browser" | "worker", "unknown" | "browser" | "worker">;
+        viewportBucket: FieldBuilder<"unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape", "unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape">;
+        frameRateBucket: FieldBuilder<"unknown" | "under-15" | "15-29" | "30-59" | "60-plus", "unknown" | "under-15" | "15-29" | "30-59" | "60-plus">;
+        frameTimeBucket: FieldBuilder<"unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms", "unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms">;
+        featureIds: FieldBuilder<unknown, unknown>;
+        counters: FieldBuilder<unknown, unknown>;
+        errorCodes: FieldBuilder<unknown, unknown>;
+        type?: FieldBuilder<"feedback-game-diagnostics", "feedback-game-diagnostics"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+}>;
+/** Immutable structured review packet for private blob storage. */
+declare const FeedbackReviewPacketSchema: Schema<{
+    packetId: FieldBuilder<string, string>;
+    acceptedAt: FieldBuilder<string, string>;
+    satisfaction: FieldBuilder<number, number>;
+    analysis: FieldBuilder<{
+        status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+        sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+        intentIds: FieldBuilder<unknown, unknown>;
+        themeIds: FieldBuilder<unknown, unknown>;
+        confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+        policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+        modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+        deterministicRedactionCount: FieldBuilder<number, number>;
+        scannerRedactionCount: FieldBuilder<number, number>;
+        type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        status: FieldBuilder<"analyzed" | "structured-only", "analyzed" | "structured-only">;
+        sentiment: FieldBuilder<"very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected", "very-negative" | "negative" | "mixed" | "neutral" | "positive" | "very-positive" | "not-detected">;
+        intentIds: FieldBuilder<unknown, unknown>;
+        themeIds: FieldBuilder<unknown, unknown>;
+        confidence: FieldBuilder<"low" | "high" | "medium", "low" | "high" | "medium">;
+        policyVersion: FieldBuilder<"feedback-privacy-en-v1", "feedback-privacy-en-v1">;
+        modelVersion: FieldBuilder<"feedback-en-rules-v1", "feedback-en-rules-v1">;
+        deterministicRedactionCount: FieldBuilder<number, number>;
+        scannerRedactionCount: FieldBuilder<number, number>;
+        type?: FieldBuilder<"feedback-derived-analysis", "feedback-derived-analysis"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+}>;
+/** Safe facts used to reconstruct a representative in-game view server-side. */
+declare const FeedbackGameReconstructionManifestSchema: Schema<{
+    reconstructionId: FieldBuilder<string, string>;
+    bugPacketId: FieldBuilder<string, string>;
+    createdAt: FieldBuilder<string, string>;
+    expiresAt: FieldBuilder<string, string>;
+    curatedAssetSetId: FieldBuilder<string, string>;
+    noticeKey: FieldBuilder<string, string>;
+    diagnostics: FieldBuilder<{
+        surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo", "site.generator" | "site.gpu-demo">;
+        consentConfirmed: FieldBuilder<boolean, boolean>;
+        provenanceContractId: FieldBuilder<"generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1", "generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1">;
+        renderer: FieldBuilder<"webgl2" | "webgpu" | "canvas2d" | "unknown", "webgl2" | "webgpu" | "canvas2d" | "unknown">;
+        backend: FieldBuilder<"unknown" | "browser" | "worker", "unknown" | "browser" | "worker">;
+        viewportBucket: FieldBuilder<"unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape", "unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape">;
+        frameRateBucket: FieldBuilder<"unknown" | "under-15" | "15-29" | "30-59" | "60-plus", "unknown" | "under-15" | "15-29" | "30-59" | "60-plus">;
+        frameTimeBucket: FieldBuilder<"unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms", "unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms">;
+        featureIds: FieldBuilder<unknown, unknown>;
+        counters: FieldBuilder<unknown, unknown>;
+        errorCodes: FieldBuilder<unknown, unknown>;
+        type?: FieldBuilder<"feedback-game-diagnostics", "feedback-game-diagnostics"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }, {
+        surfaceId: FieldBuilder<"site.generator" | "site.gpu-demo", "site.generator" | "site.gpu-demo">;
+        consentConfirmed: FieldBuilder<boolean, boolean>;
+        provenanceContractId: FieldBuilder<"generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1", "generator.renderer-diagnostics.v1" | "gpu-demo.renderer-diagnostics.v1">;
+        renderer: FieldBuilder<"webgl2" | "webgpu" | "canvas2d" | "unknown", "webgl2" | "webgpu" | "canvas2d" | "unknown">;
+        backend: FieldBuilder<"unknown" | "browser" | "worker", "unknown" | "browser" | "worker">;
+        viewportBucket: FieldBuilder<"unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape", "unknown" | "small-portrait" | "small-landscape" | "medium-portrait" | "medium-landscape" | "large-portrait" | "large-landscape">;
+        frameRateBucket: FieldBuilder<"unknown" | "under-15" | "15-29" | "30-59" | "60-plus", "unknown" | "under-15" | "15-29" | "30-59" | "60-plus">;
+        frameTimeBucket: FieldBuilder<"unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms", "unknown" | "under-17ms" | "17-33ms" | "34-66ms" | "over-66ms">;
+        featureIds: FieldBuilder<unknown, unknown>;
+        counters: FieldBuilder<unknown, unknown>;
+        errorCodes: FieldBuilder<unknown, unknown>;
+        type?: FieldBuilder<"feedback-game-diagnostics", "feedback-game-diagnostics"> | undefined;
+        version?: FieldBuilder<"1.0.0", "1.0.0"> | undefined;
+    }>;
+}>;
+/** Materialized report for one previous UTC bug-health hour. */
+declare const FeedbackHourlyBugReportSchema: Schema<{
+    reportId: FieldBuilder<string, string>;
+    windowStart: FieldBuilder<string, string>;
+    windowEnd: FieldBuilder<string, string>;
+    revision: FieldBuilder<number, number>;
+    generatedAt: FieldBuilder<string, string>;
+    acceptedCount: FieldBuilder<number, number>;
+    rejectedCount: FieldBuilder<number, number>;
+    diagnosticsAttachedCount: FieldBuilder<number, number>;
+    deterministicRedactionCount: FieldBuilder<number, number>;
+    scannerRedactionCount: FieldBuilder<number, number>;
+    processorLagSeconds: FieldBuilder<number, number>;
+    rates: FieldBuilder<{
+        rejectionRate: FieldBuilder<number, number>;
+        deterministicRedactionsPerAccepted: FieldBuilder<number, number>;
+        scannerRedactionsPerAccepted: FieldBuilder<number, number>;
+    }, {
+        rejectionRate: FieldBuilder<number, number>;
+        deterministicRedactionsPerAccepted: FieldBuilder<number, number>;
+        scannerRedactionsPerAccepted: FieldBuilder<number, number>;
+    }>;
+    traffic: FieldBuilder<{
+        denominator: FieldBuilder<number, number>;
+        acceptedPerTenThousand: FieldBuilder<number, number>;
+    }, {
+        denominator: FieldBuilder<number, number>;
+        acceptedPerTenThousand: FieldBuilder<number, number>;
+    }>;
+    targetDistribution: FieldBuilder<unknown, unknown>;
+    issueTypeDistribution: FieldBuilder<unknown, unknown>;
+    severityDistribution: FieldBuilder<unknown, unknown>;
+    intentDistribution: FieldBuilder<unknown, unknown>;
+    buildDistribution: FieldBuilder<unknown, unknown>;
+    rendererDistribution: FieldBuilder<unknown, unknown>;
+    backendDistribution: FieldBuilder<unknown, unknown>;
+    viewportDistribution: FieldBuilder<unknown, unknown>;
+    frameRateDistribution: FieldBuilder<unknown, unknown>;
+    frameTimeDistribution: FieldBuilder<unknown, unknown>;
+    diagnosticFeatureDistribution: FieldBuilder<unknown, unknown>;
+    diagnosticCounterDistribution: FieldBuilder<unknown, unknown>;
+    diagnosticErrorDistribution: FieldBuilder<unknown, unknown>;
+    abuseBlockBands: FieldBuilder<unknown, unknown>;
+    comparison: FieldBuilder<{
+        previousHourRatio: FieldBuilder<number, number>;
+        sevenDaySameHourRatio: FieldBuilder<number, number>;
+    }, {
+        previousHourRatio: FieldBuilder<number, number>;
+        sevenDaySameHourRatio: FieldBuilder<number, number>;
+    }>;
+    advisories: FieldBuilder<unknown, unknown>;
+}>;
+/** Materialized daily satisfaction report. */
+declare const FeedbackDailySatisfactionReportSchema: Schema<{
+    reportId: FieldBuilder<string, string>;
+    windowStart: FieldBuilder<string, string>;
+    windowEnd: FieldBuilder<string, string>;
+    revision: FieldBuilder<number, number>;
+    generatedAt: FieldBuilder<string, string>;
+    processorLagSeconds: FieldBuilder<number, number>;
+    acceptedReviewCount: FieldBuilder<number, number>;
+    meanStars: FieldBuilder<number, number>;
+    medianStars: FieldBuilder<number, number>;
+    starDistribution: FieldBuilder<unknown, unknown>;
+    sentimentDistribution: FieldBuilder<unknown, unknown>;
+    intentDistribution: FieldBuilder<unknown, unknown>;
+    rollingWindows: FieldBuilder<unknown, unknown>;
+    previousPeriodDeltaStars: FieldBuilder<number, number>;
+    advisories: FieldBuilder<unknown, unknown>;
+}>;
+/** Privacy-thresholded public honesty snapshot materialized once per day. */
+declare const FeedbackPublicSummarySchema: Schema<{
+    snapshotId: FieldBuilder<string, string>;
+    generatedAt: FieldBuilder<string, string>;
+    asOf: FieldBuilder<string, string>;
+    freshness: FieldBuilder<"fresh" | "stale", "fresh" | "stale">;
+    reportAgeSeconds: FieldBuilder<number, number>;
+    rollingWindowDays: FieldBuilder<90, 90>;
+    state: FieldBuilder<"suppressed" | "published", "suppressed" | "published">;
+    acceptedReviewCount: FieldBuilder<number, number>;
+    averageStars: FieldBuilder<number, number>;
+    trend: FieldBuilder<"flat" | "up" | "down", "flat" | "up" | "down">;
+    comparison: FieldBuilder<{
+        previousAcceptedReviewCount: FieldBuilder<number, number>;
+        previousAverageStars: FieldBuilder<number, number>;
+        deltaStars: FieldBuilder<number, number>;
+    }, {
+        previousAcceptedReviewCount: FieldBuilder<number, number>;
+        previousAverageStars: FieldBuilder<number, number>;
+        deltaStars: FieldBuilder<number, number>;
+    }>;
+    weeklyPoints: FieldBuilder<unknown, unknown>;
+}>;
+/** Conditional-write checkpoint for replay-safe timer processors. */
+declare const FeedbackProcessorCheckpointSchema: Schema<{
+    checkpointId: FieldBuilder<string, string>;
+    processor: FieldBuilder<"bug-hourly" | "review-daily" | "commit-reconciliation", "bug-hourly" | "review-daily" | "commit-reconciliation">;
+    windowKey: FieldBuilder<string, string>;
+    revision: FieldBuilder<number, number>;
+    completedAt: FieldBuilder<string, string>;
+    reportId: FieldBuilder<string, string>;
+}>;
+/** Immutable manifest describing one bounded materialization attempt. */
+declare const FeedbackMaterializationManifestSchema: Schema<{
+    manifestId: FieldBuilder<string, string>;
+    processor: FieldBuilder<"bug-hourly" | "review-daily" | "commit-reconciliation", "bug-hourly" | "review-daily" | "commit-reconciliation">;
+    windowKey: FieldBuilder<string, string>;
+    revision: FieldBuilder<number, number>;
+    generatedAt: FieldBuilder<string, string>;
+    sourcePacketCount: FieldBuilder<number, number>;
+    lateArrivalCount: FieldBuilder<number, number>;
+    outputReportId: FieldBuilder<string, string>;
+    status: FieldBuilder<"published" | "corrected" | "no-op", "published" | "corrected" | "no-op">;
+}>;
+
+export { FEEDBACK_ANALYSIS_MODEL_VERSIONS, FEEDBACK_BUG_COOLDOWN_SECONDS, FEEDBACK_CONTRACT_VERSION, FEEDBACK_INTENT_IDS, FEEDBACK_ISSUE_TYPES, FEEDBACK_PERSISTABLE_ISSUE_TYPES, FEEDBACK_PRIVACY_POLICY_VERSIONS, FEEDBACK_REVIEW_COOLDOWN_SECONDS, FEEDBACK_SATISFACTION_LEVELS, FEEDBACK_SENTIMENT_BUCKETS, FEEDBACK_SEVERITY_LEVELS, FEEDBACK_STRUCTURED_ONLY_REASON_CODES, FEEDBACK_SURFACE_DEFINITIONS, FEEDBACK_SURFACE_IDS, FEEDBACK_THEME_IDS, FEEDBACK_UNICODE_NORMALIZATION_PROFILE, FeedbackAcceptanceReceiptSchema, type FeedbackAnalysisReceipt, FeedbackAnalysisReceiptSchema, type FeedbackBugPacket, FeedbackBugPacketSchema, FeedbackBugSubmissionRequestSchema, type FeedbackBugTransientAnalysisRequest, FeedbackContextSchema, type FeedbackCountBucket, FeedbackDailySatisfactionReportSchema, type FeedbackDerivedAnalysis, FeedbackDerivedAnalysisSchema, FeedbackDraftPacketSchema, FeedbackDraftReceiptSchema, FeedbackDraftUpsertRequestSchema, type FeedbackEncryptedNarrativeEnvelope, FeedbackEncryptedNarrativeEnvelopeSchema, FeedbackGameDiagnostics, FeedbackGameReconstructionManifestSchema, FeedbackHourlyBugReportSchema, type FeedbackIntentId, type FeedbackIssueType, FeedbackMaterializationManifestSchema, type FeedbackPersistableIssueType, FeedbackProcessorCheckpointSchema, type FeedbackPublicComparison, type FeedbackPublicSummary, FeedbackPublicSummarySchema, type FeedbackPublicWeeklyPoint, type FeedbackReviewPacket, FeedbackReviewPacketSchema, FeedbackReviewSubmissionRequestSchema, type FeedbackReviewTransientAnalysisRequest, FeedbackRichTextAstSchema, type FeedbackRichTextBlock, type FeedbackRichTextDocument, type FeedbackRichTextMark, type FeedbackRichTextNode, type FeedbackSatisfaction, type FeedbackSentiment, type FeedbackSeverity, FeedbackStructuredOnlyAnalysisResultSchema, FeedbackSurfaceCatalogSchema, type FeedbackSurfaceId, type FeedbackThemeId, type FeedbackTransientAnalysisRequest, FeedbackTransientAnalysisRequestSchema, type FeedbackTransientAnalysisRequestValidationResult, FieldBuilder, FieldType, Infer, IsoLanguageCode, PLAYER_SYSTEM_ACHIEVEMENT_TIERS, PLAYER_SYSTEM_ACHIEVEMENT_TRACK_STATUSES, PLAYER_SYSTEM_EVENT_KINDS, type PlayerSystemAchievementEntry, type PlayerSystemAchievementTier, type PlayerSystemAchievementTrack, type PlayerSystemAchievementTrackStatus, type PlayerSystemCuratedSnapshot, type PlayerSystemCuratedSnapshotEntity, PlayerSystemCuratedSnapshotSchema, type PlayerSystemEventEntry, type PlayerSystemEventHighlight, type PlayerSystemEventKind, type PlayerSystemNormalizedEventBatch, type PlayerSystemNormalizedEventBatchEntity, PlayerSystemNormalizedEventBatchSchema, type PlayerSystemNormalizedObservedEvent, type PlayerSystemObservedEvent, type PlayerSystemObservedEventBatch, type PlayerSystemObservedEventBatchEntity, PlayerSystemObservedEventBatchSchema, Schema, SchemaOptions, SchemaShape, ValidationIssue, createComponentSchema, createSchema, field, getAllComponentSchemas, getAllSchemas, getComponentSchema, getSchemaForType, isExtensionSingleton, isExtensionSubtag, isIsoLanguageCode, isPrivateUseSingleton, isPrivateUseSubtag, isRegionSubtag, isScriptSubtag, isVariantSubtag, isoCountryCodes, isoCurrencyCodes, registerComponentSchema, renderSchemaDescription, validateCountryCode, validateCurrencyCode, validateDateTimeISO, validateDisplayName, validateEmail, validateFeedbackTransientAnalysisRequest, validateLanguage, validateName, validatePercentage, validatePhone, validateRichText, validateSafeText, validateSemVer, validateUUID, validateUrl, validateUserId, validateUserIdArray };