@plone/volto 19.0.0-alpha.9 → 19.1.0

package/.eslintignore

@@ -1,2 +1,4 @@
 /types/
 !types/react-router-hash-link.d.ts
+cypress/fixtures/
+!.storybook

package/.eslintrc

@@ -41,9 +41,9 @@
       "error",
       {
         "selector": "JSXElement[openingElement.name.name='img']",
-        "message": "Use the Image component from '@plone/volto/components/theme/Image/Image' instead of <img> tag."
-      }
-    ]
+        "message": "Use the Image component from '@plone/volto/components/theme/Image/Image' instead of <img> tag.",
+      },
+    ],
   },
   "settings": {
     "import/resolver": {
@@ -57,9 +57,7 @@
         ],
         "extensions": [".js", ".jsx", ".ts", ".tsx", ".json"],
       },
-      "babel-plugin-root-import": {
-        "rootPathSuffix": "src",
-      },
+      "node": { "extensions": [".js", ".jsx", ".ts", ".tsx", ".json"] },
     },
     "import/core-modules": ["load-volto-addons"],
     "react": {
@@ -76,6 +74,20 @@
       "plugins": ["prettier", "react-hooks", "jsx-a11y"],
       "parser": "@typescript-eslint/parser",
     },
+    {
+      "files": [
+        "**/*.test.js",
+        "**/*.test.jsx",
+        "**/*.test.ts",
+        "**/*.test.tsx",
+        "**/cypress/**/*.js",
+        "**/cypress/**/*.ts",
+      ],
+      "plugins": ["no-only-tests"],
+      "rules": {
+        "no-only-tests/no-only-tests": "error",
+      },
+    },
     {
       "files": ["**/*.stories.js", "**/*.stories.jsx"],
       "rules": {
@@ -84,17 +96,17 @@
     },
     {
       "files": [
-        "**/Image/Image.jsx", 
+        "**/Image/Image.jsx",
         "**/Image/Image.js",
         "**/*.stories.js",
-        "**/*.stories.jsx", 
+        "**/*.stories.jsx",
         "**/*.test.js",
-        "**/*.test.jsx"
+        "**/*.test.jsx",
       ],
       "rules": {
-        "no-restricted-syntax": "off"
-      }
-    }
+        "no-restricted-syntax": "off",
+      },
+    },
   ],
   "globals": {
     "root": true,
@@ -108,10 +120,9 @@
     "__SENTRY__": true,
     "cy": true,
     "Cypress": true,
-    "jest": true,
     "socket": true,
     "webpackIsomorphicTools": true,
-    "vitest":true,
-    "vi":true
+    "vitest": true,
+    "vi": true,
   },
 }

package/AGENTS.md

@@ -0,0 +1,47 @@
+# AGENTS.md
+
+This file applies only to `packages/volto` and its subdirectories.
+
+## What This Package Is
+
+- `@plone/volto` is the main Plone 6 frontend application package.
+- It is a React application built with Volto's Razzle-based toolchain.
+- This package is still mostly JavaScript, with selective TypeScript support.
+
+## Architecture Notes
+
+- The app is driven by configuration registry patterns, add-on extensibility, Redux state, and block-based editing.
+- `src/components/` contains most UI and editor code.
+- `src/config/` and registry-related wiring define app composition and extensibility points.
+- `theme/` contains Less and Semantic UI customization.
+- `cypress/` contains acceptance coverage and fixtures.
+
+## Editing Rules
+
+- Prefer TypeScript for all new modules and features, even though this package still contains substantial JavaScript.
+- Refactoring touched code toward TypeScript is welcome, but not required.
+- Respect add-on extensibility. Prefer configuration and composition points over hardcoded behavior when touching core features.
+- Keep block changes aligned with existing editor/view separation and serialization expectations.
+- Do not treat this package like a standalone Vite library; its build, theming, and test workflows are app-specific.
+- When editing runtime code that depends on `@plone/registry`, `@plone/components`, or `@plone/volto-slate`, validate the integration instead of only linting local files.
+- Be careful with imports from sibling packages. If a dependency is a workspace package, prefer its public API over deep internal paths.
+
+## Validation
+
+Choose the narrowest useful set:
+
+```sh
+pnpm --filter @plone/volto test --run
+pnpm --filter @plone/volto test:ci
+pnpm --filter @plone/volto lint
+pnpm --filter @plone/volto check:ts
+pnpm --filter @plone/volto build
+pnpm --filter @plone/volto storybook
+make ci-acceptance-test-run-all
+```
+
+## Additional Guidance
+
+- For style changes, use the package's lint and stylelint commands.
+- For i18n changes, validate with `pnpm --filter @plone/volto i18n:ci`.
+- For docs-related work inside this package, also consider the Sphinx docs under the repo root.