firebase-contract 0.1.0-rc.5 → 0.1.0-rc.6

package/README.md

@@ -32,36 +32,49 @@ Provides the `firebase-contract` (alias `fbc`) CLI and a programmatic API.
 ```bash
 fbc init          # scaffold contract.yml + firebase-contract.json
 fbc validate      # parse, resolve imports, semantically validate
-fbc generate      # run every `generate:` target declared in the contract graph
+fbc generate      # run every generator declared across the contract graph
 fbc inspect       # print the normalized IR (debugging)
 ```
 
 ### One-command generation
 
-Each contract file can declare its own outputs in a `generate:` section —
-out dirs are relative to that yml file:
-
-```yaml
-# apps/shop/data-connect/schema.yml
-generate:
-  - { out: src, generators: [data-connect-graphql-split] }
-  - { out: ., generators: [sql-migrations] }
-```
+Each contract file declares the generators it uses in a top-level
+`generators:` block — a name plus an output template. Declaring a
+**document-scoped** generator (typescript-split, zod-split, …) runs it once for
+that yml; **api-scoped** generators (api-types, api-validation, api-dto,
+task-payloads) run for the entries that opt in (see below):
 
 ```yaml
 # contract.yml (root)
-generate:
-  - out: libs/contracts/src
-    generators: [typescript-split, zod-split, firestore-split, id-codecs]
+project:
+  aliases:
+    "#contracts/*": libs/contracts/src/*   # out templates may target aliases
+generators:
+  - { generator: typescript-split, out: "#contracts" }
+  - { generator: api-types, out: "#contracts/api-types/{api-name}" }
 imports:
   - ./apps/shop/data-connect/schema.yml
 ```
 
-`fbc generate contract.yml` then materializes **all** targets across the whole
-import graph in one run. Passing `-o`/`-g` switches to single-target mode
+```yaml
+# apps/shop/data-connect/schema.yml
+generators:
+  - { generator: data-connect-graphql-split, out: src }
+  - { generator: sql-migrations, out: . }
+```
+
+- `out` resolves relative to the declaring yml; `#alias/...` prefixes resolve
+  through the **root** yml's `project.aliases` (relative to the root).
+- Api-scoped templates may use `{api-name}` (kebab-cased name) and `{path}`
+  (REST path with `{param}` segments dropped).
+- Entries reference declarations by name — nearest first (same yml → root).
+
+`fbc generate contract.yml` materializes **all** declared outputs across the
+whole import graph in one run. Passing `-o`/`-g` switches to single-target mode
 (`fbc generate <entry> -o <dir> -g typescript,zod`), and
 `firebase-contract.json` (`entry`, `outDir`, `generators`) can hold defaults.
 
+
 ### Generated-file headers
 
 By default no banner is emitted. Opt in per run or per contract:
@@ -162,24 +175,24 @@ models:
 
 | option                              | meaning                                                  |
 | ----------------------------------- | -------------------------------------------------------- |
-| `type`                              | scalar name, or an enum/model name                       |
-| `optional`                          | value may be absent (`field?`)                           |
-| `list`                              | value is an array of `type`                              |
-| `id`                                | marks the (single) primary identifier                    |
-| `unique`                            | field-level unique → `@unique`                           |
-| `relation`                          | model-typed field is a foreign-key relation (see below)  |
-| `col`                               | Data Connect column dataType (Int64 PKs default to `bigserial`) |
-| `default`                           | `@default(expr: …)` on the DC column                     |
-| `literal`                           | pin to one literal value (union discriminant tags)       |
-| `nullable`                          | value may be `null` (`.nullable()` / `\| null`)          |
-| `description`                       | doc comment carried into generated output                |
-| `jsdoc`                             | render the description as a JSDoc block (Firestore fields) |
+| `type`                              | document | scalar name, or an enum/model name                       |
+| `optional`                          | document | value may be absent (`field?`)                           |
+| `list`                              | document | value is an array of `type`                              |
+| `id`                                | document | marks the (single) primary identifier                    |
+| `unique`                            | document | field-level unique → `@unique`                           |
+| `relation`                          | document | model-typed field is a foreign-key relation (see below)  |
+| `col`                               | document | Data Connect column dataType (Int64 PKs default to `bigserial`) |
+| `default`                           | document | `@default(expr: …)` on the DC column                     |
+| `literal`                           | document | pin to one literal value (union discriminant tags)       |
+| `nullable`                          | document | value may be `null` (`.nullable()` / `\| null`)          |
+| `description`                       | document | doc comment carried into generated output                |
+| `jsdoc`                             | document | render the description as a JSDoc block (Firestore fields) |
 | **constraints** →                   |                                                          |
-| `min` / `max`                       | numeric bounds                                           |
-| `minLength` / `maxLength`           | string/array length bounds                               |
-| `nonempty`                          | non-empty string/array                                   |
-| `pattern`                           | regex the string must match                              |
-| `email` / `url`                     | string format                                            |
+| `min` / `max`                       | document | numeric bounds                                           |
+| `minLength` / `maxLength`           | document | string/array length bounds                               |
+| `nonempty`                          | document | non-empty string/array                                   |
+| `pattern`                           | document | regex the string must match                              |
+| `email` / `url`                     | document | string format                                            |
 
 Constraints flow into the Zod schemas, the API request validation, and the
 class-validator DTOs.
@@ -188,14 +201,14 @@ class-validator DTOs.
 
 | option       | meaning                                                             |
 | ------------ | ------------------------------------------------------------------ |
