Skip to content

Commit 51fab45

Browse files
authored
Repath packages/agentic-* to packages/agentic/* (#4210)
* move packages/agentic-<pkg> to packages/agentic/<pkg> * repath design and components packages * add changeset * fix dead links
1 parent bff557d commit 51fab45

511 files changed

Lines changed: 152 additions & 114 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.changeset/crisp-falcons-teach.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
"@uifabricshared/foundation-compose": patch
3+
"@fluentui-react-native/notification": patch
4+
"@uifabricshared/theming-ramp": patch
5+
"@fluentui-react-native/persona-coin": patch
6+
"@fluentui-react-native/radio-group": patch
7+
"@fluentui-react-native/dropdown": patch
8+
"@fluentui-react-native/android-theme": patch
9+
"@fluentui-react-native/default-theme": patch
10+
"@fluentui-react-native/theming-utils": patch
11+
"@fluentui-react-native/separator": patch
12+
"@fluentui-react-native/experimental-shimmer": patch
13+
"@fluentui-react-native/spinner": patch
14+
"@fluentui-react-native/theme-tokens": patch
15+
"@fluentui-react-native/checkbox": patch
16+
"@fluentui-react-native/drawer": patch
17+
"@fluentui-react-native/experimental-shadow": patch
18+
"@fluentui-react-native/framework": patch
19+
"@fluentui-react-native/apple-theme": patch
20+
"@fluentui-react-native/theme-types": patch
21+
"@fluentui-react-native/win32-theme": patch
22+
"@fluentui-react-native/components": patch
23+
"@fluentui-react-native/divider": patch
24+
"@fluentui-react-native/tablist": patch
25+
"@fluentui-react-native/avatar": patch
26+
"@fluentui-react-native/button": patch
27+
"@fluentui-react-native/switch": patch
28+
"@fluentui-react-native/badge": patch
29+
"@fluentui-react-native/input": patch
30+
"@fluentui-react-native/chip": patch
31+
"@fluentui-react-native/menu": patch
32+
"@fluentui-react-native/text": patch
33+
"@fluentui-react-native/theme": patch
34+
"@fluentui-react-native/design": patch
35+
"@fluentui-react-native/tokens": patch
36+
---
37+
38+
Updating path references to components and design packages

.github/skills/agentic-component-authoring/SKILL.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,24 @@
11
---
22
name: agentic-component-authoring
3-
description: Generate or update Fluent UI React Native components in packages/agentic-components. Use for component APIs, slots, state hooks, token styling, render functions, tests, stories, and spec-driven component work.
3+
description: Generate or update Fluent UI React Native components in packages/agentic/components. Use for component APIs, slots, state hooks, token styling, render functions, tests, stories, and spec-driven component work.
44
license: MIT
55
---
66

77
# Agentic component authoring
88

9-
Build components in `packages/agentic-components` as React Native adaptations of the Fluent UI v9 component pattern.
9+
Build components in `packages/agentic/components` as React Native adaptations of the Fluent UI v9 component pattern.
1010
This skill is the workflow router. Load only the references needed for the current change instead of placing every
1111
authoring rule in one always-loaded instruction file.
1212

1313
## Choose the component kind
1414

1515
- Higher-order components live in `src/components`. Read the
16-
[higher-order component instructions](../../../packages/agentic-components/src/components/AGENTS.md).
16+
[higher-order component instructions](../../../packages/agentic/components/src/components/AGENTS.md).
1717
- Primitive components live in `src/primitives`. Read the
18-
[primitive instructions](../../../packages/agentic-components/src/primitives/AGENTS.md).
18+
[primitive instructions](../../../packages/agentic/components/src/primitives/AGENTS.md).
1919
- If the change spans multiple components, repeated helpers, or shared dependency boundaries, read the
2020
[package-wide optimization guidance](../agentic-component-optimization/SKILL.md) and
21-
[`packages/agentic-components/src/AGENTS.md`](../../../packages/agentic-components/src/AGENTS.md). Do not run a
21+
[`packages/agentic/components/src/AGENTS.md`](../../../packages/agentic/components/src/AGENTS.md). Do not run a
2222
whole-package audit for a tiny single-component edit.
2323
- Work on the Storybook application, native projects, bundling, or CocoaPods belongs to the
2424
[agentic Storybook development skill](../agentic-storybook-development/SKILL.md), not this component workflow.
@@ -44,8 +44,8 @@ its immediate neighbors. Keep the component's colocated `SPEC.md` and companion
4444
spec. Use the package-wide optimization guidance only when the change clearly involves repeated patterns or shared
4545
dependency boundaries.
4646
2. Inspect the closest canonical implementation. Use
47-
[`components/button`](../../../packages/agentic-components/src/components/button) for a styled higher-order component
48-
and [`primitives/icon`](../../../packages/agentic-components/src/primitives/icon) for a direct primitive.
47+
[`components/button`](../../../packages/agentic/components/src/components/button) for a styled higher-order component
48+
and [`primitives/icon`](../../../packages/agentic/components/src/primitives/icon) for a direct primitive.
4949
3. Establish the public contract before implementation: variants, slots, native props, accessibility, interaction
5050
states, and platform behavior.
5151
4. Implement in dependency order: types and slots, state and accessibility, styles and slot props, pure rendering,

.github/skills/agentic-component-authoring/references/rendering.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22

33
Use this reference for `render<Component>.tsx`, `<component>.ts`, slot ordering, conditional structure, display names,
44
and package exports. The canonical examples are
5-
[`renderButton.tsx`](../../../../packages/agentic-components/src/components/button/renderButton.tsx) and
6-
[`button.ts`](../../../../packages/agentic-components/src/components/button/button.ts).
5+
[`renderButton.tsx`](../../../../packages/agentic/components/src/components/button/renderButton.tsx) and
6+
[`button.ts`](../../../../packages/agentic/components/src/components/button/button.ts).
77

88
## Keep render functions pure
99

.github/skills/agentic-component-authoring/references/state-and-accessibility.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Use this reference for `<Component>StateProps`, `use<Component>.ts`, defaults, interaction hooks, accessibility, derived
44
state, and slot construction. The canonical example is
5-
[`useButton.ts`](../../../../packages/agentic-components/src/components/button/useButton.ts).
5+
[`useButton.ts`](../../../../packages/agentic/components/src/components/button/useButton.ts).
66

77
## State hook responsibilities
88

.github/skills/agentic-component-authoring/references/styles-and-tokens.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,13 +2,13 @@
22

33
Use this reference for `<component>.styles.ts`, `use<Component>Styles.ts`, token mapping, theme caching, state precedence, and
44
slot prop application. The canonical examples are
5-
[`button.styles.ts`](../../../../packages/agentic-components/src/components/button/button.styles.ts) and
6-
[`useButtonStyles.ts`](../../../../packages/agentic-components/src/components/button/useButtonStyles.ts).
5+
[`button.styles.ts`](../../../../packages/agentic/components/src/components/button/button.styles.ts) and
6+
[`useButtonStyles.ts`](../../../../packages/agentic/components/src/components/button/useButtonStyles.ts).
77

88
## Resolve values from the correct token source
99

1010
Consult
11-
[`flex-token-map.yaml`](../../../../packages/agentic-design/src/tokens/mappings/flex-token-map.yaml) before choosing a
11+
[`flex-token-map.yaml`](../../../../packages/agentic/design/src/tokens/mappings/flex-token-map.yaml) before choosing a
1212
value.
1313

1414
- Read semantic colors from `useThemeState().tokens.color`.
@@ -35,16 +35,16 @@ Never create a style factory inside a hook or render function.
3535

3636
Reuse the design package's `@fluentui-react-native/design/styling` submodule:
3737

38-
- [`getStateStyleFactory`](../../../../packages/agentic-design/src/styling/branchedStyle.ts) lazily flattens and caches
38+
- [`getStateStyleFactory`](../../../../packages/agentic/design/src/styling/branchedStyle.ts) lazily flattens and caches
3939
one theme-independent state definition.
40-
- [`getThemedStateStyleFactory`](../../../../packages/agentic-design/src/styling/branchedStyle.ts) resolves and caches
40+
- [`getThemedStateStyleFactory`](../../../../packages/agentic/design/src/styling/branchedStyle.ts) resolves and caches
4141
one flattened definition per `ThemeState`.
42-
- [`getThemedColorStyleFactory`](../../../../packages/agentic-design/src/styling/colorStyles.ts) converts semantic
42+
- [`getThemedColorStyleFactory`](../../../../packages/agentic/design/src/styling/colorStyles.ts) converts semantic
4343
color keys and delegates its hierarchy and caching to `getThemedStateStyleFactory`.
4444

4545
These are the canonical Button mechanisms and cache plain resolved style objects in `state.themeStyles`. Do not wrap them
4646
in another `StyleSheet.create` cache. Use
47-
[`themedStyleSheetFactory`](../../../../packages/agentic-design/src/useThemeState.ts) only when a component genuinely
47+
[`themedStyleSheetFactory`](../../../../packages/agentic/design/src/useThemeState.ts) only when a component genuinely
4848
needs a complete theme-only `StyleSheet.create` result that is not represented by a branched state definition.
4949

5050
Every theme factory may depend only on `ThemeState` values such as tokens and high contrast. Props, interaction state,

.github/skills/agentic-component-authoring/references/tests-and-stories.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
# Tests and stories
22

33
Use this reference for runtime coverage, type coverage, visual snapshots, Storybook CSF, and validation. Canonical examples
4-
are [`button.test.tsx`](../../../../packages/agentic-components/src/components/button/button.test.tsx),
5-
[`button.stories.tsx`](../../../../packages/agentic-components/src/components/button/button.stories.tsx), and
6-
[`icon.stories.tsx`](../../../../packages/agentic-components/src/primitives/icon/icon.stories.tsx).
4+
are [`button.test.tsx`](../../../../packages/agentic/components/src/components/button/button.test.tsx),
5+
[`button.stories.tsx`](../../../../packages/agentic/components/src/components/button/button.stories.tsx), and
6+
[`icon.stories.tsx`](../../../../packages/agentic/components/src/primitives/icon/icon.stories.tsx).
77

88
## Runtime tests
99

.github/skills/agentic-component-authoring/references/types-and-slots.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Use this reference when defining or changing a component's public API, slots, resolved state, native prop exposure, or
44
package exports. The canonical higher-order example is
5-
[`button.types.ts`](../../../../packages/agentic-components/src/components/button/button.types.ts).
5+
[`button.types.ts`](../../../../packages/agentic/components/src/components/button/button.types.ts).
66

77
## Separate the public contract from render-only structure
88

@@ -65,13 +65,13 @@ props that no later stage uses.
6565

6666
Primitives should define the smallest slot-compatible acceptance contract. For mutually exclusive sources, use a union
6767
with `never` on incompatible fields, as
68-
[`IconProps`](../../../../packages/agentic-components/src/primitives/icon/icon.types.ts) does for image, font, and SVG
68+
[`IconProps`](../../../../packages/agentic/components/src/primitives/icon/icon.types.ts) does for image, font, and SVG
6969
sources. Verify the primitive remains assignable to `SlotProp<typeof Primitive>` with a committed type test.
7070

7171
## Exports
7272

7373
Export each component and its composition pipeline explicitly from
74-
[`src/index.ts`](../../../../packages/agentic-components/src/index.ts):
74+
[`src/index.ts`](../../../../packages/agentic/components/src/index.ts):
7575

7676
- the component and its public props, slots, variants, and resolved state type
7777
- the state hook as `use<Component>_unstable`

.github/skills/agentic-component-optimization/SKILL.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: agentic-component-optimization
3-
description: Analyze and optimize packages/agentic-components as a whole when repeated patterns, dependency direction, or extraction boundaries cross components.
3+
description: Analyze and optimize packages/agentic/components as a whole when repeated patterns, dependency direction, or extraction boundaries cross components.
44
license: MIT
55
---
66

@@ -12,11 +12,11 @@ primitive or helper should exist at all.
1212

1313
## Read first
1414

15-
1. Read `packages/agentic-components/AGENTS.md` and `packages/agentic-components/src/AGENTS.md`.
15+
1. Read `packages/agentic/components/AGENTS.md` and `packages/agentic/components/src/AGENTS.md`.
1616
2. Read the relevant component or primitive `AGENTS.md` file and the colocated `SPEC.md` files for the affected area.
1717
3. Inspect the canonical implementations:
18-
- `packages/agentic-components/src/components/button`
19-
- `packages/agentic-components/src/primitives/icon`
18+
- `packages/agentic/components/src/components/button`
19+
- `packages/agentic/components/src/primitives/icon`
2020

2121
## Audit checklist
2222

@@ -25,8 +25,8 @@ primitive or helper should exist at all.
2525
- Production source may depend only on React / React Native native components, `@fluentui-react-native/design`, and
2626
`@fluentui-react-native/framework-base`.
2727
- Generalizable non-styling hooks belong in `framework-base/src/hooks`.
28-
- Styling helpers belong in `agentic-design/src/styling`.
29-
- Component-library-specific non-public types, constants, and helpers belong in `packages/agentic-components/src/common`.
28+
- Styling helpers belong in `agentic/design/src/styling`.
29+
- Component-library-specific non-public types, constants, and helpers belong in `packages/agentic/components/src/common`.
3030

3131
### 2. Repetition and ownership
3232

AGENTS.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ This is the **FluentUI React Native** repository, a monorepo containing React Na
4242

4343
**Slots**: The slot pattern is used to compose higher-order components. A slot represents an inner component (actual entry in the render tree). For example, a Button might have slots for `root`, `icon`, and `content`. This allows advanced customization scenarios. Components wrapping a single native component typically have one slot.
4444

45-
**Tokens**: Design tokens handle styling and customization. Tokens are design-time values set via theme or component customization (e.g., "brandColor"). Tokens can also be props (specified via "TokensThatAreAlsoProps"). This system enables simpler customization and better memoization. For Flex token authoring, use `packages/agentic-design/src/tokens/mappings/flex-token-map.yaml` as the canonical mapping from generic CSS and Fluent token sources to grouped React Native Flex token paths. When mapping an agentic component to an existing V1 component, use the Win32, macOS, or Windows implementation as the canonical compatibility reference; do not use iOS as the cross-platform canonical value unless the work explicitly targets iOS.
45+
**Tokens**: Design tokens handle styling and customization. Tokens are design-time values set via theme or component customization (e.g., "brandColor"). Tokens can also be props (specified via "TokensThatAreAlsoProps"). This system enables simpler customization and better memoization. For Flex token authoring, use `packages/agentic/design/src/tokens/mappings/flex-token-map.yaml` as the canonical mapping from generic CSS and Fluent token sources to grouped React Native Flex token paths. When mapping an agentic component to an existing V1 component, use the Win32, macOS, or Windows implementation as the canonical compatibility reference; do not use iOS as the cross-platform canonical value unless the work explicitly targets iOS.
4646

4747
**Theme-specific styles**: Cache `StyleSheet.create` results that depend only on `ThemeState` with a module-scoped getter created by `themedStyleSheetFactory`. Treat them as immutable, and apply props, interaction state, and user styles separately so the cached sheet is safe to share between component instances.
4848

apps/storybook/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
"repository": {
99
"type": "git",
1010
"url": "https://github.com/microsoft/fluentui-react-native.git",
11-
"directory": "packages/agentic-components/storybook"
11+
"directory": "packages/agentic/components/storybook"
1212
},
1313
"scripts": {
1414
"start": "rnx-cli start",

0 commit comments

Comments
 (0)