@spotpatch/shared 1.12.0 → 1.14.0

package/dist/annotation-Cz-NNgR4.d.cts

@@ -0,0 +1,102 @@
+interface ContextBudget {
+    readonly totalCharacters: number;
+    readonly domCharacters: number;
+    readonly cssCharacters: number;
+    readonly codeCharacters: number;
+    readonly maxCodeLines: number;
+    readonly maxComponentDepth: number;
+}
+interface CodeContext {
+    readonly relativePath: string;
+    readonly language: "tsx" | "jsx" | "astro";
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly excerpt: string;
+    readonly boundary: "component" | "nearby-lines";
+}
+
+type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
+type SourceOrigin = "jsx-host" | "astro-host" | "react-fiber" | "dom-ancestor" | "none";
+interface SourceRef {
+    readonly fileId?: string;
+    readonly relativePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly origin: SourceOrigin;
+    readonly confidence: SourceConfidence;
+}
+interface ReactContext {
+    readonly supported: boolean;
+    readonly version?: string;
+    readonly componentName?: string;
+    readonly componentSourceId?: string;
+    readonly sourceVersion?: string;
+    readonly componentStack: readonly string[];
+    readonly source?: SourceRef;
+}
+
+interface MatchedStyleRule {
+    readonly selector: string;
+    readonly declarations: string;
+    readonly source?: string;
+    readonly media?: string;
+}
+interface StyleContext {
+    readonly classNames: readonly string[];
+    readonly inlineStyle?: string;
+    readonly matchedRules: readonly MatchedStyleRule[];
+    readonly computed: Readonly<Record<string, string>>;
+    readonly warnings: readonly string[];
+}
+
+interface PageContext {
+    readonly url: string;
+    readonly pathname: string;
+    readonly title: string;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    readonly devicePixelRatio: number;
+}
+interface ElementContext {
+    readonly tagName: string;
+    readonly selector: string;
+    readonly sanitizedHtml: string;
+    readonly textPreview?: string;
+    readonly role?: string;
+    readonly rect: Readonly<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+/** Protocol hard limit. Runtime configuration may choose a smaller limit. */
+declare const MAX_ANNOTATION_TARGETS = 20;
+/** Each target owns its requested change; the UI enforces the same bound. */
+declare const MAX_TARGET_INSTRUCTION_CHARACTERS = 2000;
+/** Keeps the complete, atomic user intent within the prompt and request budgets. */
+declare const MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4000;
+declare const SPOTPATCH_LOCALES: readonly ["en-US", "zh-CN"];
+type SpotPatchLocale = (typeof SPOTPATCH_LOCALES)[number];
+declare const SPOTPATCH_LOCALE_PREFERENCES: readonly ["auto", "en-US", "zh-CN"];
+type SpotPatchLocalePreference = (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];
+interface SpotTargetContext {
+    readonly instruction: string;
+    readonly page?: Readonly<PageContext>;
+    readonly source: SourceRef;
+    readonly react: ReactContext;
+    readonly element: ElementContext;
+    readonly styles: StyleContext;
+    readonly code?: CodeContext;
+    readonly warnings: readonly string[];
+}
+interface SpotAnnotation {
+    readonly schemaVersion: 3;
+    readonly id: string;
+    readonly locale: SpotPatchLocale;
+    readonly page: Readonly<PageContext>;
+    readonly targets: readonly SpotTargetContext[];
+    readonly createdAt: string;
+}
+
+export { type ContextBudget as C, type ElementContext as E, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type PageContext as P, type ReactContext as R, type SpotAnnotation as S, type SpotPatchLocale as a, SPOTPATCH_LOCALE_PREFERENCES as b, type CodeContext as c, MAX_ANNOTATION_TARGETS as d, MAX_TARGET_INSTRUCTION_CHARACTERS as e, type MatchedStyleRule as f, SPOTPATCH_LOCALES as g, type SourceConfidence as h, type SourceOrigin as i, type SourceRef as j, type SpotPatchLocalePreference as k, type SpotTargetContext as l, type StyleContext as m };

package/dist/annotation-Cz-NNgR4.d.ts

@@ -0,0 +1,102 @@
+interface ContextBudget {
+    readonly totalCharacters: number;
+    readonly domCharacters: number;
+    readonly cssCharacters: number;
+    readonly codeCharacters: number;
+    readonly maxCodeLines: number;
+    readonly maxComponentDepth: number;
+}
+interface CodeContext {
+    readonly relativePath: string;
+    readonly language: "tsx" | "jsx" | "astro";
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly excerpt: string;
+    readonly boundary: "component" | "nearby-lines";
+}
+
+type SourceConfidence = "exact" | "probable" | "approximate" | "unknown";
+type SourceOrigin = "jsx-host" | "astro-host" | "react-fiber" | "dom-ancestor" | "none";
+interface SourceRef {
+    readonly fileId?: string;
+    readonly relativePath?: string;
+    readonly line?: number;
+    readonly column?: number;
+    readonly origin: SourceOrigin;
+    readonly confidence: SourceConfidence;
+}
+interface ReactContext {
+    readonly supported: boolean;
+    readonly version?: string;
+    readonly componentName?: string;
+    readonly componentSourceId?: string;
+    readonly sourceVersion?: string;
+    readonly componentStack: readonly string[];
+    readonly source?: SourceRef;
+}
+
+interface MatchedStyleRule {
+    readonly selector: string;
+    readonly declarations: string;
+    readonly source?: string;
+    readonly media?: string;
+}
+interface StyleContext {
+    readonly classNames: readonly string[];
+    readonly inlineStyle?: string;
+    readonly matchedRules: readonly MatchedStyleRule[];
+    readonly computed: Readonly<Record<string, string>>;
+    readonly warnings: readonly string[];
+}
+
+interface PageContext {
+    readonly url: string;
+    readonly pathname: string;
+    readonly title: string;
+    readonly viewportWidth: number;
+    readonly viewportHeight: number;
+    readonly devicePixelRatio: number;
+}
+interface ElementContext {
+    readonly tagName: string;
+    readonly selector: string;
+    readonly sanitizedHtml: string;
+    readonly textPreview?: string;
+    readonly role?: string;
+    readonly rect: Readonly<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+/** Protocol hard limit. Runtime configuration may choose a smaller limit. */
+declare const MAX_ANNOTATION_TARGETS = 20;
+/** Each target owns its requested change; the UI enforces the same bound. */
+declare const MAX_TARGET_INSTRUCTION_CHARACTERS = 2000;
+/** Keeps the complete, atomic user intent within the prompt and request budgets. */
+declare const MAX_ANNOTATION_INSTRUCTION_CHARACTERS = 4000;
+declare const SPOTPATCH_LOCALES: readonly ["en-US", "zh-CN"];
+type SpotPatchLocale = (typeof SPOTPATCH_LOCALES)[number];
+declare const SPOTPATCH_LOCALE_PREFERENCES: readonly ["auto", "en-US", "zh-CN"];
+type SpotPatchLocalePreference = (typeof SPOTPATCH_LOCALE_PREFERENCES)[number];
+interface SpotTargetContext {
+    readonly instruction: string;
+    readonly page?: Readonly<PageContext>;
+    readonly source: SourceRef;
+    readonly react: ReactContext;
+    readonly element: ElementContext;
+    readonly styles: StyleContext;
+    readonly code?: CodeContext;
+    readonly warnings: readonly string[];
+}
+interface SpotAnnotation {
+    readonly schemaVersion: 3;
+    readonly id: string;
+    readonly locale: SpotPatchLocale;
+    readonly page: Readonly<PageContext>;
+    readonly targets: readonly SpotTargetContext[];
+    readonly createdAt: string;
+}
+
+export { type ContextBudget as C, type ElementContext as E, MAX_ANNOTATION_INSTRUCTION_CHARACTERS as M, type PageContext as P, type ReactContext as R, type SpotAnnotation as S, type SpotPatchLocale as a, SPOTPATCH_LOCALE_PREFERENCES as b, type CodeContext as c, MAX_ANNOTATION_TARGETS as d, MAX_TARGET_INSTRUCTION_CHARACTERS as e, type MatchedStyleRule as f, SPOTPATCH_LOCALES as g, type SourceConfidence as h, type SourceOrigin as i, type SourceRef as j, type SpotPatchLocalePreference as k, type SpotTargetContext as l, type StyleContext as m };