@deterministic-code/datasources-cli 0.0.0-stage → 0.1.3

package/node_modules/@deterministic-code/generators-openapi/src/samples/01-simple/datasource.yaml

@@ -0,0 +1,5 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "datasource_type"
+types: []

package/node_modules/@deterministic-code/generators-openapi/src/samples/01-simple/routes.yaml

@@ -0,0 +1,5 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "view_type"
+routes: []

package/node_modules/@deterministic-code/generators-openapi/src/samples/01-simple/types.yaml

@@ -0,0 +1,8 @@
+version: 1.0.0
+types:
+  - user:
+      tags: [datasource_type, view_type]
+      inherits: set
+      fields:
+        - email:
+            type: string

package/node_modules/@deterministic-code/generators-openapi/src/samples/02-moderate/datasource.yaml

@@ -0,0 +1,13 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "datasource_type"
+types:
+  - role:
+      fields:
+        - name:
+            is_unique: true
+  - user:
+      fields:
+        - email:
+            is_unique: true

package/node_modules/@deterministic-code/generators-openapi/src/samples/02-moderate/routes.yaml

@@ -0,0 +1,14 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "view_type"
+routes:
+  - users_by_email:
+  - ping:
+      method: POST
+      path: /api/ping
+      request: missing_shape
+      response: missing_shape
+  - clone_user:
+      method: POST
+      path: /api/users/:id/clone/:id

package/node_modules/@deterministic-code/generators-openapi/src/samples/02-moderate/types.yaml

@@ -0,0 +1,21 @@
+version: 1.0.0
+types:
+  - role:
+      tags: [datasource_type, view_type, readonly_lookup]
+      inherits: set
+      fields:
+        - name:
+            type: string
+  - user:
+      tags: [datasource_type, view_type]
+      inherits: set
+      fields:
+        - email:
+            type: string
+            size: 256
+        - role_id:
+            type: number
+            references: role.id
+        - nick_name:
+            type: string
+            is_nullable: true

package/node_modules/@deterministic-code/generators-openapi/src/samples/03-complex/datasource.yaml

@@ -0,0 +1,13 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "datasource_type"
+types:
+  - status:
+      fields:
+        - name:
+            is_unique: true
+  - project:
+      fields:
+        - name:
+            is_unique: true

package/node_modules/@deterministic-code/generators-openapi/src/samples/03-complex/routes.yaml

@@ -0,0 +1,15 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "view_type"
+routes:
+  - get_projects_by_name:
+  - project:
+      eager_read_path:
+        - tasks
+      eager_update_path:
+        - tasks
+combined_routes:
+  - project:
+      combines:
+        - task

package/node_modules/@deterministic-code/generators-openapi/src/samples/03-complex/types.yaml

@@ -0,0 +1,35 @@
+version: 1.0.0
+types:
+  - status:
+      tags: [datasource_type, view_type, readonly_lookup]
+      inherits: set
+      fields:
+        - name:
+            type: string
+  - project:
+      tags: [datasource_type, view_type]
+      inherits: set
+      fields:
+        - name:
+            type: string
+        - tasks:
+            type: task[]
+            references: task.project_id
+  - task:
+      tags: [datasource_type, view_type]
+      inherits: set
+      fields:
+        - title:
+            type: string
+        - project_id:
+            type: number
+            references: project.id
+        - status_id:
+            type: number
+            references: status.id
+  - project_eager_body:
+      inherits: project
+  - project_eager_create_body:
+      inherits: project
+  - project_eager_patch_body:
+      inherits: project

package/node_modules/@deterministic-code/generators-openapi/src/samples/04-complex-optimistic-concurrency/datasource.yaml

@@ -0,0 +1,16 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "datasource_type"
+types:
+  - status:
+      fields:
+        - name:
+            is_unique: true
+  - project:
+      use_optimistic_concurrency: true
+      fields:
+        - name:
+            is_unique: true
+  - task:
+      use_optimistic_concurrency: true

package/node_modules/@deterministic-code/generators-openapi/src/samples/04-complex-optimistic-concurrency/routes.yaml

