@page-component-object/adapter-cypress 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Vega
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+import { UserAgent } from '@page-component-object/core';
+export { resetSharedUserAgent } from '@page-component-object/core';
+import { ComponentTestObject } from '@page-component-object/queries';
+
+type PCOChainable<T extends HTMLElement = HTMLElement> = Cypress.Chainable<JQuery<T>> & {
+    /** PCO semantic click — enqueues Cypress click on this chain. */
+    userClick(options?: Partial<Cypress.ClickOptions>): Cypress.Chainable<void>;
+    /** PCO semantic type — clear + type (matches `createCypressUserAgent` behavior). */
+    userType(text: string, options?: Partial<Cypress.TypeOptions>): Cypress.Chainable<void>;
+    /** Clear the field via Cypress native clear. */
+    userClear(): PCOChainable<T>;
+    /**
+     * PCO semantic select — select an option by its visible text (native `<select>` only).
+     *
+     * Uses the text of `<option>` elements to derive the option value, then calls Cypress `.select()`.
+     */
+    selectOptionByText(text: string | RegExp): Cypress.Chainable<void>;
+};
+/** Wrap a Cypress chain with PCO semantic methods. Native `.type()` / `.click()` / `.should()` unchanged. */
+declare function asPCOChainable<T extends HTMLElement>(chain: Cypress.Chainable<JQuery<T>>): PCOChainable<T>;
+
+/**
+ * Cypress-oriented test object base (Option B).
+ * Getters return `PCOChainable` for native Cypress chains plus PCO semantic methods.
+ * Use in E2E specs — not in Vitest/Jest/Storybook (those use `ComponentTestObject`).
+ *
+ * Queries use `@testing-library/cypress` (`cy.findBy*` / `cy.findAllBy*`) wherever possible.
+ * Register commands once: `import '@testing-library/cypress/add-commands'`.
+ */
+declare class CypressComponentTestObject extends ComponentTestObject {
+    /** Wrap a resolved element in a PCO-augmented Cypress chain. Prefer `findBy*` for new getters. */
+    protected chain<T extends HTMLElement = HTMLElement>(resolve: () => T): PCOChainable<T>;
+    /** Chainable for one element from a sync RTL list getter. Prefer `findAllBy*At` for new getters. */
+    protected chainAt(resolveAll: () => HTMLElement[], index: number): PCOChainable;
+    protected findByRole(...args: Parameters<typeof cy.findByRole>): PCOChainable;
+    protected findAllByRoleAt(role: Parameters<typeof cy.findAllByRole>[0], optionsOrIndex: Parameters<typeof cy.findAllByRole>[1] | number, index?: number): PCOChainable;
+    protected findByLabelText(...args: Parameters<typeof cy.findByLabelText>): PCOChainable;
+    protected findAllByLabelTextAt(text: Parameters<typeof cy.findAllByLabelText>[0], optionsOrIndex: Parameters<typeof cy.findAllByLabelText>[1] | number, index?: number): PCOChainable;
+    protected findByText(...args: Parameters<typeof cy.findByText>): PCOChainable;
+    protected findAllByTextAt(text: Parameters<typeof cy.findAllByText>[0], optionsOrIndex: Parameters<typeof cy.findAllByText>[1] | number, index?: number): PCOChainable;
+    protected findByTestId(...args: Parameters<typeof cy.findByTestId>): PCOChainable;
+    protected findAllByTestIdAt(id: Parameters<typeof cy.findAllByTestId>[0], optionsOrIndex: Parameters<typeof cy.findAllByTestId>[1] | number, index?: number): PCOChainable;
+    protected findByPlaceholderText(...args: Parameters<typeof cy.findByPlaceholderText>): PCOChainable;
+    protected findAllByPlaceholderTextAt(text: Parameters<typeof cy.findAllByPlaceholderText>[0], optionsOrIndex: Parameters<typeof cy.findAllByPlaceholderText>[1] | number, index?: number): PCOChainable;
+    protected findByDisplayValue(...args: Parameters<typeof cy.findByDisplayValue>): PCOChainable;
+    protected findAllByDisplayValueAt(text: Parameters<typeof cy.findAllByDisplayValue>[0], optionsOrIndex: Parameters<typeof cy.findAllByDisplayValue>[1] | number, index?: number): PCOChainable;
+    protected findByAltText(...args: Parameters<typeof cy.findByAltText>): PCOChainable;
+    protected findAllByAltTextAt(text: Parameters<typeof cy.findAllByAltText>[0], optionsOrIndex: Parameters<typeof cy.findAllByAltText>[1] | number, index?: number): PCOChainable;
+    protected findByTitle(...args: Parameters<typeof cy.findByTitle>): PCOChainable;
+    protected findAllByTitleAt(text: Parameters<typeof cy.findAllByTitle>[0], optionsOrIndex: Parameters<typeof cy.findAllByTitle>[1] | number, index?: number): PCOChainable;
+}
+
+declare function runCypressCommand(command: () => Cypress.Chainable): Promise<void>;
+
+declare function createCypressUserAgent(): UserAgent;
+interface SetupPCOCypressOptions {
+    resetUserAgentEachTest?: boolean;
+}
+/**
+ * Configure PCO runtime for Cypress E2E/component tests.
+ * Call once from `cypress/support/e2e.ts`.
+ */
+declare function setupPCOCypress(options?: SetupPCOCypressOptions): void;
+
+export { CypressComponentTestObject, type PCOChainable, type SetupPCOCypressOptions, asPCOChainable, createCypressUserAgent, runCypressCommand, setupPCOCypress };

