Flatten fast-element export subpaths

Keep the public fast-element export paths flat while resolving package export types, test, and default targets to the original source and output locations.

Also address review feedback by preserving explicit declarative schemas and avoiding shell-string API doc generation.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: janechu

.github/skills/typescript/SKILL.md

@@ -18,7 +18,7 @@ import { type Constructable, isFunction } from "../interfaces.js";
 Sub-entry-points expose focused APIs through the `exports` map:
 
 ```ts
-import { twoWay } from "@microsoft/fast-element/binding/two-way.js";
+import { twoWay } from "@microsoft/fast-element/two-way.js";
 import { reactive } from "@microsoft/fast-element/state.js";
 import { composedParent } from "@microsoft/fast-element/utilities.js";
 ```
@@ -67,8 +67,8 @@ Templates use the `html` tagged template literal typed to the element class:
 
 ```ts
 import { html } from "@microsoft/fast-element/html.js";
-import { repeat } from "@microsoft/fast-element/directives/repeat.js";
-import { when } from "@microsoft/fast-element/directives/when.js";
+import { repeat } from "@microsoft/fast-element/repeat.js";
+import { when } from "@microsoft/fast-element/when.js";
 import type { MyElement } from "./my-element.js";
 
 export const template = html<MyElement>`
@@ -97,7 +97,7 @@ export const template = html<MyElement>`
 Two-way bindings require a sub-entry-point import:
 
 ```ts
-import { twoWay } from "@microsoft/fast-element/binding/two-way.js";
+import { twoWay } from "@microsoft/fast-element/two-way.js";
 ```
 
 ### Partial HTML

change/@microsoft-fast-element-22265526-9ae0-4996-878d-ec0bd68133c2.json

@@ -1,6 +1,6 @@
 {
   "type": "major",
-  "comment": "Move optional helpers such as Updates, Observable, attr, binding, DOM, Schema, html, templating, render, hydration, directives, volatile, and ArrayObserver to dedicated fast-element subpath exports while keeping controller and definition internals on the root entrypoint.",
+  "comment": "Move optional helpers to dedicated flat fast-element subpath exports such as @microsoft/fast-element/children.js, @microsoft/fast-element/repeat.js, @microsoft/fast-element/two-way.js, @microsoft/fast-element/signal.js, @microsoft/fast-element/attribute-map.js, and @microsoft/fast-element/observer-map.js while keeping controller and definition internals on the root entrypoint.",
   "packageName": "@microsoft/fast-element",
   "email": "7559015+janechu@users.noreply.github.com",
   "dependentChangeType": "none"

examples/todo-app/src/todo-app.template.ts

@@ -1,6 +1,6 @@
-import { twoWay } from "@microsoft/fast-element/binding/two-way.js";
-import { repeat } from "@microsoft/fast-element/directives/repeat.js";
 import { html } from "@microsoft/fast-element/html.js";
+import { repeat } from "@microsoft/fast-element/repeat.js";
+import { twoWay } from "@microsoft/fast-element/two-way.js";
 import type { TodoApp } from "./todo-app.js";
 import type { Todo } from "./todo-list.js";
 import "./todo-form.js";

examples/todo-app/src/todo-form.template.ts

@@ -1,5 +1,5 @@
-import { twoWay } from "@microsoft/fast-element/binding/two-way.js";
 import { html } from "@microsoft/fast-element/html.js";
+import { twoWay } from "@microsoft/fast-element/two-way.js";
 import type { TodoForm } from "./todo-form.js";
 
 export const template = html<TodoForm>`

packages/fast-element/DECLARATIVE_DESIGN.md

@@ -3,8 +3,8 @@
 This document is intended for contributors who want to understand the internal
 architecture of the declarative runtime in
 `@microsoft/fast-element/declarative.js` and the schema-driven map extensions in
-`@microsoft/fast-element/extensions/attribute-map.js` and
-`@microsoft/fast-element/extensions/observer-map.js`. It covers the feature's
+`@microsoft/fast-element/attribute-map.js` and
+`@microsoft/fast-element/observer-map.js`. It covers the feature's
 purpose, core concepts, data flow, and its integration with the rest of
 `@microsoft/fast-element`.
 
@@ -58,7 +58,7 @@ registry-aware declarative template bridge.
 |---|---|
 | **Server-agnostic rendering** | Templates are plain HTML strings with no dependency on Node.js or any specific SSR framework. |
 | **Progressive enhancement** | Components can be server-rendered and then hydrated client-side without a full re-render. |
-| **FAST parity** | The declarative syntax maps 1-to-1 to FAST Element directive helpers (`repeat`, `when`, `slotted`, `children`, `ref`) from their `@microsoft/fast-element/directives/*` subpaths. |
+| **FAST parity** | The declarative syntax maps 1-to-1 to FAST Element directive helpers (`repeat`, `when`, `slotted`, `children`, `ref`) from their flat `@microsoft/fast-element/*` subpaths. |
 | **Minimal authoring overhead** | Component authors write HTML, not tagged template strings, while retaining full reactive capabilities. |
 
 ---
