chore: create second-generation world

.changeset/README.md

@@ -8,9 +8,9 @@ find the full documentation for it [in our repository](https://github.com/change
 
 Changesets are a way to manage versions and changelogs for monorepos. Each changeset:
 
--   Describes changes made in one or more packages
--   Indicates the type of change (major, minor, patch)
--   Contains a brief markdown summary of the changes
+- Describes changes made in one or more packages
+- Indicates the type of change (major, minor, patch)
+- Contains a brief markdown summary of the changes
 
 ## How to Add a Changeset
 
@@ -29,18 +29,25 @@ Changesets are a way to manage versions and changelogs for monorepos. Each chang
 
 The command will create a new markdown file in the `.changeset` directory with your changes.
 
+## Important: @spectrum-web-components/core and component updates
+
+When making changes to `@spectrum-web-components/core`, you **must** also include the corresponding `@spectrum-web-components` component in the same changeset to ensure the changes appear in the component's changelog. This is because `@spectrum-web-components/core` changes are internal and don't automatically propagate to the component changelogs.
+
+**Best practice**: Create a single changeset that includes both packages when updating core functionality that affects a specific component.
+
 ## Example Changeset
 
 A typical changeset file looks like this:
 
 ```markdown
 ---
+'@spectrum-web-components/core': patch
 '@spectrum-web-components/button': minor
 '@spectrum-web-components/theme': patch
 ---
 
--   **Added**: Added new variant `tertiary` to `<sp-button>` component [#9999](https://github.com/adobe/spectrum-web-components/pull/9999)
--   **Fixed**: Fixed `<sp-theme>` theme compatibility issues [#10000](https://github.com/adobe/spectrum-web-components/pull/10000)
+- **Added**: Added new variant `tertiary` to `<sp-button>` component [#9999](https://github.com/adobe/spectrum-web-components/pull/9999)
+- **Fixed**: Fixed `<sp-theme>` theme compatibility issues [#10000](https://github.com/adobe/spectrum-web-components/pull/10000)
 ```
 
 For our guidelines on writing changesets, see [our writing changesets guide](https://opensource.adobe.com/spectrum-web-components/guides/writing-changesets/).
@@ -61,6 +68,6 @@ We have a quick list of common questions to get you started engaging with this p
 
 ## Additional Resources
 
--   [Changesets Documentation](https://github.com/changesets/changesets)
--   [Common Questions](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
--   [Detailed Release Process](https://github.com/changesets/changesets/blob/main/docs/detailed-explanation.md)
+- [Changesets Documentation](https://github.com/changesets/changesets)
+- [Common Questions](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)
+- [Detailed Release Process](https://github.com/changesets/changesets/blob/main/docs/detailed-explanation.md)

.changeset/config.json

@@ -7,12 +7,22 @@
         }
     ],
     "commit": false,
-    "fixed": [["@spectrum-web-components/*"]],
-    "linked": [],
+    "fixed": [
+        [
+            "@spectrum-web-components/*",
+            "!@spectrum-web-components/core",
+            "!@spectrum-web-components/1st-gen",
+            "!@spectrum-web-components/2nd-gen"
+        ]
+    ],
+    "linked": [["@adobe/swc", "@spectrum-web-components/core"]],
     "access": "public",
     "baseBranch": "main",
     "updateInternalDependencies": "patch",
-    "ignore": [],
+    "ignore": [
+        "@spectrum-web-components/1st-gen",
+        "@spectrum-web-components/2nd-gen"
+    ],
     "snapshot": {
         "useCalculatedVersion": true,
         "prereleaseTemplate": "{tag}.{datetime}"

.cursor/rules/contributor-doc-update.mdc

@@ -0,0 +1,52 @@
+---
+description: Useful for updating auto-generated navigation and validating links in the contributor docs
+alwaysApply: false
+---
+
+# Contributor docs navigation and link validation
+
+## When to apply this rule
+
+Recognize and apply this rule when the user requests any of the following:
+- Update contributor docs navigation
+- Update nav / TOC / breadcrumbs in contributor docs
+- Regenerate contributor docs
+- Validate/verify links in contributor docs
+- Fix broken links in contributor docs
+- Any mention of "CONTRIBUTOR-DOCS" or "contributor docs" with "update", "nav", "links", or "verify"
+
+## Instructions location
+
+**Primary path:** `CONTRIBUTOR-DOCS/01_contributor-guides/07_authoring-contributor-docs/01_ai-agent-instructions.md`
+
+## What to do
+
+1. **Verify the instructions file exists** at the path above
+   - If the file exists, read it and follow the instructions for "Role 1: Operator"
+   - If the file does NOT exist, see "Self-correction procedure" below
+
+2. **Follow the AI agent instructions** to:
+   - Run the nav update script (which automatically validates links)
+   - Handle any broken links that are reported
+   - Report results to the user
+
+## Self-correction procedure
+
+If the instructions file is not found at the expected path:
+
+1. Search for the file using: `glob_file_search` with pattern `**/ai-agent-instructions.md`
+2. Filter results to find the one in `CONTRIBUTOR-DOCS/` folder
+3. Read the found file to confirm it contains the nav update instructions
+4. **Update this rule file** with the new path by modifying the "Primary path" line above
+5. Inform the user that you've updated the rule with the new location
+6. Continue with the nav update process
+
+## Quick reference
+
+The nav update process typically involves:
+- Running a Node.js script in the authoring-contributor-docs folder
+- The script automatically updates breadcrumbs, TOC, and validates all links
+- If broken links are found, fix straightforward issues automatically
+- Only consult the user for ambiguous cases
+
+Execution time is typically 20-200ms for the entire CONTRIBUTOR-DOCS tree.

.eslintrc.json

@@ -7,18 +7,16 @@
     "extends": [
         "eslint:recommended",
         "plugin:@typescript-eslint/recommended",
-        "plugin:prettier/recommended",
-        "plugin:lit-a11y/recommended",
-        "plugin:require-extensions/recommended"
+        "plugin:prettier/recommended"
     ],
+    "ignorePatterns": ["CONTRIBUTOR-DOCS/**/*"],
     "overrides": [
         {
             "extends": ["plugin:jsonc/recommended-with-jsonc"],
             "files": ["*.json"],
             "parser": "jsonc-eslint-parser",
             "rules": {
-                "jsonc/sort-keys": ["warn"],
-                "notice/notice": "off"
+                "jsonc/sort-keys": ["warn"]
             }
         },
         {
@@ -74,97 +72,56 @@
                             "cpu",
                             "publishConfig"
                         ],
-                        "pathPattern": "^$" // Top-level properties
+                        "pathPattern": "^$"
                     },
                     {
-                        /*
-                         * This rule excludes export conditions from alphabetical sorting.
-                         * Since node.js processes export conditions in order and chooses the
-                         * first match, they need to be ordered logically, not alphabetically.
-                         */
                         "order": { "type": "asc" },
-                        "pathPattern": "^(?!exports\\[).*" // All properties except export conditions
+                        "pathPattern": "^(?!exports\\[).*"
                     }
                 ]
             }
         },
         {
-            "files": ["scripts/*"],
+            "extends": ["./1st-gen/.eslintrc.json"],
+            "files": ["1st-gen/**/*"],
             "rules": {
-                "no-console": ["off"]
+                "notice/notice": [
+                    "error",
+                    {
+                        "mustMatch": "Copyright [0-9]{0,4} Adobe. All rights reserved.",
+                        "templateFile": "config/license.js"
+                    }
+                ]
             }
         },
         {
-            "files": ["react/**/*.ts"],
+            "extends": ["./2nd-gen/.eslintrc.json"],
+            "files": ["2nd-gen/**/*"],
             "rules": {
-                "@typescript-eslint/no-explicit-any": "off"
+                "notice/notice": [
+                    "error",
+                    {
+                        "mustMatch": "Copyright [0-9]{0,4} Adobe. All rights reserved.",
+                        "templateFile": "../../../config/license.js"
+                    }
+                ]
             }
         }
     ],
     "parser": "@typescript-eslint/parser",
     "parserOptions": {
-        "ecmaVersion": 2020,
+        "ecmaVersion": "latest",
         "sourceType": "module"
     },
-    "plugins": [
-        "@typescript-eslint",
-        "notice",
-        "@spectrum-web-components",
-        "import",
-        "require-extensions"
-    ],
+    "plugins": ["@typescript-eslint"],
     "root": true,
     "rules": {
-        "@spectrum-web-components/prevent-argument-names": [
-            "error",
-            ["e", "ev", "evt", "err"]
-        ],
-        "curly": ["error", "all"],
-        "import/extensions": [
-            "error",
-            "ignorePackages",
-            {
-                "ts": "never"
-            }
-        ],
-        "import/prefer-default-export": "off",
-        "lit-a11y/click-events-have-key-events": [
-            "error",
-            {
-                "allowList": [
-                    "sp-button",
-                    "sp-action-button",
-                    "sp-checkbox",
-                    "sp-radio",
-                    "sp-switch",
-                    "sp-menu-item",
-                    "sp-clear-button",
-                    "sp-underlay"
-                ]
-            }
-        ],
         "no-console": [
             "error",
             {
                 "allow": ["warn", "error"]
             }
         ],
-        "no-debugger": 2,
-        "notice/notice": [
-            "error",
-            {
-                "mustMatch": "Copyright [0-9]{0,4} Adobe. All rights reserved.",
-                "templateFile": "config/license.js"
-            }
-        ],
-        "sort-imports": [
-            "error",
-            {
-                "allowSeparatedGroups": false,
-                "ignoreCase": true,
-                "ignoreDeclarationSort": true,
-                "ignoreMemberSort": false
-            }
-        ]
+        "no-debugger": 2
     }
 }