@@ -0,0 +1,15 @@
+version: 1.0.0
+includes:
+  - types:
+      filter: tag == "view_type"
+routes:
+  - get_projects_by_name:
+  - project:
+      eager_read_path:
+        - tasks
+      eager_update_path:
+        - tasks
+combined_routes:
+  - project:
+      combines:
+        - task

package/node_modules/@deterministic-code/generators-openapi/src/samples/04-complex-optimistic-concurrency/types.yaml

@@ -0,0 +1,35 @@
+version: 1.0.0
+types:
+  - status:
+      tags: [datasource_type, view_type, readonly_lookup]
+      inherits: set
+      fields:
+        - name:
+            type: string
+  - project:
+      tags: [datasource_type, view_type]
+      inherits: set
+      fields:
+        - name:
+            type: string
+        - tasks:
+            type: task[]
+            references: task.project_id
+  - task:
+      tags: [datasource_type, view_type]
+      inherits: set
+      fields:
+        - title:
+            type: string
+        - project_id:
+            type: number
+            references: project.id
+        - status_id:
+            type: number
+            references: status.id
+  - project_eager_body:
+      inherits: project
+  - project_eager_create_body:
+      inherits: project
+  - project_eager_patch_body:
+      inherits: project

package/node_modules/@deterministic-code/generators-openapi/src/templates/create-openapi/openapi.json.tmpl