package/dist/index.js

@@ -0,0 +1,177 @@
+// src/index.ts
+import { configureRuntime, resetSharedUserAgent } from "@page-component-object/core";
+
+// src/cypressCommand.ts
+function runCypressCommand(command) {
+  return new Cypress.Promise((resolve) => {
+    command().then(() => {
+      resolve();
+    });
+  });
+}
+
+// src/CypressComponentTestObject.ts
+import { ComponentTestObject } from "@page-component-object/queries";
+
+// src/cypressTestingLibrary.ts
+import "@testing-library/cypress";
+
+// src/pcoChainable.ts
+function asPCOChainable(chain) {
+  const pco = chain;
+  pco.userClick = (options) => chain.click(options);
+  pco.userType = (text, options) => chain.clear().type(text, options);
+  pco.userClear = () => chain.clear();
+  pco.selectOptionByText = (text) => chain.then(($select) => {
+    const options = $select.find("option").toArray();
+    const matched = options.find((opt) => {
+      const label = (opt.textContent ?? "").trim();
+      if (typeof text === "string") return label === text;
+      return text.test(label);
+    });
+    if (!matched) {
+      throw new Error(`selectOptionByText: no <option> matched "${text}"`);
+    }
+    const value = matched.value;
+    return cy.wrap($select).select(value);
+  });
+  return pco;
+}
+
+// src/cypressTestingLibrary.ts
+function cyFindBy(command, ...args) {
+  const run = cy[command];
+  return asPCOChainable(run(...args));
+}
+function cyFindAllByAt(command, index, ...args) {
+  const run = cy[command];
+  const list = args.length > 0 ? run(...args) : run();
+  return asPCOChainable(list.eq(index));
+}
+
+// src/CypressComponentTestObject.ts
+var CypressComponentTestObject = class extends ComponentTestObject {
+  /** Wrap a resolved element in a PCO-augmented Cypress chain. Prefer `findBy*` for new getters. */
+  chain(resolve) {
+    return asPCOChainable(cy.wrap(resolve()));
+  }
+  /** Chainable for one element from a sync RTL list getter. Prefer `findAllBy*At` for new getters. */
+  chainAt(resolveAll, index) {
+    return asPCOChainable(cy.wrap(resolveAll()[index]));
+  }
+  findByRole(...args) {
+    return cyFindBy("findByRole", ...args);
+  }
+  findAllByRoleAt(role, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByRole", optionsOrIndex, role);
+    }
+    return cyFindAllByAt("findAllByRole", index ?? 0, role, optionsOrIndex);
+  }
+  findByLabelText(...args) {
+    return cyFindBy("findByLabelText", ...args);
+  }
+  findAllByLabelTextAt(text, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByLabelText", optionsOrIndex, text);
+    }
+    return cyFindAllByAt("findAllByLabelText", index ?? 0, text, optionsOrIndex);
+  }
+  findByText(...args) {
+    return cyFindBy("findByText", ...args);
+  }
+  findAllByTextAt(text, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByText", optionsOrIndex, text);
+    }
+    return cyFindAllByAt("findAllByText", index ?? 0, text, optionsOrIndex);
+  }
+  findByTestId(...args) {
+    return cyFindBy("findByTestId", ...args);
+  }
+  findAllByTestIdAt(id, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByTestId", optionsOrIndex, id);
+    }
+    return cyFindAllByAt("findAllByTestId", index ?? 0, id, optionsOrIndex);
+  }
+  findByPlaceholderText(...args) {
+    return cyFindBy("findByPlaceholderText", ...args);
+  }
+  findAllByPlaceholderTextAt(text, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByPlaceholderText", optionsOrIndex, text);
+    }
+    return cyFindAllByAt("findAllByPlaceholderText", index ?? 0, text, optionsOrIndex);
+  }
+  findByDisplayValue(...args) {
+    return cyFindBy("findByDisplayValue", ...args);
+  }
+  findAllByDisplayValueAt(text, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByDisplayValue", optionsOrIndex, text);
+    }
+    return cyFindAllByAt(
+      "findAllByDisplayValue",
+      index ?? 0,
+      text,
+      optionsOrIndex
+    );
+  }
+  findByAltText(...args) {
+    return cyFindBy("findByAltText", ...args);
+  }
+  findAllByAltTextAt(text, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByAltText", optionsOrIndex, text);
+    }
+    return cyFindAllByAt("findAllByAltText", index ?? 0, text, optionsOrIndex);
+  }
+  findByTitle(...args) {
+    return cyFindBy("findByTitle", ...args);
+  }
+  findAllByTitleAt(text, optionsOrIndex, index) {
+    if (typeof optionsOrIndex === "number") {
+      return cyFindAllByAt("findAllByTitle", optionsOrIndex, text);
+    }
+    return cyFindAllByAt("findAllByTitle", index ?? 0, text, optionsOrIndex);
+  }
+};
+
+// src/index.ts
+function createCypressUserAgent() {
+  return {
+    click: (target, options) => runCypressCommand(() => cy.wrap(target).click(options)),
+    dblClick: (target, options) => runCypressCommand(() => cy.wrap(target).dblclick(options)),
+    hover: (target, options) => runCypressCommand(() => cy.wrap(target).trigger("mouseover", options)),
+    type: (target, text, options) => runCypressCommand(() => cy.wrap(target).clear().type(text, options)),
+    keyboard: (text, options) => runCypressCommand(() => cy.focused().type(text, options)),
+    tab: () => runCypressCommand(() => cy.focused().trigger("keydown", { key: "Tab", keyCode: 9 })),
+    upload: (target, files) => runCypressCommand(() => cy.wrap(target).selectFile(files, { force: true }))
+  };
+}
+function setupPCOCypress(options = {}) {
+  configureRuntime({
+    spyFactory: {
+      fn: (impl) => {
+        const stub = cy.stub().callsFake(impl);
+        return stub;
+      }
+    },
+    createUserAgent: createCypressUserAgent
+  });
+  if (options.resetUserAgentEachTest !== false) {
+    beforeEach(() => {
+      resetSharedUserAgent();
+    });
+  }
+}
+export {
+  CypressComponentTestObject,
+  asPCOChainable,
+  createCypressUserAgent,
+  resetSharedUserAgent,
+  runCypressCommand,
+  setupPCOCypress
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cypressCommand.ts","../src/CypressComponentTestObject.ts","../src/cypressTestingLibrary.ts","../src/pcoChainable.ts"],"sourcesContent":["import { configureRuntime, resetSharedUserAgent, type UserAgent } from '@page-component-object/core';\r\n\r\nimport { runCypressCommand } from './cypressCommand';\r\n\r\nexport { CypressComponentTestObject } from './CypressComponentTestObject';\r\nexport { asPCOChainable, type PCOChainable } from './pcoChainable';\r\nexport { runCypressCommand } from './cypressCommand';\r\n\r\nexport function createCypressUserAgent(): UserAgent {\r\n  return {\r\n    click: (target, options) => runCypressCommand(() => cy.wrap(target).click(options)),\r\n    dblClick: (target, options) => runCypressCommand(() => cy.wrap(target).dblclick(options)),\r\n    hover: (target, options) =>\r\n      runCypressCommand(() => cy.wrap(target).trigger('mouseover', options)),\r\n    type: (target, text, options) =>\r\n      runCypressCommand(() => cy.wrap(target).clear().type(text, options)),\r\n    keyboard: (text, options) => runCypressCommand(() => cy.focused().type(text, options)),\r\n    tab: () =>\r\n      runCypressCommand(() => cy.focused().trigger('keydown', { key: 'Tab', keyCode: 9 })),\r\n    upload: (target, files) =>\r\n      runCypressCommand(() => cy.wrap(target).selectFile(files as never, { force: true })),\r\n  };\r\n}\r\n\r\nexport interface SetupPCOCypressOptions {\r\n  resetUserAgentEachTest?: boolean;\r\n}\r\n\r\n/**\r\n * Configure PCO runtime for Cypress E2E/component tests.\r\n * Call once from `cypress/support/e2e.ts`.\r\n */\r\nexport function setupPCOCypress(options: SetupPCOCypressOptions = {}): void {\r\n  configureRuntime({\r\n    spyFactory: {\r\n      fn: (impl) => {\r\n        const stub = cy.stub().callsFake(impl as never);\r\n        return stub as never;\r\n      },\r\n    },\r\n    createUserAgent: createCypressUserAgent,\r\n  });\r\n\r\n  if (options.resetUserAgentEachTest !== false) {\r\n    beforeEach(() => {\r\n      resetSharedUserAgent();\r\n    });\r\n  }\r\n}\r\n\r\nexport { resetSharedUserAgent };\r\n","export function runCypressCommand(command: () => Cypress.Chainable): Promise<void> {\r\n  return new Cypress.Promise<void>((resolve) => {\r\n    command().then(() => {\r\n      resolve();\r\n    });\r\n  });\r\n}\r\n","import { ComponentTestObject } from '@page-component-object/queries';\r\n\r\nimport { cyFindAllByAt, cyFindBy } from './cypressTestingLibrary';\r\nimport { asPCOChainable, type PCOChainable } from './pcoChainable';\r\n\r\n/**\r\n * Cypress-oriented test object base (Option B).\r\n * Getters return `PCOChainable` for native Cypress chains plus PCO semantic methods.\r\n * Use in E2E specs — not in Vitest/Jest/Storybook (those use `ComponentTestObject`).\r\n *\r\n * Queries use `@testing-library/cypress` (`cy.findBy*` / `cy.findAllBy*`) wherever possible.\r\n * Register commands once: `import '@testing-library/cypress/add-commands'`.\r\n */\r\nexport class CypressComponentTestObject extends ComponentTestObject {\r\n  /** Wrap a resolved element in a PCO-augmented Cypress chain. Prefer `findBy*` for new getters. */\r\n  protected chain<T extends HTMLElement = HTMLElement>(resolve: () => T): PCOChainable<T> {\r\n    return asPCOChainable(cy.wrap(resolve()));\r\n  }\r\n\r\n  /** Chainable for one element from a sync RTL list getter. Prefer `findAllBy*At` for new getters. */\r\n  protected chainAt(resolveAll: () => HTMLElement[], index: number): PCOChainable {\r\n    return asPCOChainable(cy.wrap(resolveAll()[index]));\r\n  }\r\n\r\n  protected findByRole(...args: Parameters<typeof cy.findByRole>): PCOChainable {\r\n    return cyFindBy('findByRole', ...args);\r\n  }\r\n\r\n  protected findAllByRoleAt(\r\n    role: Parameters<typeof cy.findAllByRole>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByRole>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByRole', optionsOrIndex, role);\r\n    }\r\n    return cyFindAllByAt('findAllByRole', index ?? 0, role, optionsOrIndex);\r\n  }\r\n\r\n  protected findByLabelText(...args: Parameters<typeof cy.findByLabelText>): PCOChainable {\r\n    return cyFindBy('findByLabelText', ...args);\r\n  }\r\n\r\n  protected findAllByLabelTextAt(\r\n    text: Parameters<typeof cy.findAllByLabelText>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByLabelText>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByLabelText', optionsOrIndex, text);\r\n    }\r\n    return cyFindAllByAt('findAllByLabelText', index ?? 0, text, optionsOrIndex);\r\n  }\r\n\r\n  protected findByText(...args: Parameters<typeof cy.findByText>): PCOChainable {\r\n    return cyFindBy('findByText', ...args);\r\n  }\r\n\r\n  protected findAllByTextAt(\r\n    text: Parameters<typeof cy.findAllByText>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByText>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByText', optionsOrIndex, text);\r\n    }\r\n    return cyFindAllByAt('findAllByText', index ?? 0, text, optionsOrIndex);\r\n  }\r\n\r\n  protected findByTestId(...args: Parameters<typeof cy.findByTestId>): PCOChainable {\r\n    return cyFindBy('findByTestId', ...args);\r\n  }\r\n\r\n  protected findAllByTestIdAt(\r\n    id: Parameters<typeof cy.findAllByTestId>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByTestId>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByTestId', optionsOrIndex, id);\r\n    }\r\n    return cyFindAllByAt('findAllByTestId', index ?? 0, id, optionsOrIndex);\r\n  }\r\n\r\n  protected findByPlaceholderText(\r\n    ...args: Parameters<typeof cy.findByPlaceholderText>\r\n  ): PCOChainable {\r\n    return cyFindBy('findByPlaceholderText', ...args);\r\n  }\r\n\r\n  protected findAllByPlaceholderTextAt(\r\n    text: Parameters<typeof cy.findAllByPlaceholderText>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByPlaceholderText>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByPlaceholderText', optionsOrIndex, text);\r\n    }\r\n    return cyFindAllByAt('findAllByPlaceholderText', index ?? 0, text, optionsOrIndex);\r\n  }\r\n\r\n  protected findByDisplayValue(\r\n    ...args: Parameters<typeof cy.findByDisplayValue>\r\n  ): PCOChainable {\r\n    return cyFindBy('findByDisplayValue', ...args);\r\n  }\r\n\r\n  protected findAllByDisplayValueAt(\r\n    text: Parameters<typeof cy.findAllByDisplayValue>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByDisplayValue>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByDisplayValue', optionsOrIndex, text);\r\n    }\r\n    return cyFindAllByAt(\r\n      'findAllByDisplayValue',\r\n      index ?? 0,\r\n      text,\r\n      optionsOrIndex,\r\n    );\r\n  }\r\n\r\n  protected findByAltText(\r\n    ...args: Parameters<typeof cy.findByAltText>\r\n  ): PCOChainable {\r\n    return cyFindBy('findByAltText', ...args);\r\n  }\r\n\r\n  protected findAllByAltTextAt(\r\n    text: Parameters<typeof cy.findAllByAltText>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByAltText>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByAltText', optionsOrIndex, text);\r\n    }\r\n    return cyFindAllByAt('findAllByAltText', index ?? 0, text, optionsOrIndex);\r\n  }\r\n\r\n  protected findByTitle(\r\n    ...args: Parameters<typeof cy.findByTitle>\r\n  ): PCOChainable {\r\n    return cyFindBy('findByTitle', ...args);\r\n  }\r\n\r\n  protected findAllByTitleAt(\r\n    text: Parameters<typeof cy.findAllByTitle>[0],\r\n    optionsOrIndex: Parameters<typeof cy.findAllByTitle>[1] | number,\r\n    index?: number,\r\n  ): PCOChainable {\r\n    if (typeof optionsOrIndex === 'number') {\r\n      return cyFindAllByAt('findAllByTitle', optionsOrIndex, text);\r\n    }\r\n    return cyFindAllByAt('findAllByTitle', index ?? 0, text, optionsOrIndex);\r\n  }\r\n}\r\n","import '@testing-library/cypress';\r\n\r\nimport { asPCOChainable, type PCOChainable } from './pcoChainable';\r\n\r\ntype FindByCommand =\r\n  | 'findByRole'\r\n  | 'findByLabelText'\r\n  | 'findByText'\r\n  | 'findByTestId'\r\n  | 'findByPlaceholderText'\r\n  | 'findByDisplayValue'\r\n  | 'findByAltText'\r\n  | 'findByTitle';\r\n\r\ntype FindAllByCommand =\r\n  | 'findAllByRole'\r\n  | 'findAllByLabelText'\r\n  | 'findAllByText'\r\n  | 'findAllByTestId'\r\n  | 'findAllByPlaceholderText'\r\n  | 'findAllByDisplayValue'\r\n  | 'findAllByAltText'\r\n  | 'findAllByTitle';\r\n\r\n/** Wrap a `cy.findBy*` command as a PCO chainable. */\r\nexport function cyFindBy(command: FindByCommand, ...args: unknown[]): PCOChainable {\r\n  const run = (cy as Record<FindByCommand, (...a: unknown[]) => Cypress.Chainable<JQuery<HTMLElement>>>)[\r\n    command\r\n  ];\r\n  return asPCOChainable(run(...args));\r\n}\r\n\r\n/** Wrap `cy.findAllBy*(…).eq(index)` as a PCO chainable. */\r\nexport function cyFindAllByAt(\r\n  command: FindAllByCommand,\r\n  index: number,\r\n  ...args: unknown[]\r\n): PCOChainable {\r\n  const run = (cy as Record<\r\n    FindAllByCommand,\r\n    (...a: unknown[]) => Cypress.Chainable<JQuery<HTMLElement>>\r\n  >)[command];\r\n  const list = args.length > 0 ? run(...args) : run();\r\n  return asPCOChainable(list.eq(index));\r\n}\r\n","export type PCOChainable<T extends HTMLElement = HTMLElement> = Cypress.Chainable<JQuery<T>> & {\r\n  /** PCO semantic click — enqueues Cypress click on this chain. */\r\n  userClick(options?: Partial<Cypress.ClickOptions>): Cypress.Chainable<void>;\r\n  /** PCO semantic type — clear + type (matches `createCypressUserAgent` behavior). */\r\n  userType(text: string, options?: Partial<Cypress.TypeOptions>): Cypress.Chainable<void>;\r\n  /** Clear the field via Cypress native clear. */\r\n  userClear(): PCOChainable<T>;\r\n  /**\r\n   * PCO semantic select — select an option by its visible text (native `<select>` only).\r\n   *\r\n   * Uses the text of `<option>` elements to derive the option value, then calls Cypress `.select()`.\r\n   */\r\n  selectOptionByText(text: string | RegExp): Cypress.Chainable<void>;\r\n};\r\n\r\n/** Wrap a Cypress chain with PCO semantic methods. Native `.type()` / `.click()` / `.should()` unchanged. */\r\nexport function asPCOChainable<T extends HTMLElement>(\r\n  chain: Cypress.Chainable<JQuery<T>>,\r\n): PCOChainable<T> {\r\n  const pco = chain as PCOChainable<T>;\r\n\r\n  pco.userClick = (options?: Partial<Cypress.ClickOptions>) =>\r\n    chain.click(options) as unknown as Cypress.Chainable<void>;\r\n\r\n  pco.userType = (text: string, options?: Partial<Cypress.TypeOptions>) =>\r\n    chain.clear().type(text, options) as unknown as Cypress.Chainable<void>;\r\n\r\n  pco.userClear = () => chain.clear() as PCOChainable<T>;\r\n\r\n  pco.selectOptionByText = (text: string | RegExp) =>\r\n    chain.then(($select) => {\r\n      const options = $select.find('option').toArray();\r\n      const matched = options.find((opt) => {\r\n        const label = (opt.textContent ?? '').trim();\r\n        if (typeof text === 'string') return label === text;\r\n        return text.test(label);\r\n      });\r\n\r\n      if (!matched) {\r\n        throw new Error(`selectOptionByText: no <option> matched \"${text}\"`);\r\n      }\r\n\r\n      const value = (matched as unknown as HTMLOptionElement).value;\r\n      return cy.wrap($select as unknown as JQuery<HTMLElement>).select(value as never);\r\n    }) as unknown as Cypress.Chainable<void>;\r\n\r\n  return pco;\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@page-component-object/adapter-cypress",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@page-component-object/core": "0.1.0",
+    "@page-component-object/queries": "0.1.0"
+  },
+  "peerDependencies": {
+    "@testing-library/cypress": "^10.0.0",
+    "cypress": "^13.0.0 || ^14.0.0 || ^15.0.0"
+  },
+  "devDependencies": {
+    "cypress": "^14.0.0",
+    "@testing-library/cypress": "^10.0.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dvegap95/page-component-test-object.git",
+    "directory": "packages/adapters/cypress"
+  },
+  "homepage": "https://github.com/dvegap95/page-component-test-object#readme",
+  "bugs": {
+    "url": "https://github.com/dvegap95/page-component-test-object/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}