@@ -119,7 +119,7 @@ An optional layer that uses the `Schema` to automatically:
 - Propagate deep property mutations back through FAST's observable system so bindings re-render.
 
 Enabled via the `observerMap()` definition extension. Import the extension from
-`@microsoft/fast-element/extensions/observer-map.js`; the declarative entrypoint
+`@microsoft/fast-element/observer-map.js`; the declarative entrypoint
 does not re-export it. Calling `observerMap()` without arguments observes all
 root properties discovered in the template or supplied schema.
 
@@ -167,7 +167,7 @@ For non-declarative elements, pass a schema directly to `observerMap()`:
 ```typescript
 import { FASTElement } from "@microsoft/fast-element";
 import { Schema } from "@microsoft/fast-element/schema.js";
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 
 class MyElement extends FASTElement {}
 
@@ -203,7 +203,7 @@ An optional layer that uses the `Schema` to automatically register `@attr`-style
 - `FASTElementDefinition.attributeLookup` is keyed by the HTML attribute name, and `propertyLookup` is keyed by the JS property name so `attributeChangedCallback` correctly delegates to the new `AttributeDefinition`.
 
 Enabled via the `attributeMap()` definition extension. Import the extension from
-`@microsoft/fast-element/extensions/attribute-map.js`; the declarative entrypoint
+`@microsoft/fast-element/attribute-map.js`; the declarative entrypoint
 does not re-export it. Calling `attributeMap()` without arguments uses the
 default `"camelCase"` strategy. To preserve binding keys exactly as written,
 pass `attributeMap({ "attribute-name-strategy": "none" })`. Outside declarative
@@ -297,13 +297,13 @@ import {
 import {
     attributeMap,
     type AttributeMapConfig,
-} from "@microsoft/fast-element/extensions/attribute-map.js";
+} from "@microsoft/fast-element/attribute-map.js";
 import {
     observerMap,
     type ObserverMapConfig,
     type ObserverMapPathEntry,
     type ObserverMapPathNode,
-} from "@microsoft/fast-element/extensions/observer-map.js";
+} from "@microsoft/fast-element/observer-map.js";
 ```
 
 The declarative entrypoint does not re-export the map helpers or their
@@ -324,8 +324,8 @@ Primary map extension exports:
 
 | Export | Public subpath | Purpose |
 |---|---|---|
-| `attributeMap()` | `@microsoft/fast-element/extensions/attribute-map.js` | Define extension that registers `@attr`-style properties for leaf bindings discovered during parsing or supplied by `definition.schema`. |
-| `observerMap()` | `@microsoft/fast-element/extensions/observer-map.js` | Define extension that defines observable root properties and proxy-based deep change tracking from `config.schema`, `definition.schema`, or a declarative template schema. |
+| `attributeMap()` | `@microsoft/fast-element/attribute-map.js` | Define extension that registers `@attr`-style properties for leaf bindings discovered during parsing or supplied by `definition.schema`. |
+| `observerMap()` | `@microsoft/fast-element/observer-map.js` | Define extension that defines observable root properties and proxy-based deep change tracking from `config.schema`, `definition.schema`, or a declarative template schema. |
 
 The implementation element class (`<f-template>`), `TemplateElement.config()`,
 `TemplateElement.options()`, `ElementOptions*`, and
@@ -349,10 +349,10 @@ The extension subpaths export their own configuration types:
 
 | Type | Public subpath | Purpose |
 |---|---|---|
-| `ObserverMapConfig` | `@microsoft/fast-element/extensions/observer-map.js` | Configuration object for `observerMap()`; accepts optional `schema` and `properties` keys. |
-| `ObserverMapPathEntry` | `@microsoft/fast-element/extensions/observer-map.js` | `boolean \| ObserverMapPathNode` — a node in the observation path tree. |
-| `ObserverMapPathNode` | `@microsoft/fast-element/extensions/observer-map.js` | Object node with optional `$observe` and child property overrides. |
-| `AttributeMapConfig` | `@microsoft/fast-element/extensions/attribute-map.js` | Configuration object for `attributeMap()`; accepts `attribute-name-strategy`. |
+| `ObserverMapConfig` | `@microsoft/fast-element/observer-map.js` | Configuration object for `observerMap()`; accepts optional `schema` and `properties` keys. |
+| `ObserverMapPathEntry` | `@microsoft/fast-element/observer-map.js` | `boolean \| ObserverMapPathNode` — a node in the observation path tree. |
+| `ObserverMapPathNode` | `@microsoft/fast-element/observer-map.js` | Object node with optional `$observe` and child property overrides. |
+| `AttributeMapConfig` | `@microsoft/fast-element/attribute-map.js` | Configuration object for `attributeMap()`; accepts `attribute-name-strategy`. |
 
 ---
 