@@ -0,0 +1,32 @@
+{
+  "openapi": "3.0.3",
+  "info": {
+    "title": {{titleJson}},
+    "version": {{versionJson}}
+  },
+{{#hasDocTags}}
+  "tags": [
+{{#docTags}}
+    {
+      "name": {{nameJson}}
+    }{{^last}},{{/last}}
+{{/docTags}}
+  ],
+{{/hasDocTags}}
+  "paths": {
+{{#paths}}
+    {{pathJson}}: {
+{{#operations}}
+      {{methodJson}}: {{&operationJson}}{{^last}},{{/last}}
+{{/operations}}
+    }{{^last}},{{/last}}
+{{/paths}}
+  },
+  "components": {
+    "schemas": {
+{{#schemas}}
+      {{nameJson}}: {{&schemaJson}}{{^last}},{{/last}}
+{{/schemas}}
+    }
+  }
+}

package/node_modules/@deterministic-code/generators-openapi/src/templates/create-openapi/openapi.rs.tmpl

@@ -0,0 +1,17 @@
+use axum::http::header::CONTENT_TYPE;
+use axum::response::{IntoResponse, Response};
+use axum::routing::get;
+
+const OPENAPI_JSON: &str = "{{&specJson}}";
+
+pub fn router() -> axum::Router {
+    axum::Router::new().route("/openapi.json", get(serve_openapi))
+}
+
+async fn serve_openapi() -> Response {
+    (
+        [(CONTENT_TYPE, "application/json")],
+        OPENAPI_JSON.to_string(),
+    )
+        .into_response()
+}

package/node_modules/@deterministic-code/generators-openapi/src/templates/create-openapi/openapi_conformance.rs.tmpl

@@ -0,0 +1,56 @@
+use {{crateModule}}::routes::openapi;
+use reqwest::StatusCode;
+use serde_json::Value;
+use tokio::net::TcpListener;
+
+async fn serve_openapi() -> String {
+    let router = openapi::router();
+    let listener = TcpListener::bind("127.0.0.1:0").await.expect("bind");
+    let addr = listener.local_addr().expect("addr");
+    tokio::spawn(async move {
+        let _ = axum::serve(listener, router).await;
+    });
+    format!("http://{}", addr)
+}
+
+#[tokio::test]
+async fn openapi_endpoint_returns_valid_spec_document() {
+    let base = serve_openapi().await;
+    let resp = reqwest::get(format!("{}/openapi.json", base))
+        .await
+        .expect("GET /openapi.json");
+    assert_eq!(resp.status(), StatusCode::OK);
+    assert_eq!(
+        resp.headers()
+            .get("content-type")
+            .and_then(|v| v.to_str().ok())
+            .map(|v| v.to_string()),
+        Some("application/json".to_string())
+    );
+    let body: Value = resp.json().await.expect("json");
+    assert_eq!(body.get("openapi").and_then(|v| v.as_str()), Some("3.0.3"));
+    assert!(body.get("info").is_some(), "info missing");
+    assert!(body.get("paths").is_some(), "paths missing");
+}
+
+#[tokio::test]
+async fn openapi_paths_cover_every_generated_entity() {
+    let base = serve_openapi().await;
+    let body: Value = reqwest::get(format!("{}/openapi.json", base))
+        .await
+        .expect("GET")
+        .json()
+        .await
+        .expect("json");
+    let paths = body.get("paths").and_then(|v| v.as_object()).expect("paths");
+    let expected: &[&str] = &[
+{{&expectedPaths}}
+    ];
+    for path in expected {
+        assert!(
+            paths.contains_key(*path),
+            "openapi.paths missing entry for {}",
+            path
+        );
+    }
+}

package/node_modules/@deterministic-code/generators-openapi/src/templates/create-openapi/operation.json.tmpl

@@ -0,0 +1,55 @@
+{
+  "summary": {{summaryJson}},
+  "operationId": {{operationIdJson}}{{#hasOperationTags}},
+  "tags": [
+{{#operationTags}}
+    {{nameJson}}{{^last}},{{/last}}
+{{/operationTags}}
+  ]{{/hasOperationTags}}{{#hasParameters}},
+  "parameters": [
+{{#parameters}}
+    {
+      "name": {{nameJson}},
+      "in": "path",
+      "required": true,
+      "schema": {
+        "type": "string"
+      }
+    }{{^last}},{{/last}}
+{{/parameters}}{{#hasIfMatch}}{{#hasPathParameters}},{{/hasPathParameters}}
+    {
+      "name": "If-Match",
+      "in": "header",
+      "required": true,
+      "description": "The resource `updated` timestamp from the last GET.",
+      "schema": {
+        "type": "string",
+        "format": "date-time"
+      }
+    }{{/hasIfMatch}}
+  ]{{/hasParameters}}{{#hasRequestBody}},
+  "requestBody": {
+    "required": true,
+    "content": {
+      "application/json": {
+        "schema": {{&requestSchemaJson}}
+      }
+    }
+  }{{/hasRequestBody}},
+  "responses": {
+    "200": {
+      "description": "OK"{{#hasResponseBody}},
+      "content": {
+        "application/json": {
+          "schema": {{&responseSchemaJson}}
+        }
+      }{{/hasResponseBody}}
+    }{{#hasIfMatch}},
+    "412": {
+      "description": "Precondition Failed — If-Match does not match the current `updated` timestamp"
+    },
+    "428": {
+      "description": "Precondition Required — If-Match header is required"
+    }{{/hasIfMatch}}
+  }
+}

package/node_modules/@deterministic-code/generators-openapi/tsconfig.build.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "module": "nodenext", "moduleResolution": "nodenext", "target": "ES2022",
+    "lib": ["ES2022"], "types": ["node"], "declaration": true, "outDir": "dist",
+    "rootDir": "src", "allowImportingTsExtensions": true, "rewriteRelativeImportExtensions": true,
+    "resolveJsonModule": true, "skipLibCheck": true, "strict": true, "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "dist", "src/templates/**", "src/**/__tests__/**", "src/**/*.test.ts", "src/**/*.test.mjs"]
+}

package/node_modules/@deterministic-code/patch-merger/README.md

@@ -0,0 +1,170 @@
+# @deterministic-code/patch-merger
+
+A standalone patch-merge engine for code generators. Emitters hand it **dumb patches** — `{ target, content, options }` — and a **writer** matched by glob composes the final file. `apply` sends that file through an **apply strategy** (filesystem by default; you can plug in a database or anything else).
+
+## Why
+
+A codegen run has many emitters contributing to the same shared files. Rather than have each emitter read-modify-write those files, every emitter emits **patches**, and an end-of-run `apply` composes each target.
+
+## Usage
+
+```ts
+import {
+  PatchMerger,
+  Patch,
+  LineUpsertWriter,
+  defaultWriters,
+} from "@deterministic-code/patch-merger";
+
+const merger = new PatchMerger();
+
+merger.add(
+  new Patch({
+    target: ".env",
+    content: "PORT=3000\n",
+  }),
+);
+merger.add(
+  new Patch({
+    target: "app.ts",
+    content: "import { x } from './x';\n",
+    options: {
+      sections: ["Section1", "SubSection1"],
+      appendIfNotExists: "End",
+    },
+  }),
+);
+merger.add(
+  new Patch({
+    target: "package.json",
+    content: '{"express": "^4"}',
+    options: { jsonTarget: "/dependencies" },
+  }),
+);
+
+const written = await merger.apply(rootDir);
+```
+
+`registerWriter(glob, writer)` binds a composer to a glob (`**/.env`, `**/*.csproj`). Later bindings win when more than one glob matches. `add` throws if `target` matches no writer. `apply(rootDir, strategy?)` composes each target and hands it to the strategy. It returns the written target paths. A composer that returns `null` is skipped.
+
+Override or extend the default glob table in the constructor:
+
+```ts
+new PatchMerger({
+  writers: [...defaultWriters, ["**/*.txt", LineUpsertWriter]],
+});
+```
+
+Pass a custom `IPatchApplyStrategy` to write somewhere other than disk (`apply(rootDir, strategy)` or `applyStrategy` in the constructor). The default is `IPatchFileSystemApplyStrategy` (mkdir + writeFile).
+
+### Constructor options
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `failOnCollision` | `true` | Two patches that write different values to the same line, section path, or document key throw. Identical values are allowed. Set `false` so the later patch wins. |
+| `parallelWriteMode` | `true` | Write composed files concurrently. Set `false` to write targets one at a time. |
+| `writers` | `defaultWriters` | Glob → writer table. Replaces the defaults; spread `defaultWriters` to extend. |
+| `applyStrategy` | `IPatchFileSystemApplyStrategy` | Where composed files go. |
+
+## Patch format
+
+```ts
+new Patch({
+  target,   // path relative to apply(rootDir)
+  content,  // non-empty string
+  options,  // optional PatchOptions
+});
+```
+
+## Default globs
+
+Last matching glob wins, so the ignore/env patterns at the bottom beat `**/*.json` for names like `.env.json`.
+
+### LineUpsertWriter
+
+Line-oriented files. `KEY=value` upserts by key; any other line upserts by the full line.
+
+| Glob | Typical files |
+| --- | --- |
+| `**/.env` | `.env` |
+| `**/.env.*` | `.env.example`, `.env.local`, `.env.production` |
+| `**/.gitignore` | `.gitignore` |
+| `**/.dockerignore` | `.dockerignore` |
+| `**/.containerignore` | `.containerignore` |
+| `**/.ignore` | `.ignore` |
+| `**/.npmignore` | `.npmignore` |
+| `**/.eslintignore` | `.eslintignore` |
+| `**/.prettierignore` | `.prettierignore` |
+| `**/.stylelintignore` | `.stylelintignore` |
+| `**/.markdownlintignore` | `.markdownlintignore` |
+| `**/.helmignore` | `.helmignore` |
+| `**/.gcloudignore` | `.gcloudignore` |
+| `**/.fdignore` | `.fdignore` |
+| `**/.rgignore` | `.rgignore` |
+| `**/.cursorignore` | `.cursorignore` |
+| `**/.claudeignore` | `.claudeignore` |
+| `**/.slugignore` | `.slugignore` |
+| `**/.tfignore` | `.tfignore` |
+| `**/.cvsignore` | `.cvsignore` |
+| `**/.bzrignore` | `.bzrignore` |
+| `**/.hgignore` | `.hgignore` |
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `failIfExists` | `false` | When `true`, throw if that key or line is already present. |
+
+### DeepJsonWriter / DeepYamlWriter / DeepXmlWriter
+
+Deep-merges document objects. `jsonTarget` is a `/`-separated path (`""` or omitted is the root). Objects merge recursively; arrays concatenate unique items (stable order); primitives replace. XML attributes are keys prefixed with `@_`.
+
+| Glob | Writer | Typical files |
+| --- | --- | --- |
+| `**/*.json` | DeepJsonWriter | `package.json`, `tsconfig.json`, `appsettings.json` |
+| `**/*.jsonc` | DeepJsonWriter | `tsconfig.jsonc`, VS Code config |
+| `**/*.json5` | DeepJsonWriter | `package.json5` |
+| `**/*.yml` | DeepYamlWriter | `docker-compose.yml`, `.github/workflows/ci.yml` |
+| `**/*.yaml` | DeepYamlWriter | `openapi.yaml` |
+| `**/*.xml` | DeepXmlWriter | `app.config.xml`, `pom.xml` |
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `jsonTarget` | `""` | Path such as `/dependencies` or `/root/item`. Empty means the document root. |
+| `failIfExists` | `false` | When `true`, throw if a leaf key already exists. New keys are still merged. |
+
+### SectionWriter
+
+Fills marked regions. Nested paths walk from the outermost name inward. ASCII `-` and `=== BEGIN` / `=== END` markers are recognized when reading; new markers use an em dash (`# — START Name`). Comment syntax follows the target: `//`, `#`, `<!-- … -->`, or `/* … */`.
+
+A patch with **no** `sections` is the seed document for that target (the backend-app scaffold). Later patches fill named holes inside it.
+
+| Glob | Typical files |
+| --- | --- |
+| `**/*.{ts,tsx,mts,cts,js,jsx,mjs,cjs}` | `app.ts`, `index.js` |
+| `**/*.{cs,csx,fs,fsx,vb}` | `Program.cs`, `Lib.fs` |
+| `**/*.rs` | `main.rs`, `lib.rs` |
+| `**/*.{go,java,kt,kts,scala,groovy,gradle}` | `main.go`, `App.java` |
+| `**/*.{c,cc,cpp,cxx,h,hh,hpp,hxx,m,mm}` | `main.c`, `app.cpp` |
+| `**/*.{swift,php}` | `App.swift`, `index.php` |
+| `**/*.{py,rb,pl,pm,r,jl}` | `app.py`, `Gemfile`-adjacent `.rb` |
+| `**/*.{sh,bash,zsh,ksh,fish}` | `entrypoint.sh` |
+| `**/*.toml` | `Cargo.toml` |
+| `**/*.{csproj,fsproj,vbproj,props,targets,nuspec}` | `GeneratedApp.csproj` |
+| `**/*.{html,htm,vue,svelte,astro}` | `index.html`, `App.vue` |
+| `**/*.{css,scss,sass,less}` | `app.css` |
+| `**/*.{sql,graphql,gql}` | `schema.sql` |
+| `**/*.{cmake,mk,md}` | `README.md` |
+| `**/{Dockerfile,Dockerfile.*,Makefile,makefile,GNUmakefile,Justfile,justfile,CMakeLists.txt}` | `Dockerfile`, `Makefile` |
+
+| Option | Default | Meaning |
+| --- | --- | --- |
+| `sections` | *(omit to seed)* | Non-empty `["Section1", "SubSection1", …]`. Omit (or omit `options`) to set the whole file. An empty array throws. |
+| `appendIfNotExists` | `"End"` | `"None"` throws if the section is missing. `"End"` appends at the end of the parent (or file). `"Start"` inserts at the start of the parent (or file). |
+| `failIfExists` | `false` | When `true`, throw if that section path (or seed) already exists. |
+
+Custom composers are `(patches, { failOnCollision }) => string | null`.
+
+## Build
+
+`npm run build` writes ESM, CJS, and `.d.ts` to `typescript/dist`. Package `exports` (`types`, `import`, `require`) all point at that folder.
+
+`npm test` runs Vitest. `npm run typecheck` runs `tsc --noEmit`.

package/node_modules/@deterministic-code/patch-merger/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@deterministic-code/patch-merger",
+  "version": "0.1.0",
+  "description": "Standalone patch-merge engine: LineUpsert, Section, DeepJson, DeepYaml, and DeepXml writers compose codegen target files from dumb { target, content, options } patches.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deterministic-code/patch-merger.git"
+  },
+  "main": "./typescript/dist/index.cjs",
+  "module": "./typescript/dist/index.js",
+  "types": "./typescript/dist/index.d.js",
+  "exports": {
+    ".": {
+      "types": "./typescript/dist/index.d.js",
+      "import": "./typescript/dist/index.js",
+      "require": "./typescript/dist/index.cjs"
+    },
+    "./patch-merger": {
+      "types": "./typescript/dist/patch-merger.d.js",
+      "import": "./typescript/dist/patch-merger.js",
+      "require": "./typescript/dist/patch-merger.cjs"
+    }
+  },
+  "files": [
+    "typescript/dist"
+  ],
+  "dependencies": {
+    "fast-xml-parser": "^5.2.5",
+    "yaml": "^2.8.1"
+  }
+}

package/node_modules/@deterministic-code/patch-merger/typescript/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./patch-merger-CvVbM8X5.cjs");exports.DeepJsonWriter=e.deepJsonWriter;exports.DeepXmlWriter=e.deepXmlWriter;exports.DeepYamlWriter=e.deepYamlWriter;exports.IPatchFileSystemApplyStrategy=e.IPatchFileSystemApplyStrategy;exports.LineUpsertWriter=e.lineUpsertWriter;exports.Patch=e.Patch;exports.PatchMerger=e.PatchMerger;exports.SectionWriter=e.sectionWriter;exports.deepJsonWriter=e.deepJsonWriter;exports.deepXmlWriter=e.deepXmlWriter;exports.deepYamlWriter=e.deepYamlWriter;exports.defaultWriters=e.defaultWriters;exports.lineUpsertWriter=e.lineUpsertWriter;exports.sectionWriter=e.sectionWriter;
+//# sourceMappingURL=index.cjs.map

package/node_modules/@deterministic-code/patch-merger/typescript/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/node_modules/@deterministic-code/patch-merger/typescript/dist/index.d.ts

@@ -0,0 +1,75 @@
+export declare type AppendIfNotExists = "None" | "End" | "Start";
+
+export declare type ComposeContext = {
+    failOnCollision: boolean;
+};
+
+declare const deepJsonWriter: Writer;
+export { deepJsonWriter as DeepJsonWriter }
+export { deepJsonWriter }
+
+declare const deepXmlWriter: Writer;
+export { deepXmlWriter as DeepXmlWriter }
+export { deepXmlWriter }
+
+declare const deepYamlWriter: Writer;
+export { deepYamlWriter as DeepYamlWriter }
+export { deepYamlWriter }
+
+export declare const defaultWriters: WriterBinding[];
+
+export declare type IPatchApplyStrategy = {
+    apply(target: string, contents: string, rootDir: string): Promise<void>;
+};
+
+export declare class IPatchFileSystemApplyStrategy implements IPatchApplyStrategy {
+    #private;
+    apply(target: string, contents: string, rootDir: string): Promise<void>;
+}
+
+declare const lineUpsertWriter: Writer;
+export { lineUpsertWriter as LineUpsertWriter }
+export { lineUpsertWriter }
+
+export declare class Patch {
+    readonly target: string;
+    readonly content: string;
+    readonly options?: Readonly<PatchOptions>;
+    constructor({ target, content, options, }: {
+        target: string;
+        content: string;
+        options?: PatchOptions;
+    });
+}
+
+export declare class PatchMerger {
+    #private;
+    constructor({ failOnCollision, parallelWriteMode, writers, applyStrategy, }?: PatchMergerOptions);
+    registerWriter(glob: string, writer: Writer): void;
+    add(patch: Patch): void;
+    apply(rootDir: string, strategy?: IPatchApplyStrategy): Promise<string[]>;
+}
+
+export declare type PatchMergerOptions = {
+    failOnCollision?: boolean;
+    parallelWriteMode?: boolean;
+    writers?: Iterable<WriterBinding>;
+    applyStrategy?: IPatchApplyStrategy;
+};
+
+export declare type PatchOptions = {
+    failIfExists?: boolean;
+    jsonTarget?: string;
+    sections?: string[];
+    appendIfNotExists?: "None" | "End" | "Start";
+};
+
+declare const sectionWriter: Writer;
+export { sectionWriter as SectionWriter }
+export { sectionWriter }
+
+export declare type Writer = (patches: Patch[], ctx: ComposeContext) => string | null;
+
+export declare type WriterBinding = readonly [glob: string, writer: Writer];
+
+export { }