@ticktockbent/charlotte 0.1.0

package/dist/types/element-id.js

@@ -0,0 +1,19 @@
+export const TYPE_PREFIX_MAP = {
+    button: "btn",
+    text_input: "inp",
+    link: "lnk",
+    select: "sel",
+    checkbox: "chk",
+    radio: "rad",
+    toggle: "tog",
+    textarea: "inp",
+    file_input: "inp",
+    range: "inp",
+    date_input: "inp",
+    color_input: "inp",
+    static_text: "txt",
+    form: "frm",
+    region: "rgn",
+    heading: "hdg",
+};
+//# sourceMappingURL=element-id.js.map

package/dist/types/element-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"element-id.js","sourceRoot":"","sources":["../../src/types/element-id.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,MAAM,EAAE,KAAK;IACb,UAAU,EAAE,KAAK;IACjB,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,KAAK;IACjB,WAAW,EAAE,KAAK;IAClB,WAAW,EAAE,KAAK;IAClB,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,KAAK;CACf,CAAC"}

package/dist/types/errors.d.ts

@@ -0,0 +1,22 @@
+export declare enum CharlotteErrorCode {
+    ELEMENT_NOT_FOUND = "ELEMENT_NOT_FOUND",
+    ELEMENT_NOT_INTERACTIVE = "ELEMENT_NOT_INTERACTIVE",
+    NAVIGATION_FAILED = "NAVIGATION_FAILED",
+    TIMEOUT = "TIMEOUT",
+    EVALUATION_ERROR = "EVALUATION_ERROR",
+    SESSION_ERROR = "SESSION_ERROR",
+    SNAPSHOT_EXPIRED = "SNAPSHOT_EXPIRED"
+}
+export declare class CharlotteError extends Error {
+    readonly code: CharlotteErrorCode;
+    readonly suggestion?: string | undefined;
+    constructor(code: CharlotteErrorCode, message: string, suggestion?: string | undefined);
+    toResponse(): {
+        error: {
+            code: string;
+            message: string;
+            suggestion?: string;
+        };
+    };
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/types/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,oBAAY,kBAAkB;IAC5B,iBAAiB,sBAAsB;IACvC,uBAAuB,4BAA4B;IACnD,iBAAiB,sBAAsB;IACvC,OAAO,YAAY;IACnB,gBAAgB,qBAAqB;IACrC,aAAa,kBAAkB;IAC/B,gBAAgB,qBAAqB;CACtC;AAED,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAAE,kBAAkB;aAExB,UAAU,CAAC,EAAE,MAAM;gBAFnB,IAAI,EAAE,kBAAkB,EACxC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;IAMrC,UAAU,IAAI;QACZ,KAAK,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/D;CASF"}

package/dist/types/errors.js

@@ -0,0 +1,30 @@
+export var CharlotteErrorCode;
+(function (CharlotteErrorCode) {
+    CharlotteErrorCode["ELEMENT_NOT_FOUND"] = "ELEMENT_NOT_FOUND";
+    CharlotteErrorCode["ELEMENT_NOT_INTERACTIVE"] = "ELEMENT_NOT_INTERACTIVE";
+    CharlotteErrorCode["NAVIGATION_FAILED"] = "NAVIGATION_FAILED";
+    CharlotteErrorCode["TIMEOUT"] = "TIMEOUT";
+    CharlotteErrorCode["EVALUATION_ERROR"] = "EVALUATION_ERROR";
+    CharlotteErrorCode["SESSION_ERROR"] = "SESSION_ERROR";
+    CharlotteErrorCode["SNAPSHOT_EXPIRED"] = "SNAPSHOT_EXPIRED";
+})(CharlotteErrorCode || (CharlotteErrorCode = {}));
+export class CharlotteError extends Error {
+    code;
+    suggestion;
+    constructor(code, message, suggestion) {
+        super(message);
+        this.code = code;
+        this.suggestion = suggestion;
+        this.name = "CharlotteError";
+    }
+    toResponse() {
+        return {
+            error: {
+                code: this.code,
+                message: this.message,
+                ...(this.suggestion ? { suggestion: this.suggestion } : {}),
+            },
+        };
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/types/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/types/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,kBAQX;AARD,WAAY,kBAAkB;IAC5B,6DAAuC,CAAA;IACvC,yEAAmD,CAAA;IACnD,6DAAuC,CAAA;IACvC,yCAAmB,CAAA;IACnB,2DAAqC,CAAA;IACrC,qDAA+B,CAAA;IAC/B,2DAAqC,CAAA;AACvC,CAAC,EARW,kBAAkB,KAAlB,kBAAkB,QAQ7B;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IAErB;IAEA;IAHlB,YACkB,IAAwB,EACxC,OAAe,EACC,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAoB;QAExB,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;IAED,UAAU;QAGR,OAAO;YACL,KAAK,EAAE;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/types/page-representation.d.ts

@@ -0,0 +1,84 @@
+export interface Bounds {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface Landmark {
+    role: string;
+    label: string;
+    bounds: Bounds;
+}
+export interface Heading {
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    text: string;
+    id: string;
+}
+export interface ElementState {
+    enabled?: boolean;
+    visible?: boolean;
+    focused?: boolean;
+    checked?: boolean;
+    expanded?: boolean;
+    selected?: boolean;
+    required?: boolean;
+    invalid?: boolean;
+}
+export type InteractiveElementType = "button" | "link" | "text_input" | "select" | "checkbox" | "radio" | "toggle" | "textarea" | "file_input" | "range" | "date_input" | "color_input";
+export interface InteractiveElement {
+    id: string;
+    type: InteractiveElementType;
+    label: string;
+    bounds: Bounds | null;
+    state: ElementState;
+    href?: string;
+    placeholder?: string;
+    value?: string;
+    options?: string[];
+}
+export interface FormRepresentation {
+    id: string;
+    action?: string;
+    method?: string;
+    fields: string[];
+    submit: string | null;
+}
+export interface PageStructure {
+    landmarks: Landmark[];
+    headings: Heading[];
+    content_summary: string;
+    full_content?: string;
+}
+export interface ReloadEvent {
+    trigger: "file_change";
+    files_changed: string[];
+    timestamp: string;
+}
+export interface PageRepresentation {
+    url: string;
+    title: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    snapshot_id: number;
+    timestamp: string;
+    structure: PageStructure;
+    interactive: InteractiveElement[];
+    forms: FormRepresentation[];
+    alerts: string[];
+    errors: {
+        console: Array<{
+            level: string;
+            text: string;
+        }>;
+        network: Array<{
+            url: string;
+            status: number;
+            statusText: string;
+        }>;
+    };
+    reload_event?: ReloadEvent;
+    delta?: import("./snapshot.js").SnapshotDiff;
+}
+//# sourceMappingURL=page-representation.d.ts.map

package/dist/types/page-representation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-representation.d.ts","sourceRoot":"","sources":["../../src/types/page-representation.ts"],"names":[],"mappings":"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"}

package/dist/types/page-representation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page-representation.js.map

package/dist/types/page-representation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-representation.js","sourceRoot":"","sources":["../../src/types/page-representation.ts"],"names":[],"mappings":""}

package/dist/types/snapshot.d.ts

@@ -0,0 +1,22 @@
+import type { PageRepresentation } from "./page-representation.js";
+export interface Snapshot {
+    id: number;
+    timestamp: string;
+    representation: PageRepresentation;
+}
+export type DiffChangeType = "added" | "removed" | "moved" | "changed";
+export interface DiffChange {
+    type: DiffChangeType;
+    element?: string;
+    detail?: string;
+    property?: string;
+    from?: unknown;
+    to?: unknown;
+}
+export interface SnapshotDiff {
+    from_snapshot: number;
+    to_snapshot: number;
+    changes: DiffChange[];
+    summary: string;
+}
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/types/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/types/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,kBAAkB,CAAC;CACpC;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types/snapshot.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshot.js.map

package/dist/types/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../../src/types/snapshot.ts"],"names":[],"mappings":""}

package/dist/utils/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function hashToHex4(input: string): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhD"}

package/dist/utils/hash.js

@@ -0,0 +1,6 @@
+import { createHash } from "node:crypto";
+export function hashToHex4(input) {
+    const hash = createHash("md5").update(input).digest("hex");
+    return hash.substring(0, 4);
+}
+//# sourceMappingURL=hash.js.map

package/dist/utils/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC9B,CAAC"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,9 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export declare function setLogLevel(level: LogLevel): void;
+export declare const logger: {
+    debug: (message: string, data?: unknown) => void;
+    info: (message: string, data?: unknown) => void;
+    warn: (message: string, data?: unknown) => void;
+    error: (message: string, data?: unknown) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAW3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAEjD;AAmBD,eAAO,MAAM,MAAM;qBACA,MAAM,SAAS,OAAO;oBACvB,MAAM,SAAS,OAAO;oBACtB,MAAM,SAAS,OAAO;qBACrB,MAAM,SAAS,OAAO;CACxC,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,31 @@
+const LOG_LEVEL_PRIORITY = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+let currentLevel = "info";
+export function setLogLevel(level) {
+    currentLevel = level;
+}
+function shouldLog(level) {
+    return LOG_LEVEL_PRIORITY[level] >= LOG_LEVEL_PRIORITY[currentLevel];
+}
+function writeLog(level, message, data) {
+    if (!shouldLog(level))
+        return;
+    const entry = {
+        timestamp: new Date().toISOString(),
+        level,
+        message,
+        ...(data !== undefined ? { data } : {}),
+    };
+    process.stderr.write(JSON.stringify(entry) + "\n");
+}
+export const logger = {
+    debug: (message, data) => writeLog("debug", message, data),
+    info: (message, data) => writeLog("info", message, data),
+    warn: (message, data) => writeLog("warn", message, data),
+    error: (message, data) => writeLog("error", message, data),
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA,MAAM,kBAAkB,GAA6B;IACnD,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,IAAI,YAAY,GAAa,MAAM,CAAC;AAEpC,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,kBAAkB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,QAAQ,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;IAChE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO;IAE9B,MAAM,KAAK,GAAG;QACZ,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,KAAK;QACL,OAAO;QACP,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC;IAEF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;IAC5E,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;IAC1E,IAAI,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC;IAC1E,KAAK,EAAE,CAAC,OAAe,EAAE,IAAc,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC;CAC7E,CAAC"}

package/dist/utils/wait.d.ts

@@ -0,0 +1,21 @@
+import type { Page } from "puppeteer";
+export interface WaitCondition {
+    /** Wait for a CSS selector to match */
+    selector?: string;
+    /** Wait for JS expression to return truthy */
+    js?: string;
+    /** Wait for text to appear in the page */
+    text?: string;
+}
+export interface WaitOptions {
+    /** Max wait time in milliseconds */
+    timeout: number;
+    /** Polling interval in milliseconds */
+    pollInterval?: number;
+}
+/**
+ * Poll a page until a condition is met or timeout is reached.
+ * Returns true if the condition was satisfied, false if timed out.
+ */
+export declare function pollUntilCondition(page: Page, condition: WaitCondition, options: WaitOptions): Promise<boolean>;
+//# sourceMappingURL=wait.d.ts.map

package/dist/utils/wait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,0CAA0C;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAelB"}

package/dist/utils/wait.js

@@ -0,0 +1,55 @@
+const DEFAULT_POLL_INTERVAL_MS = 100;
+/**
+ * Poll a page until a condition is met or timeout is reached.
+ * Returns true if the condition was satisfied, false if timed out.
+ */
+export async function pollUntilCondition(page, condition, options) {
+    const pollInterval = options.pollInterval ?? DEFAULT_POLL_INTERVAL_MS;
+    const deadline = Date.now() + options.timeout;
+    while (Date.now() < deadline) {
+        const satisfied = await evaluateCondition(page, condition);
+        if (satisfied)
+            return true;
+        const remainingTime = deadline - Date.now();
+        if (remainingTime <= 0)
+            break;
+        await sleep(Math.min(pollInterval, remainingTime));
+    }
+    return false;
+}
+/**
+ * Evaluate a single WaitCondition against the current page state.
+ */
+async function evaluateCondition(page, condition) {
+    if (condition.selector) {
+        const element = await page.$(condition.selector);
+        if (!element)
+            return false;
+    }
+    if (condition.text) {
+        const textToFind = condition.text;
+        const found = await page.evaluate((searchText) => {
+            return document.body?.innerText?.includes(searchText) ?? false;
+        }, textToFind);
+        if (!found)
+            return false;
+    }
+    if (condition.js) {
+        const jsExpression = condition.js;
+        try {
+            const result = await page.evaluate((expression) => {
+                return !!eval(expression);
+            }, jsExpression);
+            if (!result)
+                return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    return true;
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=wait.js.map

package/dist/utils/wait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait.js","sourceRoot":"","sources":["../../src/utils/wait.ts"],"names":[],"mappings":"AAkBA,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,IAAU,EACV,SAAwB,EACxB,OAAoB;IAEpB,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,wBAAwB,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAE9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,SAAS;YAAE,OAAO,IAAI,CAAC;QAE3B,MAAM,aAAa,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5C,IAAI,aAAa,IAAI,CAAC;YAAE,MAAM;QAE9B,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,iBAAiB,CAC9B,IAAU,EACV,SAAwB;IAExB,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE;YAC/C,OAAO,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC;QACjE,CAAC,EAAE,UAAU,CAAC,CAAC;QACf,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,YAAY,GAAG,SAAS,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,EAAE;gBAChD,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5B,CAAC,EAAE,YAAY,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@ticktockbent/charlotte",
+  "version": "0.1.0",
+  "description": "MCP server that renders web pages into structured, agent-readable representations",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "charlotte": "dist/index.js"
+  },
+  "license": "MIT",
+  "author": "ticktockbent",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ticktockbent/charlotte.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ticktockbent/charlotte/issues"
+  },
+  "homepage": "https://github.com/ticktockbent/charlotte#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "web",
+    "accessibility",
+    "headless-browser",
+    "puppeteer",
+    "ai-agent",
+    "web-scraping",
+    "browser-automation"
+  ],
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc -p tsconfig.build.json",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:unit": "vitest run tests/unit/",
+    "test:integration": "vitest run tests/integration/"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "chokidar": "^4.0.0",
+    "express": "^4.21.0",
+    "puppeteer": "^24.0.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.0",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}