packages/fast-element/DECLARATIVE_HTML.md

@@ -36,8 +36,8 @@ installed only when `enableHydration()` is called from
 
 `observerMap()` and `attributeMap()` remain available from the declarative
 entrypoint for existing declarative imports. New code should prefer the
-extension subpaths, `@microsoft/fast-element/extensions/observer-map.js` and
-`@microsoft/fast-element/extensions/attribute-map.js`, especially when using
+extension subpaths, `@microsoft/fast-element/observer-map.js` and
+`@microsoft/fast-element/attribute-map.js`, especially when using
 the maps without declarative templates.
 
 Example:
@@ -142,7 +142,7 @@ For non-declarative/manual schemas, import from the extension subpath and pass
 `observerMap({ schema })`.
 
 ```typescript
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 ```
 
 For finer control, pass a configuration object with a `properties` key that maps root property names to a recursive path tree:
@@ -199,7 +199,7 @@ Manual schema example:
 ```typescript
 import { FASTElement } from "@microsoft/fast-element";
 import { Schema } from "@microsoft/fast-element/schema.js";
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 
 class MyElement extends FASTElement {}
 
@@ -229,7 +229,7 @@ on the FAST element definition and import `attributeMap()` from its extension
 subpath.
 
 ```typescript
-import { attributeMap } from "@microsoft/fast-element/extensions/attribute-map.js";
+import { attributeMap } from "@microsoft/fast-element/attribute-map.js";
 ```
 
 By default, the binding key is treated as a camelCase property name and the HTML

packages/fast-element/DECLARATIVE_MIGRATION.md

@@ -119,8 +119,8 @@ Public declarative imports now come from
 `@microsoft/fast-element/declarative.js` rather than
 `@microsoft/fast-html`. Existing declarative imports for `attributeMap()` and
 `observerMap()` remain valid. New code that only needs the map extensions should
-prefer `@microsoft/fast-element/extensions/attribute-map.js` and
-`@microsoft/fast-element/extensions/observer-map.js`.
+prefer `@microsoft/fast-element/attribute-map.js` and
+`@microsoft/fast-element/observer-map.js`.
 
 ### Schema changes
 
@@ -184,8 +184,8 @@ factored away from declarative templating. Prefer importing them from their
 dedicated subpaths for tree-shaken or non-declarative use:
 
 ```ts
-import { attributeMap } from "@microsoft/fast-element/extensions/attribute-map.js";
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { attributeMap } from "@microsoft/fast-element/attribute-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 ```
 
 `FASTElementDefinition.schema` is optional. `declarativeTemplate()` assigns it
