cypress-ct-octane-js 0.1.33 → 0.1.35

package/README.md

@@ -1,32 +1,67 @@
-<div><a href="https://octanejs.dev/">Octane</a> framework definition and mount adapter for <a href="https://docs.cypress.io/app/component-testing/">component testing</a> with <a href="https://www.cypress.io/">Cypress</a></div>
+<a href="https://octanejs.dev/">Octane</a> framework definition and mount adapter for <a href="https://docs.cypress.io/app/component-testing/">component testing</a> with <a href="https://www.cypress.io/">Cypress</a>
 
 ## Installation
 
-#### With bun
-
 ```sh
+# bun
 bun i cypress-ct-octane-js
+
+# pnpm
+pnpm add cypress-ct-octane-js
+
+# npm
+npm i cypress-ct-octane-js
 ```
 
-#### With pnpm
+## Configuration
 
-```sh
-pnpm add cypress-ct-octane-js
+Add `cypress-ct-octane-js` framework to your `cypress.config.{ts,js}` file
+
+```ts
+export default defineConfig({
+  component: {
+    devServer: {
+      framework: "cypress-ct-octane-js",
+      bundler: "vite",
+      //...more config if necessary
+    },
+  },
+});
 ```
 
-#### With NPM
+If you use Typescript, you may get a type error when setting the framework property. To fix it, type cast the property to `any` like this:
 
-```sh
-npm cypress-ct-octane-js
+```ts
+framework: "cypress-ct-octane-js" as any,
+```
+
+## Adding mount command
+
+Add the following lines to your `component.ts` in the `cypress` directory.
+
+```ts
+import { mount } from "cypress-ct-octane-js";
+
+declare global {
+  namespace Cypress {
+    interface Chainable {
+      mount: typeof mount;
+    }
+  }
+}
+
+Cypress.Commands.add("mount", mount);
 ```
 
 ## Usage example
 
+You can now use the `cy.mount` function to mount octane components in Cypress.
+
 ```javascript
-import { mount } from "cypress-ct-octane-js";
+import { Greeting } from "my-octane-components";
 
-it("example test", () => {
-  mount(<>Hello World!</>);
+it("should display 'Hello World'", () => {
+  cy.mount(<Greeting text="Hello World!" />);
   cy.contains("Hello World!").should("be.visible");
 });
 ```

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "cypress-ct-octane-js",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Octane framework definition and mount adapter for Cypress component testing",
   "keywords": [
+    "component-testing",
     "cypress",
     "octane",
     "testing"