angular/packages
Alex Rickabaugh 4821239c41 refactor: add g3-only and 3p-only markers to replace specific g3 patches
Replace specific file patches applied during google3 sync with generic comment-based mechanisms.

By adding `// g3-only` prefix comments to g3-specific exports and declarations, and appending `// 3p-only` context to `@internal` tags, we enable generic tooling to handle these modifications during the sync process.

Additionally, wrap 3rd-party-only imports and exports (which should be stripped in google3) with `// 3p-only-start` and `// 3p-only-end` comment markers.

This reduces the need for maintaining custom file-specific patches in google3.

Also, add a comprehensive guide to these sync comment markers in `contributing-docs/google-markers.md` to assist external contributors.

Specifically:
- Add `// 3p-only` context to `@internal` in `directives.ts` for `foreignImports` and `deferredImports`.
- Add `// g3-only` commented exports in `core.ts`.
- Add `// g3-only-start`/`// g3-only-end` commented global declaration block in `zone.ts`.
- Wrap 3p-only imports in `fake_navigation.ts` with `// 3p-only-start` and `// 3p-only-end`.
- Wrap 3p-only exports in `compiler-cli/index.ts` with `// 3p-only-start` and `// 3p-only-end`.
- Add `// g3-only` and `// 3p-only` markers to `shared.ts` for `setDisabledStateDefault` configuration.
- Add `// g3-only` and `// 3p-only` markers to `feature_detection.ts` for semver dependency.
- Add `// g3-only` and `// 3p-only` markers to `domino_adapter.ts` for domino import path.
- Add `// 3p-only` marker to `ng_dev_mode` import in `event_dispatcher.ts`.
- Add `// g3-only` and `// 3p-only` markers to `MOUSE_SPECIAL_SUPPORT` in `event_contract_defines.ts`.
- Add `// g3-only` and `// 3p-only` markers to `BrowserModule` imports in `module.ts` (animations) and `browser.ts` (testing).
- Add `// 3p-only` marker to `goog.d.ts` reference tags in `util.ts` (platform-browser), `types.d.ts`, `ng_i18n_closure_mode.ts`, `tokens.ts`, and `global_utils.ts`.
- Wrap `Default` enum value of `ChangeDetectionStrategy` in `constants.ts` with `// 3p-only-start` and `// 3p-only-end`.
- Add `// g3-only` and `// 3p-only` markers to `LEGACY_OPTIONAL_CHAINING_DEFAULT` in `legacy_optional_chaining_default.ts` and `legacyOptionalChaining` in `directive.ts`.
- Add `// g3-only` and `// 3p-only` markers to `DEFAULT_PARAMS_INHERITANCE_STRATEGY` in `router_state.ts`.
- Add `// g3-only` and `// 3p-only` (and block variants) markers to `@mcp-b/webmcp-types` imports in `declare_tool.ts`, `provide_tools.ts`, and `types.ts`.
- Add `contributing-docs/google-markers.md` guide.

TAG=agy
CONV=cd09a4f3-869a-4f41-949b-c91f1b8f1c51
2026-05-22 16:22:35 -07:00
..
animations refactor(core): use the @Service decorator where possible. 2026-05-07 17:03:30 -06:00
benchpress build: update cross-repo angular dependencies 2026-03-05 11:43:25 -08:00
common refactor(http): update HTTP resource options APIs to stable 2026-05-12 10:48:03 -07:00
compiler refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
compiler-cli refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
core refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
docs/di build: format md files 2025-11-06 10:03:05 -08:00
elements feat(compiler-cli): add support for Node.js 26.0.0 2026-05-06 09:55:38 -07:00
examples test(upgrade): exclude unit test files from E2E application sources 2026-05-19 12:57:48 -07:00
forms refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
language-service fix(compiler): type check invalid for loops 2026-05-13 11:26:42 -07:00
localize feat(compiler-cli): add support for Node.js 26.0.0 2026-05-06 09:55:38 -07:00
misc/angular-in-memory-web-api docs: normalize product name casing across docs 2026-05-07 16:09:44 -06:00
platform-browser refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
platform-browser-dynamic feat(compiler-cli): add support for Node.js 26.0.0 2026-05-06 09:55:38 -07:00
platform-server refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
private/testing build: consolidate domino bundling in platform-server 2026-03-25 13:31:05 -07:00
router refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
service-worker feat(compiler-cli): add support for Node.js 26.0.0 2026-05-06 09:55:38 -07:00
ssr/docs build: add node type for api extraction 2026-02-11 13:57:58 -08:00
upgrade feat(compiler-cli): add support for Node.js 26.0.0 2026-05-06 09:55:38 -07:00
zone.js refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00
BUILD.bazel refactor(platform-browser): remove Hammer integration 2026-03-19 16:13:20 -07:00
circular-deps-test.conf.cjs build: use Node.js built-in TypeScript support for dev-infra scripts 2026-01-02 08:15:40 +01:00
empty.ts refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
goog.d.ts refactor: update license text to point to angular.dev (#57901) 2024-09-24 15:33:00 +02:00
license-banner.txt docs: update copyright year 2026-01-07 12:28:34 -05:00
package.json build: prepare for compiler-cli to be using ts_project (#61181) 2025-05-09 15:59:46 +00:00
README.md build: format md files 2025-11-06 10:03:05 -08:00
system.d.ts refactor: update packages/core:{core,src} to ts_project (#61275) 2025-05-14 12:01:51 +00:00
tsconfig-build.json Revert "refactor(compiler-cli): remove deep imports from compiler-cli (#64732)" 2025-11-06 13:09:01 -08:00
tsconfig-legacy-saucelabs.json ci: remove remainings of saucelabs tests 2026-04-22 14:41:03 -07:00
tsconfig-test.json
tsconfig.json feat(compiler-cli): enable type checking of host bindings by default (#63654) 2025-09-09 14:34:29 -07:00
tsec-exemption.json
types.d.ts refactor: add g3-only and 3p-only markers to replace specific g3 patches 2026-05-22 16:22:35 -07:00

Angular

The sources for this package are in the main Angular repo. Please file issues and pull requests against that repo.

Usage information and reference details can be found in Angular documentation.

License: MIT