Merge branch 'main' into eslint-dep-upgrade

Author: tylerbutler

.changeset/lazy-lies-enjoy.md

@@ -0,0 +1,18 @@
+---
+"@fluidframework/map": minor
+"__section": legacy
+---
+
+Add legacy beta map compatibility interfaces
+
+New legacy beta map interfaces make it possible to type legacy map-like DDS APIs against Fluid's stable map abstraction while preserving the legacy DDS `get` and `set` APIs.
+
+```typescript
+import type { FluidMapLegacy, IDirectoryBeta, ISharedMapBeta } from "@fluidframework/map/legacy";
+
+declare const directory: IDirectoryBeta;
+declare const sharedMap: ISharedMapBeta;
+
+const directoryMap: FluidMapLegacy<string, unknown> = directory;
+const sharedMapAsLegacyMap: FluidMapLegacy<string, unknown> = sharedMap;
+```

.changeset/petite-pillows-wave.md

@@ -0,0 +1,17 @@
+---
+"fluid-framework": minor
+"@fluidframework/tree": minor
+"__section": fix
+---
+Add SharedTreeOptionsBeta.healUnresolvableIdentifiersOnDecode to recover documents with corrupted identifiers
+
+A SharedTree bug can result in corrupted documents due to their attach summary compressing identifier-field values in a way that cannot be uncompressed.
+This bug manifested as remote clients processing the op throwing an error with the message "Unknown op space ID.".
+
+This change adds an option (`healUnresolvableIdentifiersOnDecode`) to `configuredSharedTreeBetaLegacy` which will allow documents affected by this bug to load again when enabled.
+Enabling this option carries some risk, see documentation on the interface itself for more details.
+
+#### Who is affected
+
+Only SharedTrees attached to a container that was already attached can be impacted.
+Furthermore, this bug only occurs when the attached tree contains [`identifier`](https://fluidframework.com/docs/api/tree/schemafactory-class#identifier-property) fields which contain implicitly generated default values.

.changeset/salty-colts-appear.md

@@ -0,0 +1,19 @@
+---
+"@fluidframework/core-interfaces": minor
+"__section": deprecation
+---
+
+Deprecate LogLevel.default and LogLevel.error
+
+`LogLevel.default` and `LogLevel.error` in `@fluidframework/core-interfaces` are deprecated in favor of the semantically clearer `LogLevel.info` and `LogLevel.essential`.
+
+#### Migration
+
+The recommended replacement for `LogLevel.default` depends on how the value is used:
+
+- For an **event's default `logLevel`** (e.g. the `logLevel` argument to `ITelemetryBaseLogger.send`), the recommendation is `LogLevel.essential`.
+- For a logger's **default `minLogLevel`** (the threshold that filters events), `LogLevel.info` is the recommendation.
+
+The replacement for `LogLevel.error` should always be `LogLevel.essential`.
+
+See [issue #26969](https://github.com/microsoft/FluidFramework/issues/26969) for full guidance and removal tracking (planned for v3.0).

.changeset/twenty-rivers-spend.md

@@ -0,0 +1,14 @@
+---
+"fluid-framework": minor
+"@fluidframework/tree": minor
+"__section": fix
+---
+Fix a SharedTree document corruption bug
+
+A SharedTree bug which could corrupt documents when attaching them to containers has been fixed.
+See `healUnresolvableIdentifiersOnDecode` on `configuredSharedTreeBetaLegacy` for a potential mitigation path for documents that were already corrupted by this bug.
+
+#### Who is affected
+
+Only SharedTrees attached to a container that was already attached can be impacted.
+Furthermore, this bug only occurs when the attached tree contains [`identifier`](https://fluidframework.com/docs/api/tree/schemafactory-class#identifier-property) fields which contain implicitly generated default values.

common/build/eslint-config-fluid/CHANGELOG.md

@@ -1,10 +1,55 @@
 # @fluidframework/eslint-config-fluid Changelog
 
-## vNext
+## [11.0.0](https://github.com/microsoft/FluidFramework/releases/tag/eslint-config-fluid_v11.0.0)
 
-### ⚠ BREAKING CHANGES
+### Breaking: node 22 is now the minimum supported node version
 
-- Node 22 is now the minimum supported Node.js version. This aligns with the standing Node upgrade policy as Node 20 reaches end-of-life on April 30, 2026.
+Node 22 is now the minimum supported Node.js version. This aligns with the standing Node upgrade policy as Node 20 reached end-of-life on April 30, 2026.
+
+### Breaking: import-x/order disabled
+
+The `import-x/order` rule has been disabled. Prefer using formatting tools like Biome to handle import sorting.
+
+### Breaking: ESLint 8 legacy configs no longer exported
+
+This package now uses ESLint flat config format exclusively. The legacy `.eslintrc` format is no longer supported.
+The package root now exports the named flat and server configs directly from `@fluidframework/eslint-config-fluid`.
+
+**Requirements:**
+
+- ESLint 9 (recommended), or
+- ESLint 8.21+ with `ESLINT_USE_FLAT_CONFIG=true` environment variable
+
+**Migration:**
+
+Replace your `.eslintrc.cjs`:
+
+```javascript
+// OLD - .eslintrc.cjs (no longer supported)
+module.exports = { extends: ["@fluidframework/eslint-config-fluid/strict"] };
+```
+
+With `eslint.config.mts`:
+
+```javascript
+// NEW - eslint.config.mts
+import { strict } from "@fluidframework/eslint-config-fluid";
+export default [...strict];
+```
+
+For ESLint 8.21+ users, set the environment variable:
+
+```bash
+ESLINT_USE_FLAT_CONFIG=true eslint .
+```
+
+**Removed files:**
+
+- `base.js`, `minimal-deprecated.js`, `recommended.js`, `strict.js`, `strict-biome.js`, `index.js`
+
+**Removed dependency:**
+
+- `@eslint/eslintrc` (FlatCompat no longer needed)
 
 ## [10.0.0](https://github.com/microsoft/FluidFramework/releases/tag/eslint-config-fluid_v10.0.0)
 

common/build/eslint-config-fluid/README.md

@@ -2,20 +2,46 @@
 
 This package contains a shared ESLint config used by all the packages in the Fluid Framework repo.
 
-It exports the following shared ESLint configs:
+## Requirements
 
-## ESLint 9 Flat Config Support
+- **ESLint 9** (recommended), or
+- **ESLint 8.21+** with `ESLINT_USE_FLAT_CONFIG=true` environment variable
 
-This package supports **ESLint 9 flat config format** via the `flat.mjs` export. Packages can use `eslint.config.mjs` files that import from this module.
+This package uses ESLint's flat config format exclusively. Legacy `.eslintrc` format is not supported.
 
-For flat config (ESLint 9), import from `@fluidframework/eslint-config-fluid/flat.mjs`:
+## Usage
+
+Import the desired configuration and spread it into your `eslint.config.mts`:
 
 ```javascript
-// eslint.config.mjs
-import { strict } from "@fluidframework/eslint-config-fluid/flat.mjs";
+// eslint.config.mts
+import { strict } from "@fluidframework/eslint-config-fluid";
 export default [...strict];
 ```
 
+The package root exports the standard flat and server configs. For specialized cases, explicit subpaths are also available:
+`@fluidframework/eslint-config-fluid/flat.mts` and `@fluidframework/eslint-config-fluid/server.mts`.
+
+### ESLint 8.21+ Users
+
+If you're using ESLint 8.21-8.x, you must enable flat config support via environment variable:
+
+```bash
+ESLINT_USE_FLAT_CONFIG=true eslint .
+```
+
+Or in your npm scripts:
+
+```json
+{
+	"scripts": {
+		"lint": "cross-env ESLINT_USE_FLAT_CONFIG=true eslint ."
+	}
+}
+```
+
+**Note:** ESLint 8.x flat config support was experimental. We recommend upgrading to ESLint 9 for the best experience.
+
 ### Modular Structure
 
 The flat config is organized into a modular structure for maintainability:
@@ -34,7 +60,6 @@ eslint-config-fluid/
 │       ├── base.mts            # Base config builder with all plugins
 │       ├── overrides.mts       # Shared overrides (test files, React, JS files)
 │       └── factory.mts         # Config factory functions
-└── [legacy files]              # Legacy eslintrc-style configs (deprecated)
 ```
 
 This structure ensures:
@@ -48,29 +73,34 @@ This structure ensures:
 
 ### Recommended
 
-This is the standard config for use in Fluid Framework libraries.
-It is also the default library export.
+The standard named config for use in Fluid Framework libraries.
 
-This configuration is recommended for all libraries in the repository, though use of the [strict](#strict) config is preferred whenever reasonable.
+```javascript
+import { recommended } from "@fluidframework/eslint-config-fluid";
+export default [...recommended];
+```
 
-**Legacy format:** Imported via `@fluidframework/eslint-config-fluid` (or `@fluidframework/eslint-config-fluid/recommended`).
-**Flat config:** Import `recommended` from `@fluidframework/eslint-config-fluid/flat.mjs`.
+This configuration is recommended for all libraries in the repository, though use of the [strict](#strict) config is preferred whenever reasonable.
 
 ### Strict
 
-The strictest config for use in Fluid Framework libraries.
-Recommended for highest code quality enforcement.
+The strictest config for use in Fluid Framework libraries. Recommended for highest code quality enforcement.
 
-In particular, use of this config is encouraged for libraries with public facing APIs, and those used as external-facing examples (e.g. those mentioned on `fluidframework.com`).
+```javascript
+import { strict } from "@fluidframework/eslint-config-fluid";
+export default [...strict];
+```
 
-**Legacy format:** Imported via `@fluidframework/eslint-config-fluid/strict`.
-**Flat config:** Import `strict` from `@fluidframework/eslint-config-fluid/flat.mjs`.
+Use of this config is encouraged for libraries with public facing APIs, and those used as external-facing examples (e.g. those mentioned on `fluidframework.com`).
 
 ### Strict-Biome
 
-A version of the "strict" config that disables rules that are supported by Biome's "recommended" lint config.
-This config is intended to be used in projects that use both eslint and Biome for linting.
-This config is considered experimental.
+A version of the "strict" config that disables rules covered by Biome's "recommended" lint config. Intended for projects using both ESLint and Biome.
+
+```javascript
+import { strictBiome } from "@fluidframework/eslint-config-fluid";
+export default [...strictBiome];
+```
 
 ## Changing the lint config