-| `key`        | composite primary key field names (else the `id: true` field)      |
-| `table`      | table name override (default: snake_case pluralization)            |
-| `gqlName`    | GraphQL type name override                                          |
-| `fsName`     | Firestore-side rename (avoid collisions with table models)          |
-| `directives` | `multi` = each type-level directive on its own line                 |
-| `footer`     | trailing comment block after the closing `}` in the schema file     |
-| `indexes`    | composite `@index`/`@unique` (`{ fields, name?, unique?, expand? }` — `expand` renders args one per line) |
-| `sql`        | raw SQL constraints (see [SQL migrations](#sql-migrations))         |
+| `key`        | document | composite primary key field names (else the `id: true` field)      |
+| `table`      | document | table name override (default: snake_case pluralization)            |
+| `gqlName`    | document | GraphQL type name override                                          |
+| `fsName`     | document | Firestore-side rename (avoid collisions with table models)          |
+| `directives` | document | `multi` = each type-level directive on its own line                 |
+| `footer`     | document | trailing comment block after the closing `}` in the schema file     |
+| `indexes`    | document | composite `@index`/`@unique` (`{ fields, name?, unique?, expand? }` — `expand` renders args one per line) |
+| `sql`        | document | raw SQL constraints (see [SQL migrations](#sql-migrations))         |
 
 ### Embedded vs relation
 
@@ -273,14 +286,14 @@ Everything below exists to reproduce real hand-written `.gql` files byte-for-byt
 
 | option | meaning |
 | --- | --- |
-| `gqlName` | rendered operation name (the yml key stays unique across services) |
-| `footer` | trailing `# …` comment block after the operation |
-| `raw` | emit the operation body verbatim (multi-model queries, `_or` keyset cursors — field checks are skipped) |
-| `single: id \| key` | single-row lookup (`product(id: $id)` / `product(key: { … })`) |
-| `keyArg` / `keyVars` | update/delete key argument form and variable renames |
-| `whereAnd: true` | render conditions as an `_and: [ … ]` array |
-| `entityDir` | override the `operations/<entity>/` output directory |
-| `style` | formatting hints: `signature`, `args`, `data`, `orderBy`, `auth`, `key`, `and`, `where` (`inline`/`multi`/`compact`/`bare`) |
+| `gqlName` | document | rendered operation name (the yml key stays unique across services) |
+| `footer` | document | trailing `# …` comment block after the operation |
+| `raw` | document | emit the operation body verbatim (multi-model queries, `_or` keyset cursors — field checks are skipped) |
+| `single: id \| document | key` | single-row lookup (`product(id: $id)` / `product(key: { … })`) |
+| `keyArg` / `keyVars` | document | update/delete key argument form and variable renames |
+| `whereAnd: true` | document | render conditions as an `_and: [ … ]` array |
+| `entityDir` | document | override the `operations/<entity>/` output directory |
+| `style` | document | formatting hints: `signature`, `args`, `data`, `orderBy`, `auth`, `key`, `and`, `where` (`inline`/`multi`/`compact`/`bare`) |
 
 Inputs support `var` (variable rename), `required` (override optionality),
 `literal` (fixed value, no variable), `flat` (write the FK column directly),
@@ -296,11 +309,13 @@ name as long as their connector sets don't overlap.
 
 ## API endpoints
 
-Model application endpoints (Cloud Task / callable / https / pubsub). Generates
-request/response types (`api-types`), request-validation Zod (`api-validation`),
-class-validator DTOs (`api-dto`), and — for `task`/`pubsub` — payload contracts
-(`task-payloads`). A payload references a model or declares inline fields; a void
-response maps to `void`.
+Model application endpoints in three kind-implied sections — `apis:` (https /
+callable, keyed by REST path), `tasks:` (Cloud Tasks), and `events:` (Pub/Sub).
+The api-scoped generators — request/response types (`api-types`),
+request-validation Zod (`api-validation`), class-validator DTOs (`api-dto`),
+and payload contracts (`task-payloads`) — run for the entries that opt in via
+the section `defaults` or the entry's own `generators:`. A payload references a
+model or declares inline fields; a void response maps to `void`.
 
 ```yaml
 envelopes:
@@ -310,9 +325,10 @@ envelopes:
       opId: string
       enqueuedAt: int
 
-apis:
+tasks:                                     # Cloud Tasks (kind implied)
+  defaults:
+    generators: [task-payloads]            # section default: applies to entries below
   createCatalog:
-    kind: task                             # product | callable | https | pubsub
     envelope: RetryTaskPayload             # wraps the product data
     maxAttempts: 3
     request:
@@ -322,17 +338,31 @@ apis:
     response:
       void: true
 
+events:                                    # Pub/Sub (kind implied)
   generateAiResponse:
-    kind: pubsub
     topic: ai-review-generate-response
     timeoutSeconds: 540
-
-  getShopBySlug:
-    kind: callable
+    generators: [task-payloads]
+
+apis:                                      # https/callable, keyed by REST path
+  defaults:
+    generators: [api-types, api-validation]
+  /shops/{slug}:
+    operationId: getShopBySlug
+    kind: callable                         # https (default) | callable
     request: { fields: { slug: { type: string, nonempty: true } } }
     response: { model: Shop }
+    generators:                            # entry-level wins over section defaults;
+      - api-types                          # an inline out overrides the declared template
+      - { generator: api-dto, out: "src/entries/{path}" }
 ```
 
+Generator application resolves in two tiers — the section `defaults`
+(`apis:/tasks:/events:` → `defaults.generators`) and the entry's own
+`generators:` (which replaces the defaults). `apis:` keys must be REST paths
+(`/...`) with an `operationId`; tasks and Pub/Sub events live in their own
+sections.
+
 For `createCatalog` this yields `CreateCatalogTaskData`, `CreateCatalogTaskPayload =
 RetryTaskPayload<CreateCatalogTaskData>`, and `CREATE_CATALOG_MAX_ATTEMPTS`, plus the
 request types, Zod schema, and DTO.
@@ -446,6 +476,8 @@ project:
   idCodec:
     minLength: 8
     alphabet: <your-shuffled-sqids-alphabet>
+  aliases:
+    "#contracts/*": libs/contracts/src/*
 ```
 
 - `services` (`name`/`database`) feed the `FIRESTORE_DATABASES` constants in the
@@ -454,6 +486,9 @@ project:
   `id-codecs` generator also emits a self-contained `id-core.ts` (the
   encode/decode primitives), so nothing about id encoding lives outside the
   contract.
+- `aliases` maps `#alias/...` out-template prefixes to paths relative to the
+  **root** yml, so imported contracts can target shared libs without relative
+  path gymnastics (longest prefix wins).
 - `codebases` / service `location` + `connectors` are consumed by the optional
   `config` generator (preview), which emits per-service `dataconnect.yaml`,
   per-connector `connector.yaml`, and the `FIRESTORE_DATABASES` /
@@ -465,32 +500,37 @@ project:
 
 # Generators
 
-| name                     | output                        | notes                                                  |
-| ------------------------ | ----------------------------- | ------------------------------------------------------ |
-| `typescript`             | `types.ts`                    | interfaces + const/union enums                         |
-| `typescript-split`       | `types/<table>.ts` + `types.ts` barrel | one file per table; enums/embedded objects co-located |
-| `zod`                    | `schemas.ts`                  | `z.object` schemas (constraints, `z.lazy` model refs)  |
-| `zod-split`              | `schemas/<table>.ts` + `schemas.ts` barrel | split variant of `zod`                    |
-| `data-connect-graphql`   | `schema.gql`                  | `type … @table(name, key)`; `@col`/`@unique`/`@index`/`@default` |
-| `data-connect-graphql-split` | `schema/<table>.gql`     | same schema, one file per table (enums co-located) |
-| `data-connect-operations`| `<connector>/operations.gql` + `.ts` | queries/mutations (where ops, orderBy, limit, aggregate, exprs, inc), per connector |
-| `data-connect-operations-split` | `<connector>/operations/<entity>/{queries,mutations}.gql` | real Data Connect repo layout; shared types stay in `typescript`/`zod` outputs |
-| `data-connect-adapter`   | `data-connect-adapters.ts`    | convert `Any` rows ⇄ logical types                     |
-| `firestore-types`        | `firestore-types.ts`          | naive TS types with Firestore `Timestamp` (all models) |
-| `firestore`              | `firestore.ts`                | Firestore projection Zod schemas (derived, denormalized) |
-| `firestore-split`        | `firestore/<collection>.ts` + `firestore.ts` barrel | one file per projection; `_meta_` under `firestore/_/`; DC-schema `.pick()` reuse; `FIRESTORE_DATABASES` constants in the barrel |
-| `api-types`              | `api-types.ts`                | endpoint request/response types                        |
-| `api-validation`         | `api-validation.ts`           | endpoint request-validation Zod                        |
-| `api-dto`                | `api-dtos.ts`                 | class-validator DTO classes                            |
-| `task-payloads`          | `task-payloads.ts`            | envelopes + `*TaskData`/`*TaskPayload` + constants     |
-| `sql-migrations`         | `migrations/constraints.sql`  | composite FK / CHECK / index SQL                       |
-| `id-codecs`              | `id-codecs.ts` (+ `id-core.ts`) | typed per-entity id encode/decode wrappers; emits the Sqids primitives when `project.idCodec` is set |
-| `unions`                 | `unions.ts`                   | Zod discriminated unions + TS union types              |
-| `config`                 | `dataconnect.yaml`, `connector.yaml`, `constants.ts` | DC configs + sync constants (preview — see [Project config](#project-config)) |
+| name                     | scope    | output                        | notes                                                  |
+| ------------------------ | -------- | ----------------------------- | ------------------------------------------------------ |
+| `typescript`             | document | `types.ts`                    | interfaces + const/union enums                         |
+| `typescript-split`       | document | `types/<table>.ts` + `types.ts` barrel | one file per table; enums/embedded objects co-located |
+| `zod`                    | document | `schemas.ts`                  | `z.object` schemas (constraints, `z.lazy` model refs)  |
+| `zod-split`              | document | `schemas/<table>.ts` + `schemas.ts` barrel | split variant of `zod`                    |
+| `data-connect-graphql`   | document | `schema.gql`                  | `type … @table(name, key)`; `@col`/`@unique`/`@index`/`@default` |
+| `data-connect-graphql-split` | document | `schema/<table>.gql`     | same schema, one file per table (enums co-located) |
+| `data-connect-operations`| document | `<connector>/operations.gql` + `.ts` | queries/mutations (where ops, orderBy, limit, aggregate, exprs, inc), per connector |
+| `data-connect-operations-split` | document | `<connector>/operations/<entity>/{queries,mutations}.gql` | real Data Connect repo layout; shared types stay in `typescript`/`zod` outputs |
+| `data-connect-adapter`   | document | `data-connect-adapters.ts`    | convert `Any` rows ⇄ logical types                     |
+| `firestore-types`        | document | `firestore-types.ts`          | naive TS types with Firestore `Timestamp` (all models) |
+| `firestore`              | document | `firestore.ts`                | Firestore projection Zod schemas (derived, denormalized) |
+| `firestore-split`        | document | `firestore/<collection>.ts` + `firestore.ts` barrel | one file per projection; `_meta_` under `firestore/_/`; DC-schema `.pick()` reuse; `FIRESTORE_DATABASES` constants in the barrel |
+| `api-types`              | api | `api-types.ts`                | endpoint request/response types                        |
+| `api-validation`         | api | `api-validation.ts`           | endpoint request-validation Zod                        |
+| `api-dto`                | api | `api-dtos.ts`                 | class-validator DTO classes                            |
+| `task-payloads`          | api | `task-payloads.ts`            | envelopes + `*TaskData`/`*TaskPayload` + constants     |
+| `sql-migrations`         | document | `migrations/constraints.sql`  | composite FK / CHECK / index SQL                       |
+| `id-codecs`              | document | `id-codecs.ts` (+ `id-core.ts`) | typed per-entity id encode/decode wrappers; emits the Sqids primitives when `project.idCodec` is set |
+| `unions`                 | document | `unions.ts`                   | Zod discriminated unions + TS union types              |
+| `config`                 | document | `dataconnect.yaml`, `connector.yaml`, `constants.ts` | DC configs + sync constants (preview — see [Project config](#project-config)) |
 
 Each generator emits nothing when its section is absent, so a small contract
 produces a small output. Select a subset with `-g`.
 
+**Scope** decides how a `generators:` declaration takes effect: `document`
+generators run once for the yml that declares them; `api` generators run only
+for the entries that apply them (section `defaults.generators` → entry
+`generators:`, entry wins).
+
 ### The `Any` boundary
 
 Data Connect stores JSON and embedded objects as the `Any` scalar, erasing the
@@ -518,7 +558,7 @@ const result = generate('contract.yml', {
   write: true,
 })
 
-// Every `generate:` target declared across the import graph:
+// Every generator declared across the import graph:
 const all = generateAll('contract.yml', { write: true })
 ```
 

package/dist/lib/_internal/compiler/compiler.d.ts

@@ -43,10 +43,11 @@ export interface GenerateAllResult {
     ok: boolean;
 }
 /**
- * Run every `generate:` target declared across the entry contract and its
- * (transitive) imports — the one-command flow: each contract file states where
- * its own outputs go, and `fbc generate <root>` materializes all of them.
- * Output dirs resolve relative to the declaring yml file.
+ * Run every generator declared across the entry contract and its (transitive)
+ * imports — the one-command flow: each contract file declares its generators
+ * (`generators:` + section defaults / entry applications) and
+ * `fbc generate <root>` materializes all of them. Output dirs resolve relative
+ * to the declaring yml (or the root yml for `#alias/...` templates).
  */
 export declare const generateAll: (entryPath: string, options?: {
     registry?: GeneratorRegistry;

package/dist/lib/_internal/compiler/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/compiler/compiler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAkB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAE5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,aAUzE,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,EAAE,EAAE,OAAO,CAAA;CACZ;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,UAAS;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAO,KACjH,iBA8BF,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,aAAa,EAAE,KAAG,SAUlD,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,EAAE,CAAA;IACN,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,oFAAoF;IACpF,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,0DAA0D;IAC1D,EAAE,EAAE,OAAO,CAAA;CACZ;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,SAAS,eAAe,KAAG,cAuCtE,CAAA"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/compiler/compiler.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAoB,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAChC,OAAO,EAAU,WAAW,EAAqC,MAAM,2BAA2B,CAAA;AAElG,OAAO,EAAkB,YAAY,EAAE,MAAM,8BAA8B,CAAA;AAG3E,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAG5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,WAAW,cAAc;IAC7B,6DAA6D;IAC7D,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,SAAS,EAAE,WAAW,EAAE,CAAA;IACxB,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,MAAM,EAAE,UAAS,cAAmB,KAAG,aAUzE,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,cAAc;IACrD,MAAM,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,iBAAiB,CAAA;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,KAAK,EAAE,aAAa,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,oBAAoB,EAAE,CAAA;IAC/B,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,EAAE,EAAE,OAAO,CAAA;CACZ;AAwJD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACtB,WAAW,MAAM,EACjB,UAAS;IAAE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,YAAY,CAAA;CAAO,KACjH,iBA0CF,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,aAAa,EAAE,KAAG,SAUlD,CAAA;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,EAAE,CAAA;IACN,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,oFAAoF;IACpF,KAAK,EAAE,aAAa,EAAE,CAAA;IACtB,0DAA0D;IAC1D,EAAE,EAAE,OAAO,CAAA;CACZ;AAED;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAW,MAAM,EAAE,SAAS,eAAe,KAAG,cAuCtE,CAAA"}

package/dist/lib/_internal/compiler/compiler.js

@@ -7,6 +7,7 @@ import { createFsLoader } from '../resolver/module-loader.js';
 import { validateIr } from '../validation/validate.js';
 import { createDefaultRegistry } from '../generators/index.js';
 import { toHeaderComment } from '../generators/support/header.js';
+import { kebabCase } from '../generators/support/naming.js';
 /**
  * Run the front end of the pipeline: resolve imports, build the IR, and run
  * semantic validation. Generators are intentionally not involved here — the CLI
@@ -24,11 +25,125 @@ export const compile = (entryPath, options = {}) => {
         diagnostics: [...importDiagnostics, ...buildDiagnostics, ...validationDiagnostics],
     };
 };
+const OUT_PLACEHOLDER_RE = /\{(api-name|path)\}/;
+/** `apis:/tasks:/events:` section a raw api belongs to (drives the section defaults lookup). */
+const sectionOf = (api) => {
+    if (api.kind === 'task')
+        return 'tasks';
+    if (api.kind === 'pubsub')
+        return 'events';
+    return 'apis';
+};
+/** Drop `{param}` segments from a REST path and join the rest (`/ai-models/{id}` → `ai-models`). */
+const pathSegments = (apiPath) => apiPath
+    .split('/')
+    .filter(segment => segment.length > 0 && !(segment.startsWith('{') && segment.endsWith('}')))
+    .join('/');
+const expandOutTemplate = (template, api, diagnostics, source) => {
+    if (!OUT_PLACEHOLDER_RE.test(template))
+        return template;
+    if (!api) {
+        diagnostics.push(error('INVALID_OUT_TEMPLATE', `"${template}" uses api placeholders but the generator is document-scoped (${source})`));
+        return undefined;
+    }
+    let out = template.replaceAll('{api-name}', kebabCase(api.name));
+    if (out.includes('{path}')) {
+        if (!api.path) {
+            diagnostics.push(error('INVALID_OUT_TEMPLATE', `"${template}" uses {path} but api "${api.name}" has no REST path (${source})`));
+            return undefined;
+        }
+        out = out.replaceAll('{path}', pathSegments(api.path));
+    }
+    return out;
+};
+/**
+ * Resolve an out template to an absolute directory. `#alias/...` prefixes are
+ * matched against the root document's `project.aliases` (longest prefix wins)
+ * and resolve relative to the root yml; everything else resolves relative to
+ * the declaring yml — same as the legacy `generate:` form.
+ */
+const resolveOutDir = (out, declaringDoc, rootDoc, diagnostics) => {
+    if (!out.startsWith('#')) {
+        return join(dirname(declaringDoc.filePath), out);
+    }
+    const aliases = rootDoc.project?.aliases ?? {};
+    const candidates = Object.entries(aliases)
+        .map(([pattern, target]) => ({ prefix: pattern.endsWith('/*') ? pattern.slice(0, -2) : pattern, pattern, target }))
+        .filter(({ prefix }) => out === prefix || out.startsWith(`${prefix}/`))
+        .sort((a, b) => b.prefix.length - a.prefix.length);
+    const match = candidates[0];
+    if (!match) {
+        diagnostics.push(error('UNKNOWN_ALIAS', `No project.aliases entry matches "${out}" (declare it in the root contract)`));
+        return undefined;
+    }
+    const rest = out.slice(match.prefix.length).replace(/^\//, '');
+    const targetBase = match.target.endsWith('/*') ? match.target.slice(0, -2) : match.target;
+    return join(dirname(rootDoc.filePath), targetBase, rest);
+};
+/** Find a generator declaration by name — nearest first: the declaring yml, then the root yml. */
+const findGeneratorDecl = (name, doc, rootDoc) => doc.generatorDecls?.find(decl => decl.generator === name) ??
+    rootDoc.generatorDecls?.find(decl => decl.generator === name);
+/**
+ * Build generator jobs from the declaration/application DSL:
+ * - api-scoped generators run for entries that opt in (section `defaults` →
+ *   entry `generators:`, entry wins; no file-level tier by design)
+ * - document-scoped generators run once per yml that declares them
+ */
+const buildGeneratorJobs = (doc, rootDoc, registry, diagnostics) => {
+    const jobs = [];
+    const grouped = new Map();
+    for (const [apiName, rawApi] of Object.entries(doc.apis)) {
+        const uses = rawApi.generators ?? doc.sectionDefaults?.[sectionOf(rawApi)];
+        for (const use of uses ?? []) {
+            const decl = findGeneratorDecl(use.generator, doc, rootDoc);
+            const template = use.out ?? decl?.out;
+            if (template === undefined) {
+                diagnostics.push(error('UNKNOWN_GENERATOR_DECL', `Api "${apiName}" applies generator "${use.generator}" but no declaration with an "out" was found (${doc.filePath})`));
+                continue;
+            }
+            const api = { name: apiName, ...(rawApi.path !== undefined ? { path: rawApi.path } : {}) };
+            const expanded = expandOutTemplate(template, api, diagnostics, doc.filePath);
+            if (expanded === undefined)
+                continue;
+            const outDir = resolveOutDir(expanded, doc, rootDoc, diagnostics);
+            if (outDir === undefined)
+                continue;
+            const key = `${use.generator}\u0000${outDir}`;
+            const existing = grouped.get(key);
+            if (existing) {
+                existing.apiNames?.push(apiName);
+            }
+            else {
+                const job = { source: doc.filePath, generatorName: use.generator, outDir, apiNames: [apiName] };
+                grouped.set(key, job);
+                jobs.push(job);
+            }
+        }
+    }
+    for (const decl of doc.generatorDecls ?? []) {
+        const generator = registry.get(decl.generator);
+        if (!generator) {
+            diagnostics.push(error('UNKNOWN_GENERATOR', `Unknown generator "${decl.generator}" (${doc.filePath})`));
+            continue;
+        }
+        if ((generator.scope ?? 'document') === 'api')
+            continue; // applied via entries, not by declaration
+        const expanded = expandOutTemplate(decl.out, undefined, diagnostics, doc.filePath);
+        if (expanded === undefined)
+            continue;
+        const outDir = resolveOutDir(expanded, doc, rootDoc, diagnostics);
+        if (outDir === undefined)
+            continue;
+        jobs.push({ source: doc.filePath, generatorName: decl.generator, outDir });
+    }
+    return jobs;
+};
 /**
- * Run every `generate:` target declared across the entry contract and its
- * (transitive) imports — the one-command flow: each contract file states where
- * its own outputs go, and `fbc generate <root>` materializes all of them.
- * Output dirs resolve relative to the declaring yml file.
+ * Run every generator declared across the entry contract and its (transitive)
+ * imports — the one-command flow: each contract file declares its generators
+ * (`generators:` + section defaults / entry applications) and
+ * `fbc generate <root>` materializes all of them. Output dirs resolve relative
+ * to the declaring yml (or the root yml for `#alias/...` templates).
  */
 export const generateAll = (entryPath, options = {}) => {
     const { documents, diagnostics } = compile(entryPath, options);
@@ -38,27 +153,40 @@ export const generateAll = (entryPath, options = {}) => {
     const collected = [...diagnostics];
     const targets = [];
     let ok = true;
-    for (const doc of documents) {
-        for (const output of doc.outputs ?? []) {
-            const outDir = join(dirname(doc.filePath), output.out);
-            const result = generate(doc.filePath, {
-                outDir,
-                generators: output.generators,
-                registry: options.registry,
-                write: options.write,
-                ...(options.context ? { context: options.context } : {}),
-                ...(options.loader ? { loader: options.loader } : {}),
-            });
-            // Per-target compiles revisit shared imports; keep only new diagnostics.
-            for (const diagnostic of result.diagnostics) {
-                if (!collected.some(d => d.code === diagnostic.code && d.message === diagnostic.message)) {
-                    collected.push(diagnostic);
-                }
+    const registry = options.registry ?? createDefaultRegistry();
+    // Import order puts dependencies first, so the entry (root) document is last.
+    const rootDoc = documents[documents.length - 1];
+    const mergeDiagnostics = (incoming) => {
+        // Per-target compiles revisit shared imports; keep only new diagnostics.
+        for (const diagnostic of incoming) {
+            if (!collected.some(d => d.code === diagnostic.code && d.message === diagnostic.message)) {
+                collected.push(diagnostic);
             }
-            if (!result.ok)
-                ok = false;
-            targets.push({ source: doc.filePath, outDir, generators: output.generators, files: result.files });
         }
+    };
+    const runTarget = (doc, outDir, generators, apiNames) => {
+        const result = generate(doc.filePath, {
+            outDir,
+            generators,
+            registry,
+            write: options.write,
+            context: { ...options.context, ...(apiNames ? { apiNames } : {}) },
+            ...(options.loader ? { loader: options.loader } : {}),
+        });
+        mergeDiagnostics(result.diagnostics);
+        if (!result.ok)
+            ok = false;
+        targets.push({ source: doc.filePath, outDir, generators, files: result.files });
+    };
+    for (const doc of documents) {
+        // Declaration/application DSL (`generators:` + section defaults / entry `generators:`).
+        const jobDiagnostics = [];
+        for (const job of buildGeneratorJobs(doc, rootDoc, registry, jobDiagnostics)) {
+            runTarget(doc, job.outDir, [job.generatorName], job.apiNames);
+        }
+        mergeDiagnostics(jobDiagnostics);
+        if (hasErrors(jobDiagnostics))
+            ok = false;
     }
     return { targets, diagnostics: collected, ok };
 };

package/dist/lib/_internal/generators/api/api-dto-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-dto-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-dto-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA0G5E;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,SAkBvC,CAAA"}
+{"version":3,"file":"api-dto-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-dto-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AA0GxF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAO,SAmBvC,CAAA"}

package/dist/lib/_internal/generators/api/api-dto-generator.js

@@ -1,6 +1,7 @@
 import { findModel } from '../../ir/ir.js';
 import { pascalCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName } from '../support/relations.js';
+import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
 const SCALAR_TS = {
     string: 'string',
@@ -127,10 +128,11 @@ const renderDto = (ir, api, used) => {
  */
 export const createApiDtoGenerator = () => ({
     name: 'api-dto',
+    scope: 'api',
     description: 'class-validator DTO classes for API requests',
     generate(ir, context) {
         // DTO は HTTP リクエストボディ用 — task / pubsub のペイロードは task-payloads が担う。
-        const httpApis = ir.apis.filter(api => api.kind === 'https' || api.kind === 'callable');
+        const httpApis = selectApis(ir.apis, context).filter(api => api.kind === 'https' || api.kind === 'callable');
         if (httpApis.length === 0) {
             return [];
         }

package/dist/lib/_internal/generators/api/api-types-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-types-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-types-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AA8E5E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAO,SAwBzC,CAAA"}
+{"version":3,"file":"api-types-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-types-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AA8ExF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QAAO,SA0BzC,CAAA"}

package/dist/lib/_internal/generators/api/api-types-generator.js

@@ -1,5 +1,6 @@
 import { pascalCase } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
+import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
 const SCALAR_TS = {
     string: 'string',
@@ -48,7 +49,7 @@ const renderPayloadType = (ir, payload, typeName) => {
     const fields = payload.fields.map(field => renderField(ir, field)).join('\n');
     return `export interface ${typeName} {\n${fields}\n}`;
 };
-const collectImports = (ir) => {
+const collectImports = (ir, apis) => {
     const names = new Set();
     const add = (payload) => {
         if (payload.model)
@@ -62,7 +63,7 @@ const collectImports = (ir) => {
             }
         }
     };
-    for (const api of ir.apis) {
+    for (const api of apis) {
         add(api.request);
         add(api.response);
     }
@@ -84,16 +85,18 @@ const apiComment = (api) => {
 export const createApiTypesGenerator = () => ({
     name: 'api-types',
     description: 'API request/response TypeScript types',
+    scope: 'api',
     generate(ir, context) {
-        if (ir.apis.length === 0) {
+        const apis = selectApis(ir.apis, context);
+        if (apis.length === 0) {
             return [];
         }
         const blocks = [...headerBlocks(context)];
-        const imports = collectImports(ir);
+        const imports = collectImports(ir, apis);
         if (imports.length > 0) {
             blocks.push(`import type { ${imports.join(', ')} } from './types'`);
         }
-        for (const api of ir.apis) {
+        for (const api of apis) {
             const pascal = pascalCase(api.name);
             blocks.push([
                 apiComment(api),

package/dist/lib/_internal/generators/api/api-validation-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-validation-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-validation-generator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAuE5E;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAO,SAa9C,CAAA"}
+{"version":3,"file":"api-validation-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/api-validation-generator.ts"],"names":[],"mappings":"AAIA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAuExF;;;GAGG;AACH,eAAO,MAAM,4BAA4B,QAAO,SAe9C,CAAA"}

package/dist/lib/_internal/generators/api/api-validation-generator.js

@@ -2,6 +2,7 @@ import { findModel } from '../../ir/ir.js';
 import { pascalCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
 import { zodConstraints } from '../support/constraints.js';
+import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
 const SCALAR_ZOD = {
     string: 'z.string()',
@@ -80,12 +81,14 @@ const renderRequestSchema = (ir, api) => {
 export const createApiValidationGenerator = () => ({
     name: 'api-validation',
     description: 'API request-validation Zod schemas',
+    scope: 'api',
     generate(ir, context) {
-        if (ir.apis.length === 0) {
+        const apis = selectApis(ir.apis, context);
+        if (apis.length === 0) {
             return [];
         }
         const blocks = [...headerBlocks(context), "import { z } from 'zod'"];
-        for (const api of ir.apis) {
+        for (const api of apis) {
             blocks.push(renderRequestSchema(ir, api));
         }
         return [{ path: 'api-validation.ts', content: `${blocks.join('\n\n')}\n` }];

package/dist/lib/_internal/generators/api/task-payload-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-payload-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/task-payload-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAoB,MAAM,iBAAiB,CAAA;AAyE5E;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAO,SAqB5C,CAAA"}
+{"version":3,"file":"task-payload-generator.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/api/task-payload-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,SAAS,EAAgC,MAAM,iBAAiB,CAAA;AAyExF;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,QAAO,SAsB5C,CAAA"}

package/dist/lib/_internal/generators/api/task-payload-generator.js

@@ -1,6 +1,7 @@
 import { findModel } from '../../ir/ir.js';
 import { constantCase, pascalCase, singleQuote } from '../support/naming.js';
 import { isRelation, relationFkName, relationFkType } from '../support/relations.js';
+import { selectApis } from '../generator.js';
 import { headerBlocks } from '../support/header.js';
 const SCALAR_TS = {
     string: 'string',
@@ -76,9 +77,10 @@ const collectImports = (ir, tasks) => {
  */
 export const createTaskPayloadGenerator = () => ({
     name: 'task-payloads',
+    scope: 'api',
     description: 'Cloud Task/Pub-Sub payload envelopes, data/payload types, and constants',
     generate(ir, context) {
-        const tasks = ir.apis.filter(isTask);
+        const tasks = selectApis(ir.apis, context).filter(isTask);
         if (ir.envelopes.length === 0 && tasks.length === 0) {
             return [];
         }

package/dist/lib/_internal/generators/generator.d.ts

@@ -7,6 +7,12 @@ export interface GeneratedFile {
 export interface GeneratorContext {
     /** Optional banner prepended to each generated file. */
     header?: string;
+    /**
+     * Api-scoped generation: restrict output to these api names. `undefined`
+     * keeps the legacy behavior (all apis in the IR). Set by the compiler when
+     * entries opt into a generator via section defaults / entry `generators:`.
+     */
+    apiNames?: string[];
 }
 /**
  * A code generator turns the IR into one or more output files. Implementations
@@ -18,6 +24,16 @@ export interface Generator {
     /** Unique key used to select the generator from the CLI/registry. */
     readonly name: string;
     readonly description?: string;
+    /**
+     * `api`: output follows per-entry applications (section defaults → entry).
+     * `document` (default): declaring the generator in a yml's `generators:`
+     * block runs it once for that yml.
+     */
+    readonly scope?: 'api' | 'document';
     generate(ir: Ir, context?: GeneratorContext): GeneratedFile[];
 }
+/** Narrow `ir.apis` to the compiler-selected subset (no-op without a filter). */
+export declare const selectApis: <T extends {
+    name: string;
+}>(apis: T[], context?: GeneratorContext) => T[];
 //# sourceMappingURL=generator.d.ts.map

package/dist/lib/_internal/generators/generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CAC9D"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/generators/generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAA;AAEhC,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,UAAU,CAAA;IACnC,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAAA;CAC9D;AAED,iFAAiF;AACjF,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,CAAC,EAAE,EAAE,UAAU,gBAAgB,KAAG,CAAC,EAI/F,CAAA"}

package/dist/lib/_internal/generators/generator.js

@@ -1 +1,7 @@
-export {};
+/** Narrow `ir.apis` to the compiler-selected subset (no-op without a filter). */
+export const selectApis = (apis, context) => {
+    if (!context?.apiNames)
+        return apis;
+    const allowed = new Set(context.apiNames);
+    return apis.filter(api => allowed.has(api.name));
+};

package/dist/lib/_internal/generators/support/naming.d.ts

@@ -3,6 +3,7 @@ export declare const pascalCase: (value: string) => string;
 export declare const camelCase: (value: string) => string;
 export declare const constantCase: (value: string) => string;
 export declare const snakeCase: (value: string) => string;
+export declare const kebabCase: (value: string) => string;
 /** Naive English pluralization sufficient for table naming. */
 export declare const pluralize: (value: string) => string;
 /** Escape a string for use inside a single-quoted TypeScript literal. */

package/dist/lib/_internal/generators/support/naming.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/naming.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAU1E,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAG9B,CAAA;AAEb,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAGzC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAG/B,CAAA;AAEd,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAG5B,CAAA;AAEd,+DAA+D;AAC/D,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAIzC,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAkE,CAAA"}
+{"version":3,"file":"naming.d.ts","sourceRoot":"","sources":["../../../../../src/lib/_internal/generators/support/naming.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAU1E,eAAO,MAAM,UAAU,GAAI,OAAO,MAAM,KAAG,MAG9B,CAAA;AAEb,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAGzC,CAAA;AAED,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,MAG/B,CAAA;AAEd,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAG5B,CAAA;AAEd,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAG5B,CAAA;AAEd,+DAA+D;AAC/D,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,KAAG,MAIzC,CAAA;AAED,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAkE,CAAA"}

package/dist/lib/_internal/generators/support/naming.js

@@ -18,6 +18,9 @@ export const constantCase = (value) => words(value)
 export const snakeCase = (value) => words(value)
     .map(word => word.toLowerCase())
     .join('_');
+export const kebabCase = (value) => words(value)
+    .map(word => word.toLowerCase())
+    .join('-');
 /** Naive English pluralization sufficient for table naming. */
 export const pluralize = (value) => {
     if (/[^aeiou]y$/.test(value))

package/dist/lib/_internal/ir/build-ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-ir.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/ir/build-ir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAS,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAGL,WAAW,EAIZ,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAGL,EAAE,EAgBH,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAoLD;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,WAAW,EAAE,KAAG,aAqQlD,CAAA"}
+{"version":3,"file":"build-ir.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/ir/build-ir.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAS,MAAM,mBAAmB,CAAA;AACrD,OAAO,EAGL,WAAW,EAIZ,MAAM,2BAA2B,CAAA;AAElC,OAAO,EAGL,EAAE,EAgBH,MAAM,SAAS,CAAA;AAEhB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,EAAE,CAAA;IACN,WAAW,EAAE,UAAU,EAAE,CAAA;CAC1B;AAqLD;;;;;;;;GAQG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,WAAW,EAAE,KAAG,aAqQlD,CAAA"}

package/dist/lib/_internal/ir/build-ir.js

@@ -139,6 +139,8 @@ const buildApi = (name, raw, sourceFile, enumNames, modelNames) => {
     };
     if (raw.method !== undefined)
         api.method = raw.method;
+    if (raw.path !== undefined)
+        api.path = raw.path;
     if (raw.description !== undefined)
         api.description = raw.description;
     if (raw.envelope !== undefined ||

package/dist/lib/_internal/ir/ir.d.ts

@@ -302,6 +302,8 @@ export interface IrApi {
     kind: ApiKind;
     /** HTTP method for `https` endpoints. */
     method?: string;
+    /** REST path when declared via the path-keyed `apis:` section. */
+    path?: string;
     request: IrApiPayload;
     response: IrApiPayload;
     /** Delivery config for `task`/`pubsub` kinds. */

package/dist/lib/_internal/ir/ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/ir/ir.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,YAAY,4FAA6F,CAAA;AAEtH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAEtD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,IAAI,IAAI,UACA,CAAA;AAEpD,qEAAqE;AACrE,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACjC,6EAA6E;GAC3E;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAExC,+EAA+E;AAC/E,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,qCAAqC;IACrC,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,SAAS,CAAA;IACf,WAAW,EAAE,aAAa,CAAA;IAC1B,0CAA0C;IAC1C,QAAQ,EAAE,OAAO,CAAA;IACjB,iFAAiF;IACjF,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uCAAuC;IACvC,IAAI,EAAE,OAAO,CAAA;IACb,iDAAiD;IACjD,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf;;;;;OAKG;IACH,QAAQ,EAAE,OAAO,CAAA;IACjB,uFAAuF;IACvF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACvE,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACjE;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,iFAAiF;IACjF,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,gFAAgF;IAChF,GAAG,CAAC,EAAE,gBAAgB,CAAA;IACtB,uFAAuF;IACvF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;IAC/B,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4EAA4E;IAC5E,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,2DAA2D;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,CAAA;AAChD,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AACtE,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEvD,wFAAwF;AACxF,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,qFAAqF;IACrF,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,+EAA+E;AAC/E,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,iGAAiG;IACjG,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,2FAA2F;IAC3F,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,yFAAyF;IACzF,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,mGAAmG;IACnG,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,kFAAkF;AAClF,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAA;IACnB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iGAAiG;IACjG,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,KAAK,GAAG,MAAM,CAAA;CACpB;AAED,wCAAwC;AACxC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAA;IACd,6BAA6B;IAC7B,GAAG,EAAE,MAAM,EAAE,CAAA;CACd;AAED,sFAAsF;AACtF,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACb;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,aAAa,CAAA;IAC5B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,2DAA2D;IAC3D,MAAM,CAAC,EAAE,cAAc,CAAA;IACvB,IAAI,EAAE,SAAS,CAAA;IACf,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,kEAAkE;IAClE,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,iCAAiC;IACjC,KAAK,EAAE,OAAO,EAAE,CAAA;IAChB,wDAAwD;IACxD,MAAM,EAAE,QAAQ,EAAE,CAAA;IAClB,mCAAmC;IACnC,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtE,uFAAuF;IACvF,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;IACrB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;IACrB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,sCAAsC;IACtC,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,kFAAkF;IAClF,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,0FAA0F;IAC1F,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACtC,wEAAwE;IACxE,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,uFAAuF;IACvF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,8EAA8E;IAC9E,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;QAC9B,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;QACzB,oGAAoG;QACpG,IAAI,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAA;QACrC,6DAA6D;QAC7D,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;QAC1B,4DAA4D;QAC5D,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;QAC3B,wDAAwD;QACxD,GAAG,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;QACxB,kFAAkF;QAClF,GAAG,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;QACxB,sEAAsE;QACtE,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAA;KAC3B,CAAA;IACD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE9D,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mDAAmD;IACnD,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,mDAAmD;IACnD,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,4EAA4E;AAC5E,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,OAAO,CAAA;IACb,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,YAAY,CAAA;IACrB,QAAQ,EAAE,YAAY,CAAA;IACtB,iDAAiD;IACjD,IAAI,CAAC,EAAE,YAAY,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,oEAAoE;IACpE,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,8BAA8B;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,sDAAsD;IACtD,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,+DAA+D;IAC/D,IAAI,EAAE,OAAO,CAAA;IACb,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,SAAS,EAAE,CAAA;IACrB,wEAAwE;IACxE,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAClD,2EAA2E;IAC3E,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACpD;AAED,MAAM,WAAW,EAAE;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,UAAU,EAAE,WAAW,EAAE,CAAA;IACzB,IAAI,EAAE,KAAK,EAAE,CAAA;IACb,SAAS,EAAE,cAAc,EAAE,CAAA;IAC3B,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,SAAS,EAAE,UAAU,EAAE,CAAA;IACvB,OAAO,CAAC,EAAE,SAAS,CAAA;IACnB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,SAAS,GAAI,IAAI,EAAE,EAAE,MAAM,MAAM,KAAG,OAAO,GAAG,SACb,CAAA;AAE9C,eAAO,MAAM,QAAQ,GAAI,IAAI,EAAE,EAAE,MAAM,MAAM,KAAG,MAAM,GAAG,SACV,CAAA;AAE/C,8FAA8F;AAC9F,eAAO,MAAM,QAAQ,GAAI,IAAI,EAAE,EAAE,WAAW,MAAM,KAAG,UAOpD,CAAA"}
+{"version":3,"file":"ir.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/ir/ir.ts"],"names":[],"mappings":"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"}

package/dist/lib/_internal/parser/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,WAAW,EAUZ,MAAM,mBAAmB,CAAA;AAyc1B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,WA+JjE,CAAA"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/parse.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,WAAW,EAaZ,MAAM,mBAAmB,CAAA;AA2hB1B;;;;;GAKG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,EAAE,UAAU,MAAM,KAAG,WA4MjE,CAAA"}

package/dist/lib/_internal/parser/parse.js

@@ -396,16 +396,87 @@ const normalizeApiPayload = (raw, filePath, path) => {
     }
     return payload;
 };
-const normalizeApi = (raw, filePath, name) => {
+const normalizeGeneratorUse = (raw, filePath, path) => {
+    if (typeof raw === 'string')
+        return { generator: raw };
+    if (!isObject(raw) || typeof raw.generator !== 'string') {
+        return fail(`"${path}" must be a generator name or { generator, out? }`, filePath, path);
+    }
+    const use = { generator: raw.generator };
+    if (raw.out !== undefined)
+        use.out = String(raw.out);
+    return use;
+};
+const normalizeGeneratorUses = (raw, filePath, path) => {
+    if (!Array.isArray(raw)) {
+        return fail(`"${path}" must be an array of generator applications`, filePath, path);
+    }
+    return raw.map((entry, i) => normalizeGeneratorUse(entry, filePath, `${path}[${i}]`));
+};
+/** Reserved key inside `apis:/tasks:/events:` holding section-level defaults. */
+const SECTION_DEFAULTS_KEY = 'defaults';
+const normalizeSectionDefaults = (raw, filePath, section) => {
     if (!isObject(raw)) {
-        return fail(`Api "${name}" must be an object`, filePath, `apis.${name}`);
+        return fail(`"${section}.${SECTION_DEFAULTS_KEY}" must be an object`, filePath, `${section}.${SECTION_DEFAULTS_KEY}`);
     }
-    if (typeof raw.kind !== 'string') {
-        return fail(`Api "${name}" is missing a string "kind" (callable|https|task|pubsub)`, filePath, `apis.${name}.kind`);
+    if (raw.generators === undefined)
+        return [];
+    return normalizeGeneratorUses(raw.generators, filePath, `${section}.${SECTION_DEFAULTS_KEY}.generators`);
+};
+/**
+ * Path-keyed api entry (`apis:` section, key starts with `/`): kind defaults to
+ * `https` (or `callable` when declared), `operationId` names the generated types.
+ */
+const normalizePathApi = (raw, filePath, pathKey) => {
+    if (!isObject(raw)) {
+        return fail(`Api "${pathKey}" must be an object`, filePath, `apis.${pathKey}`);
+    }
+    if (typeof raw.operationId !== 'string' || raw.operationId.length === 0) {
+        return fail(`Api "${pathKey}" is missing a string "operationId" (used as the generated name)`, filePath, `apis.${pathKey}.operationId`);
+    }
+    const kind = raw.kind === undefined ? 'https' : String(raw.kind);
+    if (kind !== 'https' && kind !== 'callable') {
+        return fail(`Api "${pathKey}" kind must be https|callable (tasks/events have their own sections)`, filePath, `apis.${pathKey}.kind`);
     }
-    const api = { kind: raw.kind };
+    const api = { kind, path: pathKey };
     if (raw.method !== undefined)
         api.method = String(raw.method);
+    if (raw.description !== undefined)
+        api.description = String(raw.description);
+    api.request = normalizeApiPayload(raw.request, filePath, `apis.${pathKey}.request`);
+    api.response = normalizeApiPayload(raw.response, filePath, `apis.${pathKey}.response`);
+    if (raw.generators !== undefined) {
+        api.generators = normalizeGeneratorUses(raw.generators, filePath, `apis.${pathKey}.generators`);
+    }
+    return { name: raw.operationId, api };
+};
+/** `tasks:` section entry — a Cloud Task api (kind is implied, key is the name). */
+const normalizeTask = (raw, filePath, name) => {
+    if (!isObject(raw)) {
+        return fail(`Task "${name}" must be an object`, filePath, `tasks.${name}`);
+    }
+    const api = { kind: 'task' };
+    if (raw.description !== undefined)
+        api.description = String(raw.description);
+    if (raw.envelope !== undefined)
+        api.envelope = String(raw.envelope);
+    if (raw.maxAttempts !== undefined)
+        api.maxAttempts = Number(raw.maxAttempts);
+    if (raw.timeoutSeconds !== undefined)
+        api.timeoutSeconds = Number(raw.timeoutSeconds);
+    api.request = normalizeApiPayload(raw.request, filePath, `tasks.${name}.request`);
+    api.response = normalizeApiPayload(raw.response, filePath, `tasks.${name}.response`);
+    if (raw.generators !== undefined) {
+        api.generators = normalizeGeneratorUses(raw.generators, filePath, `tasks.${name}.generators`);
+    }
+    return api;
+};
+/** `events:` section entry — a Pub/Sub api (kind is implied, key is the name). */
+const normalizeEvent = (raw, filePath, name) => {
+    if (!isObject(raw)) {
+        return fail(`Event "${name}" must be an object`, filePath, `events.${name}`);
+    }
+    const api = { kind: 'pubsub' };
     if (raw.description !== undefined)
         api.description = String(raw.description);
     if (raw.envelope !== undefined)
@@ -416,8 +487,11 @@ const normalizeApi = (raw, filePath, name) => {
         api.timeoutSeconds = Number(raw.timeoutSeconds);
     if (raw.topic !== undefined)
         api.topic = String(raw.topic);
-    api.request = normalizeApiPayload(raw.request, filePath, `apis.${name}.request`);
-    api.response = normalizeApiPayload(raw.response, filePath, `apis.${name}.response`);
+    api.request = normalizeApiPayload(raw.request, filePath, `events.${name}.request`);
+    api.response = normalizeApiPayload(raw.response, filePath, `events.${name}.response`);
+    if (raw.generators !== undefined) {
+        api.generators = normalizeGeneratorUses(raw.generators, filePath, `events.${name}.generators`);
+    }
     return api;
 };
 const normalizeEnvelope = (raw, filePath, name) => {
@@ -523,6 +597,16 @@ const normalizeProject = (raw, filePath) => {
             idCodec.alphabet = String(raw.idCodec.alphabet);
         project.idCodec = idCodec;
     }
+    if (raw.aliases !== undefined) {
+        if (!isObject(raw.aliases)) {
+            return fail('"project.aliases" must be a mapping of alias → path', filePath, 'project.aliases');
+        }
+        const aliases = {};
+        for (const [alias, target] of Object.entries(raw.aliases)) {
+            aliases[alias] = String(target);
+        }
+        project.aliases = aliases;
+    }
     return project;
 };
 /**
@@ -612,12 +696,55 @@ export const parseContract = (content, filePath) => {
         }
     }
     const apis = {};
+    const sectionDefaults = {};
+    const addApi = (name, api, section) => {
+        if (apis[name] !== undefined) {
+            fail(`Api "${name}" is declared more than once across apis/tasks/events`, filePath, `${section}.${name}`);
+        }
+        apis[name] = api;
+    };
     if (doc.apis !== undefined) {
         if (!isObject(doc.apis)) {
             return fail('"apis" must be a mapping', filePath, 'apis');
         }
-        for (const [name, raw] of Object.entries(doc.apis)) {
-            apis[name] = normalizeApi(raw, filePath, name);
+        for (const [key, raw] of Object.entries(doc.apis)) {
+            if (key === SECTION_DEFAULTS_KEY) {
+                sectionDefaults.apis = normalizeSectionDefaults(raw, filePath, 'apis');
+            }
+            else if (key.startsWith('/')) {
+                // Path-keyed REST form: the key is the route, `operationId` names the api.
+                const { name, api } = normalizePathApi(raw, filePath, key);
+                addApi(name, api, 'apis');
+            }
+            else {
+                fail(`"apis" keys must be REST paths starting with "/" (tasks/events have their own sections): "${key}"`, filePath, `apis.${key}`);
+            }
+        }
+    }
+    if (doc.tasks !== undefined) {
+        if (!isObject(doc.tasks)) {
+            return fail('"tasks" must be a mapping', filePath, 'tasks');
+        }
+        for (const [name, raw] of Object.entries(doc.tasks)) {
+            if (name === SECTION_DEFAULTS_KEY) {
+                sectionDefaults.tasks = normalizeSectionDefaults(raw, filePath, 'tasks');
+            }
+            else {
+                addApi(name, normalizeTask(raw, filePath, name), 'tasks');
+            }
+        }
+    }
+    if (doc.events !== undefined) {
+        if (!isObject(doc.events)) {
+            return fail('"events" must be a mapping', filePath, 'events');
+        }
+        for (const [name, raw] of Object.entries(doc.events)) {
+            if (name === SECTION_DEFAULTS_KEY) {
+                sectionDefaults.events = normalizeSectionDefaults(raw, filePath, 'events');
+            }
+            else {
+                addApi(name, normalizeEvent(raw, filePath, name), 'events');
+            }
         }
     }
     const firestore = {};
@@ -667,16 +794,22 @@ export const parseContract = (content, filePath) => {
     if (typeof doc.header === 'string') {
         contract.header = doc.header;
     }
-    if (doc.generate !== undefined) {
-        if (!Array.isArray(doc.generate)) {
-            return fail('"generate" must be an array of { out, generators } entries', filePath, 'generate');
+    if (doc.generators !== undefined) {
+        if (!Array.isArray(doc.generators)) {
+            return fail('"generators" must be an array of { generator, out } declarations', filePath, 'generators');
         }
-        contract.outputs = doc.generate.map((entry, i) => {
-            if (!isObject(entry) || typeof entry.out !== 'string') {
-                return fail(`generate[${i}] needs a string "out"`, filePath, `generate[${i}]`);
+        contract.generatorDecls = doc.generators.map((entry, i) => {
+            if (!isObject(entry) || typeof entry.generator !== 'string') {
+                return fail(`generators[${i}] needs a string "generator"`, filePath, `generators[${i}]`);
+            }
+            if (typeof entry.out !== 'string') {
+                return fail(`generators[${i}] needs a string "out"`, filePath, `generators[${i}].out`);
             }
-            return { out: entry.out, generators: asStringArray(entry.generators, filePath, `generate[${i}].generators`) };
+            return { generator: entry.generator, out: entry.out };
         });
     }
+    if (Object.keys(sectionDefaults).length > 0) {
+        contract.sectionDefaults = sectionDefaults;
+    }
     return contract;
 };

package/dist/lib/_internal/parser/raw-document.d.ts

@@ -157,12 +157,37 @@ export interface RawApi {
     description?: string;
     kind: string;
     method?: string;
+    /** REST path when declared under the path-keyed `apis:` section (e.g. `/ai-models/{model-id}`). */
+    path?: string;
     request?: RawApiPayload;
     response?: RawApiPayload;
     envelope?: string;
     maxAttempts?: number;
     timeoutSeconds?: number;
     topic?: string;
+    /** Entry-level generator applications (overrides the section defaults). */
+    generators?: RawGeneratorUse[];
+}
+/** Top-level generator declaration: registry id + default output template. */
+export interface RawGeneratorDecl {
+    generator: string;
+    /**
+     * Output template relative to the declaring yml. Supports `{api-name}` /
+     * `{path}` placeholders (api-scoped generators) and `#alias/...` prefixes
+     * resolved through the root document's `project.aliases`.
+     */
+    out: string;
+}
+/** Generator application on a section default or an entry (name ref + optional out override). */
+export interface RawGeneratorUse {
+    generator: string;
+    out?: string;
+}
+/** Per-section generator defaults (`apis:/tasks:/events:` → `defaults.generators`). */
+export interface RawSectionDefaults {
+    apis?: RawGeneratorUse[];
+    tasks?: RawGeneratorUse[];
+    events?: RawGeneratorUse[];
 }
 export interface RawEnvelope {
     description?: string;
@@ -200,17 +225,19 @@ export interface RawProject {
         minLength?: number;
         alphabet?: string;
     };
-}
-/** A declared generation target: run `generators` into `out` (relative to the yml). */
-export interface RawOutputTarget {
-    out: string;
-    generators: string[];
+    /**
+     * Output path aliases resolved against the root yml's directory, e.g.
+     * `"#contracts/*": "libs/contracts/src/*"`. Used by `generators[].out`.
+     */
+    aliases?: Record<string, string>;
 }
 export interface RawContract {
     /** Absolute path of the source file. */
     filePath: string;
-    /** Generation targets declared in this file's `generate:` section. */
-    outputs?: RawOutputTarget[];
+    /** Generator declarations from this file's top-level `generators:` block. */
+    generatorDecls?: RawGeneratorDecl[];
+    /** Section-level generator defaults (`apis:/tasks:/events:` → `defaults`). */
+    sectionDefaults?: RawSectionDefaults;
     version: number;
     /** Raw header text prepended to generated files (`default` = built-in banner). */
     header?: string;

package/dist/lib/_internal/parser/raw-document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw-document.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/raw-document.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,wEAAwE;IACxE,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,EAAE,CAAC,EAAE,OAAO,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iFAAiF;IACjF,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACxE,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;CACnE;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAA;IACpB,GAAG,CAAC,EAAE,iBAAiB,CAAA;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IACvK,8DAA8D;IAC9D,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,CAAA;IACjI,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACrG,OAAO,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1C,KAAK,CAAC,EAAE,MAAM,GAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACtE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,SAAS,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAC/C,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACzC,GAAG,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IACvC,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1I;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,MAAM;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,oEAAoE;IACpE,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,2EAA2E;IAC3E,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACpD;AAED,uFAAuF;AACvF,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAA;IAChB,sEAAsE;IACtE,OAAO,CAAC,EAAE,eAAe,EAAE,CAAA;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,6EAA6E;IAC7E,iBAAiB,EAAE,MAAM,EAAE,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IACxC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAA;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAChC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CACvC"}
+{"version":3,"file":"raw-document.d.ts","sourceRoot":"","sources":["../../../../src/lib/_internal/parser/raw-document.ts"],"names":[],"mappings":"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"}

package/dist/lib/cli/commands/generate.js

@@ -32,7 +32,7 @@ export const registerGenerate = (program) => {
         const header = flags.header === true ? DEFAULT_HEADER : typeof flags.header === 'string' ? toHeaderComment(flags.header) : undefined;
         const registry = createDefaultRegistry();
         const context = header !== undefined ? { header } : undefined;
-        // Without -o/-g, run every `generate:` target declared in the contract
+        // Without -o/-g, run every generator declared in the contract
         // graph — the one-command flow. Flags switch back to single-target mode.
         const explicit = flags.outDir !== undefined || flags.generators !== undefined || config.outDir !== undefined || config.generators !== undefined;
         if (!explicit) {

package/dist/lib/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAgEnC,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,IAgB/C,CAAA"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/lib/cli/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAqEnC,eAAO,MAAM,YAAY,GAAI,SAAS,OAAO,KAAG,IAgB/C,CAAA"}

package/dist/lib/cli/commands/init.js

@@ -3,6 +3,11 @@ import { resolve } from 'node:path';
 import { CONFIG_FILENAME } from '../config.js';
 const EXAMPLE_CONTRACT = `version: 1
 
+# Declare generators once (name + output template); entries opt in below.
+generators:
+  - { generator: typescript, out: generated }
+  - { generator: zod, out: generated }
+
 enums:
   ProductStatus:
     description: Lifecycle state of a product

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firebase-contract",
-  "version": "0.1.0-rc.5",
+  "version": "0.1.0-rc.6",
   "type": "module",
   "bin": {
     "firebase-contract": "./dist/lib/cli/index.js",