@@ -196,7 +196,7 @@ directly in configuration:
 ```ts
 import { FASTElement } from "@microsoft/fast-element";
 import { Schema } from "@microsoft/fast-element/schema.js";
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 
 class MyElement extends FASTElement {}
 

packages/fast-element/DECLARATIVE_SCHEMA_OBSERVER_MAP.md

@@ -30,7 +30,7 @@ The Schema and Observer Map architecture enables automatic observation of comple
 - **Schema Class**: Generates JSON schemas that describe the structure and binding paths of data objects based on template analysis or manually registered paths
 - **Observer Map Class**: Uses the schema information to automatically define observable properties and create proxies for nested object observation
 - **f-template Integration**: Template processing automatically populates schemas and configures observer maps during template compilation
-- **Extension Subpaths**: `@microsoft/fast-element/extensions/observer-map.js` and `@microsoft/fast-element/extensions/attribute-map.js` expose the map helpers independently from declarative templating
+- **Extension Subpaths**: `@microsoft/fast-element/observer-map.js` and `@microsoft/fast-element/attribute-map.js` expose the map helpers independently from declarative templating
 
 ### Supported Data Types
 
@@ -167,7 +167,7 @@ entrypoint continues to re-export `observerMap()` for existing declarative code:
 
 ```typescript
 import { declarativeTemplate } from "@microsoft/fast-element/declarative.js";
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 
 MyElement.define(
   {
@@ -188,7 +188,7 @@ configuration:
 ```typescript
 import { FASTElement } from "@microsoft/fast-element";
 import { Schema } from "@microsoft/fast-element/schema.js";
-import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+import { observerMap } from "@microsoft/fast-element/observer-map.js";
 
 class MyElement extends FASTElement {}
 

packages/fast-element/DESIGN.md

@@ -43,7 +43,7 @@ For deep dives into specific areas, see the linked detailed documents.
 | Reactive data binding | `Observable`, `ExpressionNotifier`, `oneWay`/`oneTime`/`listener` bindings |
 | Declarative templating | `html` tagged template literal → `ViewTemplate` → compiled `HTMLView` |
 | Declarative HTML runtime | `@microsoft/fast-element/declarative.js` → `declarativeTemplate()`, `TemplateParser`, `Schema` |
-| Schema-driven extensions | `@microsoft/fast-element/extensions/attribute-map.js` and `@microsoft/fast-element/extensions/observer-map.js` → tree-shakeable map helpers usable with declarative or manually supplied schemas |
+| Schema-driven extensions | `@microsoft/fast-element/attribute-map.js` and `@microsoft/fast-element/observer-map.js` → tree-shakeable map helpers usable with declarative or manually supplied schemas |
 | Async DOM updates | `Updates` queue (batched, `requestAnimationFrame`-aligned) |
 | Scoped styles | `css` tagged template literal → `ElementStyles` → `adoptedStylesheets` / `<style>` |
 | Dependency injection | `DI` container, `@inject`, `@singleton`, `@transient`, resolvers |
@@ -333,8 +333,8 @@ FAST Element also owns the declarative HTML runtime that previously lived in a
 separate package. The dedicated `@microsoft/fast-element/declarative.js`
 entrypoint exports the declarative runtime API: `declarativeTemplate()`,
 `TemplateParser`, `Schema`, `schemaRegistry`, and related parser/schema types.
-Import map helpers from `@microsoft/fast-element/extensions/attribute-map.js`
-and `@microsoft/fast-element/extensions/observer-map.js`. These subpaths keep
+Import map helpers from `@microsoft/fast-element/attribute-map.js`
+and `@microsoft/fast-element/observer-map.js`. These subpaths keep
 the schema-driven map extensions factored away from declarative templating so
 they can also be used with manually supplied schemas. The `<f-template>` element
 is an internal native `HTMLElement` publisher that `declarativeTemplate()`

packages/fast-element/MIGRATION.md

@@ -46,7 +46,7 @@ removed `@microsoft/fast-html` package.
 | Before | After |
 |---|---|
 | `@microsoft/fast-html` | `@microsoft/fast-element/declarative.js` |
-| `@microsoft/fast-html/utilities.js` | `@microsoft/fast-element/declarative/utilities.js` |
+| `@microsoft/fast-html/utilities.js` | `@microsoft/fast-element/declarative-utilities.js` |
 
 Core FAST Element helpers now use dedicated subpaths:
 
@@ -65,19 +65,19 @@ Core FAST Element helpers now use dedicated subpaths:
 | `enableHydration`, `HydrationTracker`, hydration types | `@microsoft/fast-element/hydration.js` |
 | `ArrayObserver` | `@microsoft/fast-element/array-observer.js` |
 | `volatile` | `@microsoft/fast-element/volatile.js` |
-| `children` | `@microsoft/fast-element/directives/children.js` |
-| `elements`, `NodeObservationDirective` | `@microsoft/fast-element/directives/node-observation.js` |
-| `ref` | `@microsoft/fast-element/directives/ref.js` |
-| `slotted` | `@microsoft/fast-element/directives/slotted.js` |
-| `when` | `@microsoft/fast-element/directives/when.js` |
-| `repeat` | `@microsoft/fast-element/directives/repeat.js` |
+| `children` | `@microsoft/fast-element/children.js` |
+| `elements`, `NodeObservationDirective` | `@microsoft/fast-element/node-observation.js` |
+| `ref` | `@microsoft/fast-element/ref.js` |
+| `slotted` | `@microsoft/fast-element/slotted.js` |
+| `when` | `@microsoft/fast-element/when.js` |
+| `repeat` | `@microsoft/fast-element/repeat.js` |
 
 ### Migration steps
 
 1. Update declarative runtime imports to
    `@microsoft/fast-element/declarative.js`.
 2. Update declarative utility imports such as `deepMerge` to
-   `@microsoft/fast-element/declarative/utilities.js`.
+   `@microsoft/fast-element/declarative-utilities.js`.
 3. Keep importing root FAST Element APIs such as `FASTElement`, `FAST`,
    `ElementController`, and definition/controller types from
    `@microsoft/fast-element`, and import moved helpers from their dedicated
@@ -153,8 +153,8 @@ Core FAST Element helpers now use dedicated subpaths:
 
    ```typescript
    import { declarativeTemplate } from "@microsoft/fast-element/declarative.js";
-   import { attributeMap } from "@microsoft/fast-element/extensions/attribute-map.js";
-   import { observerMap } from "@microsoft/fast-element/extensions/observer-map.js";
+   import { attributeMap } from "@microsoft/fast-element/attribute-map.js";
+   import { observerMap } from "@microsoft/fast-element/observer-map.js";
 
    MyElement.define(
        {